148 lines
8.6 KiB
Markdown
148 lines
8.6 KiB
Markdown
# 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 测试和验收记录。
|