225 lines
12 KiB
Markdown
225 lines
12 KiB
Markdown
# 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:版本基线、范围声明与输入样例
|
||
|
||
- [x] 确认当前 git 状态并记录 0.5.0 开发起点。
|
||
- [x] 确认 `v0.4.1` 标签和发布提交可作为 0.5.0 开发基线。
|
||
- [x] 将核心软件版本更新为 `0.5.0`。
|
||
- [x] 将 CMake 项目版本更新为 `0.5.0`。
|
||
- [x] 更新 Fortran smoke 测试中的版本期望。
|
||
- [x] 更新 C API 测试中的版本期望。
|
||
- [x] 更新 C++ API 测试中的版本期望。
|
||
- [x] 更新 Python debug 测试中的版本期望。
|
||
- [x] 更新 CLI `--version` 和 inspect 版本期望。
|
||
- [x] 在 README 中记录 0.5.0 `Solid` 起步版本定位。
|
||
- [x] 创建最小 Solid 弹性材料输入样例。
|
||
- [x] 创建 Johnson-Cook Solid material 输入样例。
|
||
- [x] 创建 Johnson-Cook failure 输入样例。
|
||
- [x] 创建 Solid section 输入样例。
|
||
- [x] 创建 Solid-only 显式推进 smoke 输入样例。
|
||
- [x] 创建 Solid 初始速度或体力驱动输入样例。
|
||
- [x] 创建 Solid restart 0.5.0 测试输入样例。
|
||
- [x] 创建 `STATE_0_4_1` restart 兼容测试所需输入或夹具。
|
||
- [x] 创建缺失密度的 Solid 错误输入样例。
|
||
- [x] 创建缺失弹性参数的 Solid 错误输入样例。
|
||
- [x] 创建非法 Johnson-Cook 参数错误输入样例。
|
||
- [x] 创建非法 Solid section 错误输入样例。
|
||
|
||
## 阶段 B:Solid 输入解析、material 表与 section 识别
|
||
|
||
- [x] 复核现有 material 类型枚举是否包含 `Solid`。
|
||
- [x] 复核 phase 常量是否包含 `PHASE_SOLID` 和 `PHASE_SOLID_FAILED`。
|
||
- [x] 复核 C 头文件和 Python 常量中的 Solid phase/status 命名。
|
||
- [x] 新增或加固 `TYPE=SOLID` material 识别。
|
||
- [x] 支持 Solid material 的 `*DENSITY` 读取。
|
||
- [x] 支持 Solid material 的 `*ELASTIC` 读取。
|
||
- [x] 支持 Johnson-Cook flow 参数读取。
|
||
- [x] 支持 Johnson-Cook failure 参数读取。
|
||
- [x] 支持 Solid control 中的 softening 类型读取。
|
||
- [x] 支持 Solid control 中的 softening 参数读取。
|
||
- [x] 支持 `*SOLID SECTION` 或既有等价 section 关键词。
|
||
- [x] 将 Solid section 与 material 映射到内部 section/material id。
|
||
- [x] 确认 set 仍只表示集合,不参与 Solid 类型判断。
|
||
- [x] 对缺失密度的 Solid material 报 error。
|
||
- [x] 对缺失弹性参数的 Solid material 报 error。
|
||
- [x] 对非法弹性参数报 error。
|
||
- [x] 对非法 Johnson-Cook flow 参数报 error。
|
||
- [x] 对非法 Johnson-Cook failure 参数报 error。
|
||
- [x] 对非法 Solid section 或缺失 material 的 section 报 error。
|
||
- [x] 对无 active Solid 粒子的 Solid material 报 warning 而不阻止其他路径运行。
|
||
- [x] 新增 `input_solid_material` 测试并接入 CTest。
|
||
- [x] 新增 `input_solid_errors` 测试并接入 CTest。
|
||
|
||
## 阶段 C:Solid 状态、生命周期与数据库集成
|
||
|
||
- [x] 新增 Solid material 表的模块级存储。
|
||
- [x] 存储 Solid 密度、弹性模量和泊松比。
|
||
- [x] 派生并存储剪切模量、体积模量和结构波速。
|
||
- [x] 存储 Johnson-Cook `A`、`B`、`n`、`C`、`m` 参数。
|
||
- [x] 存储 Johnson-Cook 参考应变率、室温和熔化温度。
|
||
- [x] 存储温升或等效塑性功转温升参数。
|
||
- [x] 存储 Johnson-Cook failure `D1` 到 `D5` 参数。
|
||
- [x] 存储 softening 类型和 softening 参数。
|
||
- [x] 新增 Solid 状态 reset 过程。
|
||
- [x] 新增 Solid 状态 allocate/build 过程。
|
||
- [x] 新增 Solid 状态 clear/finalize 过程。
|
||
- [x] 分配 `solid_stress(6,npart)` 状态。
|
||
- [x] 分配 `solid_strain(6,npart)` 状态。
|
||
- [x] 分配 `solid_plastic_strain(npart)` 状态。
|
||
- [x] 分配 `solid_plastic_strain_rate(npart)` 状态。
|
||
- [x] 分配 `solid_temperature(npart)` 状态。
|
||
- [x] 分配 `solid_damage(npart)` 状态。
|
||
- [x] 分配 `solid_softening(npart)` 状态。
|
||
- [x] 分配 `solid_internal_energy(npart)` 状态。
|
||
- [x] 分配 Solid 变形梯度或等价状态。
|
||
- [x] 分配 Solid 梯度修正矩阵或等价占位状态。
|
||
- [x] 分配 `solid_failure_status(npart)` 状态。
|
||
- [x] 初始化 active Solid 粒子的 Solid 状态默认值。
|
||
- [x] 初始化非 Solid 粒子的 Solid 状态为安全默认值。
|
||
- [x] 新增 `solid_state_build` 测试并接入 CTest。
|
||
|
||
## 阶段 D:弹性、Johnson-Cook 本构与失效材料点
|
||
|
||
- [x] 新增 Solid 弹性常数计算 helper。
|
||
- [x] 新增 Voigt 应力应变工具函数。
|
||
- [x] 新增 von Mises 等效应力计算。
|
||
- [x] 新增等效塑性应变率安全计算。
|
||
- [x] 实现弹性材料点试应力更新。
|
||
- [x] 实现弹性材料点内能更新。
|
||
- [x] 新增弹性区材料点单测。
|
||
- [x] 实现 Johnson-Cook 热软化温度归一化。
|
||
- [x] 实现 Johnson-Cook 应变率项计算。
|
||
- [x] 实现 Johnson-Cook 硬化项计算。
|
||
- [x] 实现 Johnson-Cook 流动应力计算。
|
||
- [x] 对非正参考应变率或非法温度参数报 error。
|
||
- [x] 实现塑性屈服判断。
|
||
- [x] 实现简化显式返回映射或等价塑性修正。
|
||
- [x] 更新等效塑性应变和等效塑性应变率。
|
||
- [x] 更新塑性功和等效温升状态。
|
||
- [x] 新增 Johnson-Cook flow 单测。
|
||
- [x] 实现 Johnson-Cook failure 应变计算。
|
||
- [x] 实现 Johnson-Cook damage 单调累积。
|
||
- [x] 对非法 failure 应变进行受控 error 或保护。
|
||
- [x] 实现 damage 达到阈值后的失效状态切换。
|
||
- [x] 实现线性渐进软化因子更新。
|
||
- [x] 限制 damage 和 softening 在合法范围。
|
||
- [x] 确认失效后不删除粒子、不改变质量。
|
||
- [x] 新增 `solid_elastic_material` 测试并接入 CTest。
|
||
- [x] 新增 `solid_johnson_cook_flow` 测试并接入 CTest。
|
||
- [x] 新增 `solid_johnson_cook_failure` 测试并接入 CTest。
|
||
- [x] 新增 `solid_progressive_softening` 测试并接入 CTest。
|
||
|
||
## 阶段 E:Solid SPH 结构状态、显式推进与稳定时间步
|
||
|
||
- [x] 建立 Solid active 粒子计数逻辑。
|
||
- [x] 建立 Solid failed 粒子计数逻辑。
|
||
- [x] 构建 Solid 参考构型邻域或参考邻域占位。
|
||
- [x] 构建 Solid 参考体积或参考权重状态。
|
||
- [x] 构建 Solid 梯度修正矩阵计算或稳定占位。
|
||
- [x] 对退化梯度修正矩阵给出受控 warning 或 error。
|
||
- [x] 新增 `solid_gradient_correction` 测试并接入 CTest。
|
||
- [x] 将 Solid 更新挂接到显式求解器流程。
|
||
- [x] 确保无 active Solid 粒子时跳过 Solid 更新。
|
||
- [x] 实现 Solid 速度梯度或应变率计算入口。
|
||
- [x] 实现 Solid 本构更新入口。
|
||
- [x] 实现 Solid 内力或等价加速度贡献的最小路径。
|
||
- [x] 实现 Solid 体力贡献路径。
|
||
- [x] 确保 Solid 加速度贡献不污染 Water/Gas/Explosive-only 算例。
|
||
- [x] 实现 Solid 动能诊断。
|
||
- [x] 实现 Solid 内能诊断。
|
||
- [x] 实现 Solid 总动量诊断。
|
||
- [x] 实现 Solid 最大 von Mises 应力诊断。
|
||
- [x] 实现 Solid 塑性应变范围诊断。
|
||
- [x] 实现 Solid damage 和 softening 范围诊断。
|
||
- [x] 实现 Solid 结构波速稳定时间步估计。
|
||
- [x] 将 Solid dt 约束纳入全局 dt 估计。
|
||
- [x] 确认无 Solid 粒子时全局 dt 与 0.4.1 路径一致。
|
||
- [x] 新增 `solid_stable_dt` 测试并接入 CTest。
|
||
- [x] 新增 `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_1` restart 读回时初始化空 Solid 状态。
|
||
- [ ] 从 `STATE_0_4` restart 读回时初始化空 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_summary` Fortran API。
|
||
- [ ] 新增 Solid failure counts Fortran API。
|
||
- [ ] 新增 Solid material summary Fortran API 或确认暂不对外暴露。
|
||
- [ ] 为 Solid Fortran API 补齐未初始化错误路径。
|
||
- [ ] 新增 `sphlite_get_solid_summary` C 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 发布前本地提交记录。
|