Files
SPHLite/todo.md
T
2026-07-03 10:52:40 +08:00

148 lines
8.4 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.3.1
本文档依据 `docs/v3.1_development_plan.md` 拆分。0.3.1 定位为 `Gas` 模块稳定化和前置加固版本,目标是在 0.3.0 Gas 最小闭环基础上,补强多 Gas material/EOS、Gas 源项占位、诊断一致性、restart 兼容性、接口覆盖和 release gate 可维护性。
所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.3.1 不实现 Explosive 解析点火、爆轰传播、反应进度、炸药 phase 迁移、Solid/Shell 生产求解路径或真实 FEM-SPH 耦合。
执行约定:每完成 20 个待办事项,进行一次本地 git 提交,暂不推送远端。
## 阶段 A:版本基线与输入样例
- [x] 确认当前 git 状态并记录 0.3.1 开发起点。
- [x] 确认 `v0.3.0` 标签和 0.3.0 发布提交可作为 0.3.1 基线。
- [x] 将核心软件版本更新为 `0.3.1`。
- [x] 将 CMake 项目版本更新为 `0.3.1`。
- [x] 更新 Fortran smoke 测试中的版本期望。
- [x] 更新 C API 测试中的版本期望。
- [x] 更新 C++ API 测试中的版本期望。
- [x] 更新 Python debug 测试中的版本期望。
- [x] 更新 CLI `--version` 和 inspect 版本期望。
- [x] 在 README 中记录 0.3.1 Gas 稳定化开发定位。
- [x] 创建空气类 `TYPE=GAS` 理想气体输入样例。
- [x] 创建爆轰产物类 `TYPE=GAS` JWL 输入样例。
- [x] 创建 `TYPE=GAS` Stiffened gas 输入样例。
- [x] 创建同一模型同时包含空气和爆轰产物 Gas material 的输入样例。
- [x] 创建同一模型包含三类 Gas EOS 的输入样例。
- [x] 创建多个 Gas section 绑定不同 Gas material 的输入样例。
- [x] 创建 Gas material 没有关联 active 粒子的 warning 输入样例。
- [x] 创建某个 Gas material 缺失 `*DENSITY` 的错误输入样例。
- [x] 创建某个 Gas material 缺失 `*SPHLITE EOS` 的错误输入样例。
- [x] 创建 `*SPHLITE EOS` 引用不存在 material 的错误输入样例。
## 阶段 B:Gas 多材料输入解析与状态表
- [x] 为 Gas material 数量增加集中式统计字段。
- [x] 为 Gas material 内部 id 增加存储字段。
- [x] 为 Gas material 名称增加存储字段。
- [x] 为 Gas material EOS 类型增加存储字段。
- [x] 为 Gas material 密度默认值增加存储字段。
- [x] 为 Gas material 内能默认值增加存储字段。
- [x] 为 Gas material 温度默认值增加存储字段。
- [x] 为理想气体 EOS 增加 material 级参数表。
- [x] 为 JWL EOS 增加 material 级参数表。
- [x] 为 Stiffened gas EOS 增加 material 级参数表。
- [x] 增加 Gas material 状态表初始化过程。
- [x] 增加 Gas material 状态表清理过程。
- [x] 增加按 material 名称查找 Gas material id 的过程。
- [x] 将 `*MATERIAL, TYPE=GAS` 解析结果注册到 Gas material 状态表。
- [x] 将 `*SPHLITE EOS, MATERIAL=...` 解析结果绑定到对应 Gas material。
- [x] 对同一 Gas material 重复定义 EOS 的输入报 error。
- [x] 对非 Gas material 定义 Gas EOS 的输入报 error。
- [x] 对 Gas material 缺失 EOS 的输入报 error。
- [x] 对 Gas material 无 active 粒子的输入报 warning。
- [x] 保持 0.3.0 单 Gas material 输入兼容通过。
## 阶段 C:EOS 分派、状态初始化与时间步
- [x] 将 Gas 压力更新改为按粒子 `material_id` 分派 EOS。
- [x] 为理想气体压力更新增加 material 级分派测试。
- [x] 为 JWL 压力更新增加 material 级分派测试。
- [x] 为 Stiffened gas 压力更新增加 material 级分派测试。
- [x] 增加空气和爆轰产物混合输入的逐粒子压力检查。
- [x] 对 Gas 粒子 material 无 EOS 的状态更新路径报 error。
- [x] 将 Gas 初始密度设置改为按 material 分派。
- [x] 将 Gas 初始内能设置改为按 material 分派。
- [x] 将 Gas 初始温度设置改为按 material 分派。
- [x] 将 Gas 初始压力设置改为按 material EOS 计算。
- [x] 将 Gas 默认质量控制策略改为按 material 或共享策略处理。
- [x] 将 Gas 默认体积控制策略改为按 material 或共享策略处理。
- [x] 将 Gas 默认光滑长度策略改为按 material 或共享策略处理。
- [x] 将 Gas 外部体力策略保持为共享路径并补充混合材料测试。
- [x] 将 Gas 声速估计改为按 material/EOS 分派。
- [x] 将 Gas CFL 时间步限制改为记录 `gas_dt_cfl`。
- [x] 将 Gas 加速度时间步限制改为记录 `gas_dt_accel`。
- [x] 将 Gas 临界时间步取值改为使用各分量最小值。
- [x] 增加混合 Gas material 的时间步估计测试。
- [x] 确认 Water 时间步和 pressure wave smoke 行为未被 Gas 改动影响。
## 阶段 D:Gas 源项占位、诊断与输出
- [x] 增加 `gas_mass_source(:)` 状态数组。
- [x] 增加 `gas_energy_source(:)` 状态数组。
- [x] 增加 `gas_momentum_source(:,:)` 状态数组。
- [x] 在粒子数量变化或模型初始化时分配 Gas 源项数组。
- [x] 在模型清理时释放 Gas 源项数组。
- [x] 实现 `sph_gas_clear_sources` 内部过程。
- [x] 实现 `sph_gas_add_source_by_particle` 内部过程。
- [x] 实现 `sph_gas_apply_sources_explicit` 内部过程。
- [x] 实现 `sph_gas_get_source_summary` 内部过程。
- [x] 对非法粒子 id 添加 Gas 源项时报 error。
- [x] 对非 Gas 粒子添加 Gas 源项时报 error。
- [x] 对非法数值源项添加 Gas 源项时报 error。
- [x] 增加 Gas 质量源项累计和清零测试。
- [x] 增加 Gas 动量源项累计和清零测试。
- [x] 增加 Gas 能量源项累计和清零测试。
- [x] 增加 Gas 源项显式应用后质量变化测试。
- [x] 增加 Gas 源项显式应用后速度或动量变化测试。
- [x] 增加 Gas 源项显式应用后内能或能量变化测试。
- [x] 扩展 Gas summary,输出动量和密度范围。
- [x] 扩展 Gas output,输出稳定的 0.3.1 诊断字段。
## 阶段 E:Restart、API、C++、Python 与 CLI
- [ ] 设计 0.3.1 restart 的 Gas state revision 标识。
- [ ] 将 Gas material/EOS 表写入 0.3.1 restart。
- [ ] 将 Gas 默认粒子控制状态写入 0.3.1 restart。
- [ ] 将 Gas 外部体力状态写入 0.3.1 restart。
- [ ] 将 Gas 源项缓存写入 0.3.1 restart。
- [ ] 将 Gas dt 诊断写入 0.3.1 restart。
- [ ] 将 Gas bubble metrics 历史状态写入 0.3.1 restart。
- [ ] 从 0.3.1 restart 读回 Gas material/EOS 表。
- [ ] 从 0.3.1 restart 读回 Gas 源项缓存。
- [ ] 从 0.3.1 restart 读回后重建邻域并继续显式步。
- [ ] 增加读取 0.3.0 `STATE_0_3` restart 的兼容路径。
- [ ] 为 0.3.0 restart 缺失的 Gas material 表初始化默认值。
- [ ] 为 0.3.0 restart 缺失的 Gas 源项状态初始化零值。
- [ ] 增加 `sph_get_gas_extended_summary` Fortran API。
- [ ] 增加 `sph_get_gas_source_summary` Fortran API。
- [ ] 在 C ABI 中追加 Gas extended summary 查询接口。
- [ ] 在 C ABI 中追加 Gas source summary 查询接口。
- [ ] 在 C++ wrapper 中增加 Gas extended/source summary 薄包装。
- [ ] 在 Python ctypes 中增加 Gas extended/source summary 薄包装。
- [ ] 在 CLI inspect/run 中增加 0.3.1 Gas 扩展字段检查。
## 阶段 F:测试接入、文档同步与发布门禁
- [ ] 新增 `input_gas_multimaterial` 测试并接入 CTest。
- [ ] 新增 `gas_eos_dispatch` 测试并接入 CTest。
- [ ] 新增 `gas_source` 测试并接入 CTest。
- [ ] 新增 `gas_source_errors` 测试并接入 CTest。
- [ ] 新增 `gas_extended_summary` 测试并接入 CTest。
- [ ] 新增 `gas_restart_031` 测试并接入 CTest。
- [ ] 新增 `gas_restart_030_compat` 测试并接入 CTest。
- [ ] 新增 `gas_cli_extended` 测试并接入 CTest。
- [ ] 新增 `gas_python_extended` 测试并接入 CTest。
- [ ] 新增 `gas_source_size_cleanup` 测试或检查项并接入 CTest。
- [ ] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。
- [ ] 拆分因 0.3.1 改动变长的 Fortran 过程。
- [ ] 保持 0.3.0 默认 gate 全部通过。
- [ ] 单独运行 0.3.1 新增 Gas 稳定化 gate。
- [ ] 运行 `source_size` 检查并确认无新增无理由例外。
- [ ] 运行 `git diff --check` 并清理空白问题。
- [ ] 更新 `docs/06_test_and_verification_plan.md` 的 0.3.1 测试范围。
- [ ] 更新 `docs/09_release_history.md` 的 0.3.1 待发布记录。
- [ ] 更新 `docs/11_benchmark_matrix.md` 的 0.3.1 验收矩阵。
- [ ] 确认文档未宣称 0.3.1 已实现 Explosive、Solid、Shell 或真实 FEM-SPH 耦合。