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

148 lines
8.6 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.4.1
本文档依据 `docs/v4.1_development_plan.md` 拆分。0.4.1 定位为 0.4 `Explosive` 版本线的稳定化和加固版本,目标是在 0.4.0 已完成解析点火、programmed burn、Gas 源项注入、phase 转化、restart 和接口 gate 的基础上,加固多点点火、多炸药材料、释放量基准、release balance、Water/Gas/Explosive 混合 smoke 和 restart 兼容。
所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.4.1 不实现 Solid、Shell、真实 FEM-SPH 耦合、工程级水下爆炸 benchmark、完整化学反应爆轰模型或球面经验载荷主模型。
执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端。
## 阶段 A:版本基线、范围声明与输入样例
- [x] 确认当前 git 状态并记录 0.4.1 开发起点。
- [x] 确认 `v0.4.0` 标签和发布提交可作为 0.4.1 开发基线。
- [x] 将核心软件版本更新为 `0.4.1`。
- [x] 将 CMake 项目版本更新为 `0.4.1`。
- [x] 更新 Fortran smoke 测试中的版本期望。
- [x] 更新 C API 测试中的版本期望。
- [x] 更新 C++ API 测试中的版本期望。
- [x] 更新 Python debug 测试中的版本期望。
- [x] 更新 CLI `--version` 和 inspect 版本期望。
- [x] 在 README 中记录 0.4.1 Explosive 稳定化版本定位。
- [x] 创建多点点火正向输入样例。
- [x] 创建多点点火顺序反转输入样例。
- [x] 创建多点点火跨 material 输入样例。
- [x] 创建多 Explosive material 输入样例。
- [x] 创建多个 product Gas material 输入样例。
- [x] 创建 SOURCE 路径多 target Gas material 输入样例。
- [x] 创建 PHASE 路径 Gas 状态刷新输入样例。
- [x] 创建 Water/Gas/Explosive 混合 smoke 输入样例。
- [x] 创建 `STATE_0_4` restart 兼容测试所需输入或夹具。
- [x] 创建缺少匹配点火记录的错误输入样例。
## 阶段 B:多点点火、多材料输入与校验
- [x] 复核 0.4.0 点火记录存储结构是否支持同一 material 多条记录。
- [x] 加固点火记录清理过程,确保重复初始化不会残留旧记录。
- [x] 加固点火记录 material 匹配逻辑。
- [x] 加固点火记录输入顺序无关逻辑。
- [x] 实现多点点火到达时间取最小值的显式测试路径。
- [x] 对缺少匹配点火记录的 explosive 粒子报 error。
- [x] 对点火时间为负值的输入保持 error。
- [x] 对点火坐标非法或缺失的输入保持 error。
- [x] 复核 Explosive material 注册过程支持多个炸药材料。
- [x] 复核 Explosive control 表支持每个 material 独立参数。
- [x] 复核 product Gas material 映射支持多个目标材料。
- [x] 校验不同 Explosive material 可使用不同爆速。
- [x] 校验不同 Explosive material 可使用不同单位质量能量。
- [x] 校验不同 Explosive material 可使用不同 burn time。
- [x] 校验不同 Explosive material 可使用不同 conversion mode。
- [x] 校验不同 Explosive material 可映射到相同 product Gas。
- [x] 校验不同 Explosive material 可映射到不同 product Gas。
- [x] 对 product Gas material 缺失 EOS 的多材料输入报 error。
- [x] 对无 active 粒子的 Explosive material 继续报 warning 而不阻止运行。
- [x] 新增多点点火和多材料输入模块测试并接入 CTest。
## 阶段 C:反应质量基准与释放量一致性
- [x] 新增每粒子 Explosive 反应质量基准状态。
- [x] 在 Explosive 状态分配过程中分配反应质量基准数组。
- [x] 在 Explosive 状态清理过程中清零反应质量基准数组。
- [x] 在模型构建阶段从当前粒子质量冻结反应质量基准。
- [x] 确认无 Explosive 输入时反应质量基准不影响 Water/Gas 算例。
- [x] 将 SOURCE 路径释放质量改为使用冻结反应质量基准。
- [x] 将 PHASE 路径释放质量改为使用冻结反应质量基准。
- [x] 保持 `delta_lambda` 作为唯一释放增量来源。
- [x] 保持 `lambda` 单调不可逆并限制在 `[0,1]`。
- [x] 保持 `burn_time = 0` 的瞬时反应行为。
- [x] 保持 `burn_time > 0` 的线性反应窗口行为。
- [x] 计算每粒子剩余可反应质量。
- [x] 计算全局 Explosive 初始反应质量。
- [x] 计算全局 Explosive 累计释放质量。
- [x] 计算全局 Explosive 剩余可反应质量。
- [x] 计算释放质量闭合误差诊断。
- [x] 计算释放能量闭合误差诊断。
- [x] 计算三向释放动量合计诊断。
- [x] 新增初始质量释放一致性测试并接入 CTest。
- [x] 新增 release balance 模块测试并接入 CTest。
## 阶段 D:SOURCE、PHASE、混合链路与输出
- [ ] 加固 SOURCE 路径 product Gas target 计数逻辑。
- [ ] 确保 SOURCE 路径只选择匹配 product material 的 active Gas 粒子。
- [ ] 确保 SOURCE 路径存在多个 Gas material 时不会跨 material 注入。
- [ ] 对 SOURCE 路径无 active product Gas target 的输入保持 error。
- [ ] 统计 SOURCE 路径参与接收的 Gas 粒子数。
- [ ] 统计 SOURCE 路径注入的质量总量。
- [ ] 统计 SOURCE 路径注入的能量总量。
- [ ] 统计 SOURCE 路径注入的三向动量总量。
- [ ] 加固 SOURCE 源项应用后的 Gas summary 刷新。
- [ ] 加固 PHASE 转化后的 `particle_phase` 和 `material_id` 更新。
- [ ] 加固 PHASE 转化后的 `rho`、`volume` 和 `internal_energy` 更新。
- [ ] 加固 PHASE 转化后的 Gas pressure 刷新。
- [ ] 加固 PHASE 转化后的 Gas summary 刷新。
- [ ] 保持已转化 Gas 粒子的 Explosive 历史状态可追踪。
- [ ] 新增 Water/Gas/Explosive 混合 smoke 显式推进测试。
- [ ] 新增 SOURCE target material 测试并接入 CTest。
- [ ] 新增 PHASE 状态刷新测试并接入 CTest。
- [ ] 在 summary CSV 中追加 release balance 字段。
- [ ] 在粒子 CSV 中追加 Explosive 反应质量和剩余质量字段。
- [ ] 更新 output 测试以锁定 0.4.1 CSV header 和 summary 字段。
## 阶段 E:Restart、API、C++、Python 与 CLI
- [ ] 将 restart 状态版本更新为 `STATE_0_4_1`。
- [ ] 将 Explosive 反应质量基准写入 0.4.1 restart。
- [ ] 将 release balance 相关状态写入 0.4.1 restart。
- [ ] 将 SOURCE/PHASE 诊断计数写入 0.4.1 restart。
- [ ] 从 0.4.1 restart 读回反应质量基准。
- [ ] 从 0.4.1 restart 读回 release balance 相关状态。
- [ ] 从 0.4.0 restart 读回时初始化新增 0.4.1 状态。
- [ ] 从 0.3.1 restart 读回时保持空 Explosive 状态。
- [ ] 新增 restart 后继续推进不重复释放测试。
- [ ] 新增 `sph_get_explosive_release_balance` Fortran API。
- [ ] 新增 `sphlite_get_explosive_release_balance` C ABI。
- [ ] 在 C ABI 中补齐新增接口的空指针错误路径。
- [ ] 在 C API 测试中覆盖 release balance 查询。
- [ ] 在 C++ wrapper 中增加 release balance 薄包装。
- [ ] 在 C++ API 测试中覆盖 release balance 薄包装。
- [ ] 在 Python ctypes 中增加 release balance 薄包装。
- [ ] 在 Python checker 中覆盖多点点火和 release balance。
- [ ] 在 CLI inspect/run 中追加 release balance 字段。
- [ ] 在 CLI checker 中覆盖多点点火、多材料和 release balance 字段。
- [ ] 新增 0.4.1 restart/API/CLI/Python 专项 CTest 条目。
## 阶段 F:回归、门禁、文档同步与发布准备
- [ ] 新增 `input_explosive_multi_ignition` 测试并接入 CTest。
- [ ] 新增 `input_explosive_multimaterial` 测试并接入 CTest。
- [ ] 新增 `explosive_initial_mass_release` 测试并接入 CTest。
- [ ] 新增 `explosive_release_balance` 测试并接入 CTest。
- [ ] 新增 `explosive_source_targeting` 测试并接入 CTest。
- [ ] 新增 `explosive_phase_refresh` 测试并接入 CTest。
- [ ] 新增 `explosive_restart_041` 测试并接入 CTest。
- [ ] 新增 `explosive_restart_040_compat` 测试并接入 CTest。
- [ ] 新增 `explosive_restart_no_double_release` 测试并接入 CTest。
- [ ] 新增 `explosive_water_gas_smoke` 测试并接入 CTest。
- [ ] 新增 `explosive_release_c_api` 测试并接入 CTest。
- [ ] 新增 `explosive_release_python` 测试并接入 CTest。
- [ ] 新增 `explosive_release_cli` 测试并接入 CTest。
- [ ] 新增 `explosive_041_source_size` 检查项并接入 CTest。
- [ ] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。
- [ ] 保持 0.4.0 完整 gate 全部通过。
- [ ] 单独运行 0.4.1 新增 Explosive gate。
- [ ] 运行 `source_size` 检查并确认无新增无理由例外。
- [ ] 运行 `git diff --check` 并清理空白问题。
- [ ] 更新 README、06、09 和 11 号文档的 0.4.1 测试和验收记录。