Files
SPHLite/todo.md
T
2026-07-03 16:32:27 +08:00

225 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 与模块级持久化
- [x] 在 summary CSV 中追加 Solid active/failed 粒子数字段。
- [x] 在 summary CSV 中追加 Solid 质量和动量字段。
- [x] 在 summary CSV 中追加 Solid 动能和内能字段。
- [x] 在 summary CSV 中追加 Solid 最大 von Mises 应力字段。
- [x] 在 summary CSV 中追加 Solid 塑性应变范围字段。
- [x] 在 summary CSV 中追加 Solid damage 范围字段。
- [x] 在 summary CSV 中追加 Solid softening 和 dt 字段。
- [x] 在粒子 CSV 中追加 Solid stress 关键字段。
- [x] 在粒子 CSV 中追加 Solid plastic strain 字段。
- [x] 在粒子 CSV 中追加 Solid damage 字段。
- [x] 在粒子 CSV 中追加 Solid softening 字段。
- [x] 在粒子 CSV 中追加 Solid failure status 字段。
- [x] 更新 output 测试以锁定 0.5.0 CSV header。
- [x] 新增 `solid_output` 测试并接入 CTest。
- [x] 将 restart 状态版本更新为 `STATE_0_5`。
- [x] 将 Solid material 表写入 0.5.0 restart。
- [x] 将 Solid per-particle 状态写入 0.5.0 restart。
- [x] 将 Solid summary 和 dt 诊断写入或可恢复于 0.5.0 restart。
- [x] 从 0.5.0 restart 读回 Solid material 表。
- [x] 从 0.5.0 restart 读回 Solid per-particle 状态。
- [x] 从 0.5.0 restart 读回后继续显式步。
- [x] 从 `STATE_0_4_1` restart 读回时初始化空 Solid 状态。
- [x] 从 `STATE_0_4` restart 读回时初始化空 Solid 状态。
- [x] 从 `STATE_0_3_1` 或更早兼容状态读回时初始化空 Solid 状态。
- [x] 确认 restart 后不会重复初始化 Solid 应力、塑性应变、damage 或 softening。
- [x] 新增 `solid_restart_050` 测试并接入 CTest。
- [x] 新增 `solid_restart_041_compat` 测试并接入 CTest。
## 阶段 G:Fortran API、C ABI、C++、Python 与 CLI
- [x] 新增 `sph_get_solid_summary` Fortran API。
- [x] 新增 Solid failure counts Fortran API。
- [x] 新增 Solid material summary Fortran API 或确认暂不对外暴露。
- [x] 为 Solid Fortran API 补齐未初始化错误路径。
- [x] 新增 `sphlite_get_solid_summary` C ABI。
- [x] 为 Solid C ABI 补齐空指针错误路径。
- [x] 为 Solid C ABI 补齐小容量或非法参数错误路径。
- [x] 在 C API 测试中覆盖 Solid summary 查询。
- [x] 在 C API 测试中覆盖 Solid API 错误路径。
- [x] 在 C++ wrapper 中增加 Solid summary 薄包装。
- [x] 在 C++ API 测试中覆盖 Solid summary 薄包装。
- [x] 在 Python ctypes 中增加 Solid summary 薄包装。
- [x] 在 Python inspect 中追加 Solid 字段。
- [x] 在 Python run/checker 中覆盖 Solid-only smoke。
- [x] 在 Python checker 中覆盖 Solid restart 读回 summary。
- [x] 在 CLI inspect 中追加 Solid 字段。
- [x] 在 CLI run 中追加 Solid 字段。
- [x] 在 CLI checker 中覆盖 Solid 输入、run 和 restart。
- [x] 确认新增 API 不改变 0.4.1 既有接口语义。
- [x] 新增 `solid_c_api` 测试并接入 CTest。
- [x] 新增 `solid_python` 测试并接入 CTest。
- [x] 新增 `solid_cli` 测试并接入 CTest。
## 阶段 H:回归、门禁、文档同步与发布准备
- [x] 新增 `solid_source_size` 检查项并接入 CTest。
- [x] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。
- [x] 拆分过大的 Solid 源文件或过长过程。
- [x] 保持 0.4.1 完整 gate 全部通过。
- [x] 单独运行 0.5.0 新增 Solid gate。
- [x] 运行 `source_size` 检查并确认无新增无理由例外。
- [x] 运行 `git diff --check` 并清理空白问题。
- [x] 更新 README 的 0.5.0 当前状态和不交付范围。
- [x] 更新 06 号文档的 0.5.0 release gate。
- [x] 更新 09 号文档的 0.5.0 验收记录占位。
- [x] 更新 11 号文档的 0.5.0 benchmark/gate 矩阵。
- [x] 确认文档不宣称已实现 `Shell`。
- [x] 确认文档不宣称已实现真实水-气-结构工程爆炸响应。
- [x] 确认文档不宣称已实现真实 FEM-SPH 耦合。
- [x] 确认文档不宣称已实现工程级结构破坏 benchmark。
- [x] 确认未新增 FEMLite 直接依赖。
- [x] 确认未修改 SPHLite 文件夹之外的内容。
- [x] 确认默认 gate、Solid 专项 gate、source size 和 `git diff --check` 全部通过。
- [x] 汇总 0.5.0 已完成能力、未交付范围和已知限制。
- [x] 准备 0.5.0 发布前本地提交记录。