12 KiB
12 KiB
SPHLite TODO
当前目标版本:0.5.0
本文档依据 docs/v5.0_development_plan.md 拆分。0.5.0 定位为 Solid 版本线的起步版本,目标是在 0.4.1 已完成 Water、Gas、Explosive 稳定闭环的基础上,建立 3D 实体结构 SPH 粒子的输入、状态、本构、失效、显式推进、restart、接口和测试 gate。
所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.5.0 不实现 Shell、真实水-气-结构工程爆炸响应、真实 FEM-SPH 耦合、复杂断裂面追踪、碎片云、焊缝失效库、大规模并行或 GPU 后端。
执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端。
阶段 A:版本基线、范围声明与输入样例
- 确认当前 git 状态并记录 0.5.0 开发起点。
- 确认
v0.4.1标签和发布提交可作为 0.5.0 开发基线。 - 将核心软件版本更新为
0.5.0。 - 将 CMake 项目版本更新为
0.5.0。 - 更新 Fortran smoke 测试中的版本期望。
- 更新 C API 测试中的版本期望。
- 更新 C++ API 测试中的版本期望。
- 更新 Python debug 测试中的版本期望。
- 更新 CLI
--version和 inspect 版本期望。 - 在 README 中记录 0.5.0
Solid起步版本定位。 - 创建最小 Solid 弹性材料输入样例。
- 创建 Johnson-Cook Solid material 输入样例。
- 创建 Johnson-Cook failure 输入样例。
- 创建 Solid section 输入样例。
- 创建 Solid-only 显式推进 smoke 输入样例。
- 创建 Solid 初始速度或体力驱动输入样例。
- 创建 Solid restart 0.5.0 测试输入样例。
- 创建
STATE_0_4_1restart 兼容测试所需输入或夹具。 - 创建缺失密度的 Solid 错误输入样例。
- 创建缺失弹性参数的 Solid 错误输入样例。
- 创建非法 Johnson-Cook 参数错误输入样例。
- 创建非法 Solid section 错误输入样例。
阶段 B:Solid 输入解析、material 表与 section 识别
- 复核现有 material 类型枚举是否包含
Solid。 - 复核 phase 常量是否包含
PHASE_SOLID和PHASE_SOLID_FAILED。 - 复核 C 头文件和 Python 常量中的 Solid phase/status 命名。
- 新增或加固
TYPE=SOLIDmaterial 识别。 - 支持 Solid material 的
*DENSITY读取。 - 支持 Solid material 的
*ELASTIC读取。 - 支持 Johnson-Cook flow 参数读取。
- 支持 Johnson-Cook failure 参数读取。
- 支持 Solid control 中的 softening 类型读取。
- 支持 Solid control 中的 softening 参数读取。
- 支持
*SOLID SECTION或既有等价 section 关键词。 - 将 Solid section 与 material 映射到内部 section/material id。
- 确认 set 仍只表示集合,不参与 Solid 类型判断。
- 对缺失密度的 Solid material 报 error。
- 对缺失弹性参数的 Solid material 报 error。
- 对非法弹性参数报 error。
- 对非法 Johnson-Cook flow 参数报 error。
- 对非法 Johnson-Cook failure 参数报 error。
- 对非法 Solid section 或缺失 material 的 section 报 error。
- 对无 active Solid 粒子的 Solid material 报 warning 而不阻止其他路径运行。
- 新增
input_solid_material测试并接入 CTest。 - 新增
input_solid_errors测试并接入 CTest。
阶段 C:Solid 状态、生命周期与数据库集成
- 新增 Solid material 表的模块级存储。
- 存储 Solid 密度、弹性模量和泊松比。
- 派生并存储剪切模量、体积模量和结构波速。
- 存储 Johnson-Cook
A、B、n、C、m参数。 - 存储 Johnson-Cook 参考应变率、室温和熔化温度。
- 存储温升或等效塑性功转温升参数。
- 存储 Johnson-Cook failure
D1到D5参数。 - 存储 softening 类型和 softening 参数。
- 新增 Solid 状态 reset 过程。
- 新增 Solid 状态 allocate/build 过程。
- 新增 Solid 状态 clear/finalize 过程。
- 分配
solid_stress(6,npart)状态。 - 分配
solid_strain(6,npart)状态。 - 分配
solid_plastic_strain(npart)状态。 - 分配
solid_plastic_strain_rate(npart)状态。 - 分配
solid_temperature(npart)状态。 - 分配
solid_damage(npart)状态。 - 分配
solid_softening(npart)状态。 - 分配
solid_internal_energy(npart)状态。 - 分配 Solid 变形梯度或等价状态。
- 分配 Solid 梯度修正矩阵或等价占位状态。
- 分配
solid_failure_status(npart)状态。 - 初始化 active Solid 粒子的 Solid 状态默认值。
- 初始化非 Solid 粒子的 Solid 状态为安全默认值。
- 新增
solid_state_build测试并接入 CTest。
阶段 D:弹性、Johnson-Cook 本构与失效材料点
- 新增 Solid 弹性常数计算 helper。
- 新增 Voigt 应力应变工具函数。
- 新增 von Mises 等效应力计算。
- 新增等效塑性应变率安全计算。
- 实现弹性材料点试应力更新。
- 实现弹性材料点内能更新。
- 新增弹性区材料点单测。
- 实现 Johnson-Cook 热软化温度归一化。
- 实现 Johnson-Cook 应变率项计算。
- 实现 Johnson-Cook 硬化项计算。
- 实现 Johnson-Cook 流动应力计算。
- 对非正参考应变率或非法温度参数报 error。
- 实现塑性屈服判断。
- 实现简化显式返回映射或等价塑性修正。
- 更新等效塑性应变和等效塑性应变率。
- 更新塑性功和等效温升状态。
- 新增 Johnson-Cook flow 单测。
- 实现 Johnson-Cook failure 应变计算。
- 实现 Johnson-Cook damage 单调累积。
- 对非法 failure 应变进行受控 error 或保护。
- 实现 damage 达到阈值后的失效状态切换。
- 实现线性渐进软化因子更新。
- 限制 damage 和 softening 在合法范围。
- 确认失效后不删除粒子、不改变质量。
- 新增
solid_elastic_material测试并接入 CTest。 - 新增
solid_johnson_cook_flow测试并接入 CTest。 - 新增
solid_johnson_cook_failure测试并接入 CTest。 - 新增
solid_progressive_softening测试并接入 CTest。
阶段 E:Solid SPH 结构状态、显式推进与稳定时间步
- 建立 Solid active 粒子计数逻辑。
- 建立 Solid failed 粒子计数逻辑。
- 构建 Solid 参考构型邻域或参考邻域占位。
- 构建 Solid 参考体积或参考权重状态。
- 构建 Solid 梯度修正矩阵计算或稳定占位。
- 对退化梯度修正矩阵给出受控 warning 或 error。
- 新增
solid_gradient_correction测试并接入 CTest。 - 将 Solid 更新挂接到显式求解器流程。
- 确保无 active Solid 粒子时跳过 Solid 更新。
- 实现 Solid 速度梯度或应变率计算入口。
- 实现 Solid 本构更新入口。
- 实现 Solid 内力或等价加速度贡献的最小路径。
- 实现 Solid 体力贡献路径。
- 确保 Solid 加速度贡献不污染 Water/Gas/Explosive-only 算例。
- 实现 Solid 动能诊断。
- 实现 Solid 内能诊断。
- 实现 Solid 总动量诊断。
- 实现 Solid 最大 von Mises 应力诊断。
- 实现 Solid 塑性应变范围诊断。
- 实现 Solid damage 和 softening 范围诊断。
- 实现 Solid 结构波速稳定时间步估计。
- 将 Solid dt 约束纳入全局 dt 估计。
- 确认无 Solid 粒子时全局 dt 与 0.4.1 路径一致。
- 新增
solid_stable_dt测试并接入 CTest。 - 新增
solid_explicit_smoke测试并接入 CTest。
阶段 F:输出、restart 与模块级持久化
- 在 summary CSV 中追加 Solid active/failed 粒子数字段。
- 在 summary CSV 中追加 Solid 质量和动量字段。
- 在 summary CSV 中追加 Solid 动能和内能字段。
- 在 summary CSV 中追加 Solid 最大 von Mises 应力字段。
- 在 summary CSV 中追加 Solid 塑性应变范围字段。
- 在 summary CSV 中追加 Solid damage 范围字段。
- 在 summary CSV 中追加 Solid softening 和 dt 字段。
- 在粒子 CSV 中追加 Solid stress 关键字段。
- 在粒子 CSV 中追加 Solid plastic strain 字段。
- 在粒子 CSV 中追加 Solid damage 字段。
- 在粒子 CSV 中追加 Solid softening 字段。
- 在粒子 CSV 中追加 Solid failure status 字段。
- 更新 output 测试以锁定 0.5.0 CSV header。
- 新增
solid_output测试并接入 CTest。 - 将 restart 状态版本更新为
STATE_0_5。 - 将 Solid material 表写入 0.5.0 restart。
- 将 Solid per-particle 状态写入 0.5.0 restart。
- 将 Solid summary 和 dt 诊断写入或可恢复于 0.5.0 restart。
- 从 0.5.0 restart 读回 Solid material 表。
- 从 0.5.0 restart 读回 Solid per-particle 状态。
- 从 0.5.0 restart 读回后继续显式步。
- 从
STATE_0_4_1restart 读回时初始化空 Solid 状态。 - 从
STATE_0_4restart 读回时初始化空 Solid 状态。 - 从
STATE_0_3_1或更早兼容状态读回时初始化空 Solid 状态。 - 确认 restart 后不会重复初始化 Solid 应力、塑性应变、damage 或 softening。
- 新增
solid_restart_050测试并接入 CTest。 - 新增
solid_restart_041_compat测试并接入 CTest。
阶段 G:Fortran API、C ABI、C++、Python 与 CLI
- 新增
sph_get_solid_summaryFortran API。 - 新增 Solid failure counts Fortran API。
- 新增 Solid material summary Fortran API 或确认暂不对外暴露。
- 为 Solid Fortran API 补齐未初始化错误路径。
- 新增
sphlite_get_solid_summaryC ABI。 - 为 Solid C ABI 补齐空指针错误路径。
- 为 Solid C ABI 补齐小容量或非法参数错误路径。
- 在 C API 测试中覆盖 Solid summary 查询。
- 在 C API 测试中覆盖 Solid API 错误路径。
- 在 C++ wrapper 中增加 Solid summary 薄包装。
- 在 C++ API 测试中覆盖 Solid summary 薄包装。
- 在 Python ctypes 中增加 Solid summary 薄包装。
- 在 Python inspect 中追加 Solid 字段。
- 在 Python run/checker 中覆盖 Solid-only smoke。
- 在 Python checker 中覆盖 Solid restart 读回 summary。
- 在 CLI inspect 中追加 Solid 字段。
- 在 CLI run 中追加 Solid 字段。
- 在 CLI checker 中覆盖 Solid 输入、run 和 restart。
- 确认新增 API 不改变 0.4.1 既有接口语义。
- 新增
solid_c_api测试并接入 CTest。 - 新增
solid_python测试并接入 CTest。 - 新增
solid_cli测试并接入 CTest。
阶段 H:回归、门禁、文档同步与发布准备
- 新增
solid_source_size检查项并接入 CTest。 - 复核
tests/source_size_exceptions.txt中 stale 例外。 - 拆分过大的 Solid 源文件或过长过程。
- 保持 0.4.1 完整 gate 全部通过。
- 单独运行 0.5.0 新增 Solid gate。
- 运行
source_size检查并确认无新增无理由例外。 - 运行
git diff --check并清理空白问题。 - 更新 README 的 0.5.0 当前状态和不交付范围。
- 更新 06 号文档的 0.5.0 release gate。
- 更新 09 号文档的 0.5.0 验收记录占位。
- 更新 11 号文档的 0.5.0 benchmark/gate 矩阵。
- 确认文档不宣称已实现
Shell。 - 确认文档不宣称已实现真实水-气-结构工程爆炸响应。
- 确认文档不宣称已实现真实 FEM-SPH 耦合。
- 确认文档不宣称已实现工程级结构破坏 benchmark。
- 确认未新增 FEMLite 直接依赖。
- 确认未修改 SPHLite 文件夹之外的内容。
- 确认默认 gate、Solid 专项 gate、source size 和
git diff --check全部通过。 - 汇总 0.5.0 已完成能力、未交付范围和已知限制。
- 准备 0.5.0 发布前本地提交记录。