Files
SPHLite/todo.md
T
2026-07-03 18:26:41 +08:00

279 lines
16 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.1
本文档依据 `docs/v5.1_development_plan.md` 拆分。0.5.1 定位为 `Solid` 版本线的稳定化和结构算法加固版本,目标是在 0.5.0 已完成 Solid 输入、状态、本构、失效、显式推进、restart、接口和 gate 最小闭环的基础上,补强参考构型、速度梯度、应变率、最小内力、能量诊断、`STATE_0_5_1` restart、`STATE_0_5` 兼容读入和接口可观测性。
所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.5.1 不实现 `Shell`、真实水-气-结构工程爆炸响应、真实 FEM-SPH 耦合、工程级结构破坏 benchmark、复杂断裂面追踪、碎片云、焊缝失效库、大规模并行或 GPU 后端。
执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端。
## 阶段 A:版本基线、范围声明与 0.5.1 样例
- [x] 确认当前 git 状态干净或记录已有未提交内容。
- [x] 确认 `v0.5.0` 标签和远端发布提交可作为 0.5.1 开发基线。
- [x] 将核心软件版本更新为 `0.5.1`。
- [x] 将 CMake 项目版本更新为 `0.5.1`。
- [x] 更新 Fortran smoke 测试中的版本期望。
- [x] 更新 C API 测试中的版本期望。
- [x] 更新 C++ API 测试中的版本期望。
- [x] 更新 Python debug 测试中的版本期望。
- [x] 更新 CLI `--version` 和 inspect 版本期望。
- [x] 在 README 中记录 0.5.1 Solid 稳定化开发定位。
- [x] 创建 Solid 0.5.1 正常参考邻域输入样例。
- [x] 创建 Solid 0.5.1 退化参考邻域输入样例。
- [x] 创建 Solid 均匀平动速度场输入样例。
- [x] 创建 Solid 单轴拉伸速度场输入样例。
- [x] 创建 Solid 成对内力平衡输入样例。
- [x] 创建 Solid 对称均匀应力输入样例。
- [x] 创建 Solid softening 内力折减输入样例。
- [x] 创建 Solid 0.5.1 显式推进 smoke 输入样例。
- [x] 创建 `STATE_0_5_1` restart 测试输入样例。
- [x] 准备 `STATE_0_5` restart 兼容读入测试夹具。
- [x] 创建 Solid material 非法泊松比错误输入样例。
- [x] 创建 Solid material 非有限 Johnson-Cook 参数错误输入样例。
- [x] 创建 Solid 非法 softening 类型错误输入样例。
- [x] 创建 Solid section 指向非 Solid material 错误输入样例。
- [x] 创建 active Solid 粒子缺失 Solid section 错误输入样例。
## 阶段 B:Solid 输入校验、section 校验与 warning/error 路径
- [x] 复核 0.5.0 Solid material 解析路径并保持语法兼容。
- [x] 对 Solid material 缺失密度路径保持 error。
- [x] 对 Solid material 非正密度路径保持 error。
- [x] 对 Solid material 缺失弹性参数路径保持 error。
- [x] 对 Solid material 非正弹性模量路径保持 error。
- [x] 对 Solid material 非法泊松比路径新增或加固 error。
- [x] 对 Johnson-Cook flow 参数非有限路径新增或加固 error。
- [x] 对 Johnson-Cook failure 参数非完整路径保持 error。
- [x] 对 Johnson-Cook failure 参数非有限路径新增或加固 error。
- [x] 对 unsupported softening 类型新增或加固 error。
- [x] 对未被 active Solid 粒子使用的 Solid material 保持 warning。
- [x] 对 `*SOLID SECTION` 缺失 material 参数路径保持 error。
- [x] 对 `*SOLID SECTION` 指向不存在 material 路径保持 error。
- [x] 对 `*SOLID SECTION` 指向非 Solid material 路径新增或加固 error。
- [x] 对存在 active Solid 粒子但缺失 Solid section 的模型给出 error。
- [x] 确认 set 仍只表示集合,不参与 Solid 类型判断。
- [x] 确认 phase/status 默认值不改变 Water/Gas/Explosive 路径。
- [x] 新增 `solid_051_input_validation` Fortran 输入测试。
- [x] 将 `solid_051_input_validation` 接入 CTest。
- [x] 确认 0.5.0 `input_solid_material` 和 `input_solid_errors` 仍通过。
## 阶段 C:参考邻域、修正矩阵与变形梯度状态
- [x] 复核 Solid 参考坐标、参考体积和参考邻域现有状态。
- [x] 新增或补齐 Solid 每粒子参考邻居数状态。
- [x] 新增或补齐 Solid 参考邻域退化状态。
- [x] 新增或补齐 Solid 修正矩阵状态码。
- [x] 新增或补齐 Solid 修正矩阵行列式诊断。
- [x] 在 Solid reset 路径初始化参考邻域诊断状态。
- [x] 在 Solid allocate/build 路径分配参考邻域诊断状态。
- [x] 在 Solid clear/finalize 路径释放参考邻域诊断状态。
- [x] 构建 active Solid 粒子的参考邻域计数。
- [x] 在参考邻域计数中排除非 Solid 粒子污染。
- [x] 计算 active Solid 粒子的最小参考邻居数诊断。
- [x] 识别参考邻域不足的退化 Solid 粒子。
- [x] 对退化参考邻域给出受控 warning 或 error。
- [x] 构建 Solid 参考梯度矩阵或等价矩阵。
- [x] 计算 Solid 修正矩阵行列式。
- [x] 检查 Solid 修正矩阵有限性。
- [x] 检查 Solid 修正矩阵近奇异状态。
- [x] 为不可逆修正矩阵提供受控 fallback。
- [x] 将修正矩阵质量诊断写入 Solid summary。
- [x] 将变形梯度初始值设置为单位阵。
- [x] 对非 active Solid 粒子设置安全变形梯度默认值。
- [x] 新增 `solid_reference_neighbor` 测试。
- [x] 新增 `solid_correction_matrix` 测试。
- [x] 将 `solid_reference_neighbor` 接入 CTest。
- [x] 将 `solid_correction_matrix` 接入 CTest。
## 阶段 D:速度梯度、应变率和运动学驱动本构
- [x] 新增或补齐 Solid 速度梯度工作数组。
- [x] 新增或补齐 Solid 应变率状态数组。
- [x] 新增或补齐 Solid 等效应变率状态数组。
- [x] 在 Solid reset 路径初始化速度梯度和应变率状态。
- [x] 在 Solid allocate/build 路径分配速度梯度和应变率状态。
- [x] 在 Solid clear/finalize 路径释放速度梯度和应变率状态。
- [x] 实现 active Solid 粒子的速度梯度计算入口。
- [x] 确认无 active Solid 粒子时跳过速度梯度计算。
- [x] 确认非 Solid 粒子不污染 Solid 速度梯度。
- [x] 实现均匀平动下速度梯度为零的路径。
- [x] 实现单轴拉伸速度场下速度梯度计算。
- [x] 由速度梯度计算对称应变率。
- [x] 将应变率转换为 Voigt 顺序。
- [x] 由应变率和 dt 更新 Solid 应变增量。
- [x] 更新 Solid 总应变状态。
- [x] 由应变率计算等效塑性应变率的安全默认值。
- [x] 将变形梯度更新挂接到速度梯度路径。
- [x] 让弹性材料点更新接受运动学应变增量。
- [x] 让 Johnson-Cook flow 更新接受运动学应变增量。
- [x] 让 Johnson-Cook failure 更新接受运动学应变增量。
- [x] 保持等温退化测试下温度状态可恢复。
- [x] 确认 damage 单调不减。
- [x] 确认 softening 单调不增。
- [x] 确认 `PHASE_SOLID_FAILED` 不可逆。
- [x] 新增 `solid_velocity_gradient` 测试。
- [x] 新增 `solid_strain_increment` 测试。
- [x] 将 `solid_velocity_gradient` 接入 CTest。
- [x] 将 `solid_strain_increment` 接入 CTest。
## 阶段 E:最小 Solid 内力、softening 作用与动力学诊断
- [x] 复核 Solid 加速度清零和累加顺序。
- [x] 新增或补齐 Solid 内力贡献工作数组。
- [x] 新增或补齐 Solid 内力动量残差诊断状态。
- [x] 新增或补齐 Solid 最大加速度诊断状态。
- [x] 实现零应力时 Solid 内力为零。
- [x] 实现均匀平动时 Solid 内力为零。
- [x] 实现成对 Solid 粒子的对称内力贡献。
- [x] 实现对称布置下均匀应力残差受控路径。
- [x] 将 Solid 应力散度或等价力贡献累加到加速度。
- [x] 确认 Solid 内力不污染 Water-only 算例。
- [x] 确认 Solid 内力不污染 Gas-only 算例。
- [x] 确认 Solid 内力不污染 Explosive-Gas-Water 算例。
- [x] 将 softening 因子作用到应力或内力贡献。
- [x] 确认 failed Solid 粒子不被删除。
- [x] 确认 failed Solid 粒子质量不改变。
- [x] 计算 Solid 总动量诊断。
- [x] 计算 Solid 动能诊断。
- [x] 计算 Solid 内能诊断。
- [x] 计算 Solid 塑性功或等价内能增量诊断。
- [x] 计算 Solid 最大 von Mises 应力诊断。
- [x] 计算 Solid 最大应变率诊断。
- [x] 计算 Solid 最大加速度诊断。
- [x] 计算 Solid damage 范围诊断。
- [x] 计算 Solid softening 范围诊断。
- [x] 计算 Solid 内力动量残差诊断。
- [x] 将 Solid 诊断更新挂接到显式推进流程。
- [x] 新增 `solid_internal_force_pair` 测试。
- [x] 新增 `solid_uniform_stress_balance` 测试。
- [x] 新增 `solid_softening_force` 测试。
- [x] 新增 `solid_energy_diagnostics` 测试。
- [x] 将 `solid_internal_force_pair` 接入 CTest。
- [x] 将 `solid_uniform_stress_balance` 接入 CTest。
- [x] 将 `solid_softening_force` 接入 CTest。
- [x] 将 `solid_energy_diagnostics` 接入 CTest。
## 阶段 F:Solid 稳定时间步、显式推进和 0.5.0 回归隔离
- [x] 复核 0.5.0 Solid 结构波速 dt 估计。
- [x] 新增或补齐 Solid 加速度 dt 约束诊断。
- [x] 实现 `dt_solid_acc` 的有限正值保护。
- [x] 将 Solid wave dt 和 acceleration dt 合并为 Solid dt。
- [x] 将 Solid dt 继续纳入全局 dt 估计。
- [x] 确认无 active Solid 粒子时全局 dt 与 0.5.0 路径一致。
- [x] 确认 active Solid 粒子存在时 Solid dt 有限且为正。
- [x] 确认体力增大时加速度 dt 约束可收紧。
- [x] 确认内力增大时加速度 dt 约束可收紧。
- [x] 确认 restart 后 Solid dt 诊断一致。
- [x] 将 Solid 速度梯度、本构、内力和诊断挂接到 Velocity-Verlet 步。
- [x] 确认 Solid-only 小模型可连续推进多步。
- [x] 确认 Water-only smoke 仍通过。
- [x] 确认 Gas-only smoke 仍通过。
- [x] 确认 Explosive-Gas-Water smoke 仍通过。
- [x] 新增 `solid_dt_acceleration` 测试。
- [x] 更新 `solid_explicit_smoke` 覆盖 0.5.1 诊断。
- [x] 将 `solid_dt_acceleration` 接入 CTest。
- [x] 确认 0.5.0 `solid_stable_dt` 仍通过。
- [x] 确认 0.5.0 `solid_explicit_smoke` 仍通过。
## 阶段 G:CSV 输出、`STATE_0_5_1` restart 与兼容读入
- [x] 在 summary CSV 中追加 `solid_max_strain_rate` 字段。
- [x] 在 summary CSV 中追加 `solid_max_acceleration` 字段。
- [x] 在 summary CSV 中追加 `solid_internal_force_residual` 字段。
- [x] 在 summary CSV 中追加 `solid_reference_neighbor_min` 字段。
- [x] 在 summary CSV 中追加 `solid_correction_det_min` 字段。
- [x] 在 summary CSV 中追加 `solid_correction_status` 字段。
- [x] 在粒子 CSV 中追加 `solid_strain_rate_eq` 字段。
- [x] 在粒子 CSV 中追加 `solid_acceleration_norm` 字段。
- [x] 在粒子 CSV 中追加 `solid_reference_neighbor_count` 字段。
- [x] 在粒子 CSV 中追加 `solid_correction_status` 字段。
- [x] 更新 output 测试锁定 0.5.1 CSV header。
- [x] 将 restart 状态版本更新为 `STATE_0_5_1`。
- [x] 将 Solid 参考邻居数写入 0.5.1 restart。
- [x] 将 Solid 修正矩阵状态写入 0.5.1 restart。
- [x] 将 Solid 修正矩阵行列式诊断写入 0.5.1 restart。
- [x] 将 Solid 变形梯度写入 0.5.1 restart。
- [x] 将 Solid 应变率状态写入 0.5.1 restart。
- [x] 将 Solid 0.5.1 新增诊断写入 restart。
- [x] 从 `STATE_0_5_1` restart 读回新增 Solid 状态。
- [x] 从 `STATE_0_5_1` restart 读回后继续显式步。
- [x] 从 `STATE_0_5` restart 兼容读入 Solid 0.5.0 状态。
- [x] 从 `STATE_0_5` restart 读入时初始化 0.5.1 新状态。
- [x] 从 `STATE_0_4_1` restart 读入时初始化空 Solid 0.5.1 状态。
- [x] 确认 restart 后不重复初始化 Solid 应力。
- [x] 确认 restart 后不重复初始化 Solid 塑性应变。
- [x] 确认 restart 后不重复初始化 Solid damage。
- [x] 确认 restart 后不重复初始化 Solid softening。
- [x] 确认 restart 后不重复初始化 Solid 变形梯度。
- [x] 新增 `solid_restart_051` 测试。
- [x] 新增 `solid_restart_050_compat` 测试。
- [x] 将 `solid_restart_051` 接入 CTest。
- [x] 将 `solid_restart_050_compat` 接入 CTest。
## 阶段 H:Fortran API、C ABI、C++、Python 与 CLI
- [x] 新增 `sph_get_solid_state` Fortran API。
- [x] 新增 `sph_get_solid_diagnostics` Fortran API。
- [x] 新增 `sph_get_solid_reference_quality` Fortran API。
- [x] 为 Solid 0.5.1 Fortran API 补齐未初始化错误路径。
- [x] 为 Solid 0.5.1 Fortran API 补齐小容量错误路径。
- [x] 在 C 头文件中声明 `sphlite_get_solid_particle_state`。
- [x] 在 C ABI 中实现 Solid 粒子级状态查询。
- [x] 在 C ABI 中校验空指针错误路径。
- [x] 在 C ABI 中校验非正容量错误路径。
- [x] 在 C ABI 中校验小容量错误路径。
- [x] 在 C ABI 中锁定 stress 展开顺序。
- [x] 在 C ABI 中锁定 strain 展开顺序。
- [x] 在 C ABI 中锁定 strain-rate 展开顺序。
- [x] 在 C API 测试中覆盖 Solid 粒子级状态查询。
- [x] 在 C API 测试中覆盖 Solid 0.5.1 错误路径。
- [x] 在 C++ wrapper 中新增 Solid particle state 薄包装。
- [x] 在 C++ API 测试中覆盖 Solid particle state 薄包装。
- [x] 在 Python ctypes 中新增 Solid particle state 薄包装。
- [x] 在 Python inspect 中追加 Solid 0.5.1 诊断字段。
- [x] 在 Python run/checker 中覆盖 Solid 0.5.1 小模型。
- [x] 在 Python checker 中覆盖 `STATE_0_5_1` restart 读回。
- [x] 在 Python checker 中覆盖 `STATE_0_5` restart 兼容读入。
- [x] 在 CLI inspect 中追加 `solid_max_strain_rate` 字段。
- [x] 在 CLI inspect 中追加 `solid_max_acceleration` 字段。
- [x] 在 CLI inspect 中追加 `solid_internal_force_residual` 字段。
- [x] 在 CLI inspect 中追加 `solid_correction_status` 字段。
- [x] 在 CLI inspect 中追加 `solid_reference_neighbor_min` 字段。
- [x] 在 CLI run 中追加 Solid 0.5.1 诊断字段。
- [x] 在 CLI checker 中覆盖 Solid 0.5.1 输入、run 和 restart。
- [x] 确认新增 API 不改变 0.5.0 已有接口语义。
- [x] 新增 `solid_state_api` 测试并接入 CTest。
- [x] 新增 `solid_python_051` 测试并接入 CTest。
- [x] 新增 `solid_cli_051` 测试并接入 CTest。
## 阶段 I:源码尺寸、回归门禁、文档同步与发布准备
- [ ] 新增 `solid_051_source_size` 检查项并接入 CTest。
- [ ] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。
- [ ] 拆分过大的 Solid reference 源文件或过长过程。
- [ ] 拆分过大的 Solid kinematics 源文件或过长过程。
- [ ] 拆分过大的 Solid force 源文件或过长过程。
- [ ] 拆分过大的 Solid restart 源文件或过长过程。
- [ ] 保持 0.5.0 完整 gate 全部通过。
- [ ] 单独运行 0.5.0 Solid 专项 gate。
- [ ] 单独运行 0.5.1 Solid 专项 gate。
- [ ] 运行 `source_size` 检查并确认无新增无理由例外。
- [ ] 运行 `git diff --check` 并清理空白问题。
- [ ] 更新 README 的 0.5.1 当前状态和不交付范围。
- [ ] 更新 06 号文档的 0.5.1 release gate。
- [ ] 更新 09 号文档的 0.5.1 验收记录占位。
- [ ] 更新 11 号文档的 0.5.1 benchmark/gate 矩阵。
- [ ] 确认文档不宣称已实现 `Shell`。
- [ ] 确认文档不宣称已实现真实水-气-结构工程爆炸响应。
- [ ] 确认文档不宣称已实现真实 FEM-SPH 耦合。
- [ ] 确认文档不宣称已实现工程级结构破坏 benchmark。
- [ ] 确认未新增几何、网格或粒子生成能力。
- [ ] 确认未新增 FEMLite 直接依赖。
- [ ] 确认未修改 SPHLite 文件夹之外的内容。
- [ ] 确认默认 gate、0.5.0 Solid gate、0.5.1 Solid gate、source size 和 `git diff --check` 全部通过。
- [ ] 汇总 0.5.1 已完成能力、未交付范围和已知限制。
- [ ] 准备 0.5.1 发布前本地提交记录。