Files
SPHLite/todo.md
T
2026-07-03 15:05:43 +08:00

12 KiB
Raw Blame History

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_1 restart 兼容测试所需输入或夹具。
  • 创建缺失密度的 Solid 错误输入样例。
  • 创建缺失弹性参数的 Solid 错误输入样例。
  • 创建非法 Johnson-Cook 参数错误输入样例。
  • 创建非法 Solid section 错误输入样例。

阶段 B:Solid 输入解析、material 表与 section 识别

  • 复核现有 material 类型枚举是否包含 Solid。
  • 复核 phase 常量是否包含 PHASE_SOLID 和 PHASE_SOLID_FAILED。
  • 复核 C 头文件和 Python 常量中的 Solid phase/status 命名。
  • 新增或加固 TYPE=SOLID material 识别。
  • 支持 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_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 发布前本地提交记录。