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

8.6 KiB
Raw Blame History

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:版本基线、范围声明与输入样例

  • 确认当前 git 状态并记录 0.4.1 开发起点。
  • 确认 v0.4.0 标签和发布提交可作为 0.4.1 开发基线。
  • 将核心软件版本更新为 0.4.1。
  • 将 CMake 项目版本更新为 0.4.1。
  • 更新 Fortran smoke 测试中的版本期望。
  • 更新 C API 测试中的版本期望。
  • 更新 C++ API 测试中的版本期望。
  • 更新 Python debug 测试中的版本期望。
  • 更新 CLI --version 和 inspect 版本期望。
  • 在 README 中记录 0.4.1 Explosive 稳定化版本定位。
  • 创建多点点火正向输入样例。
  • 创建多点点火顺序反转输入样例。
  • 创建多点点火跨 material 输入样例。
  • 创建多 Explosive material 输入样例。
  • 创建多个 product Gas material 输入样例。
  • 创建 SOURCE 路径多 target Gas material 输入样例。
  • 创建 PHASE 路径 Gas 状态刷新输入样例。
  • 创建 Water/Gas/Explosive 混合 smoke 输入样例。
  • 创建 STATE_0_4 restart 兼容测试所需输入或夹具。
  • 创建缺少匹配点火记录的错误输入样例。

阶段 B:多点点火、多材料输入与校验

  • 复核 0.4.0 点火记录存储结构是否支持同一 material 多条记录。
  • 加固点火记录清理过程,确保重复初始化不会残留旧记录。
  • 加固点火记录 material 匹配逻辑。
  • 加固点火记录输入顺序无关逻辑。
  • 实现多点点火到达时间取最小值的显式测试路径。
  • 对缺少匹配点火记录的 explosive 粒子报 error。
  • 对点火时间为负值的输入保持 error。
  • 对点火坐标非法或缺失的输入保持 error。
  • 复核 Explosive material 注册过程支持多个炸药材料。
  • 复核 Explosive control 表支持每个 material 独立参数。
  • 复核 product Gas material 映射支持多个目标材料。
  • 校验不同 Explosive material 可使用不同爆速。
  • 校验不同 Explosive material 可使用不同单位质量能量。
  • 校验不同 Explosive material 可使用不同 burn time。
  • 校验不同 Explosive material 可使用不同 conversion mode。
  • 校验不同 Explosive material 可映射到相同 product Gas。
  • 校验不同 Explosive material 可映射到不同 product Gas。
  • 对 product Gas material 缺失 EOS 的多材料输入报 error。
  • 对无 active 粒子的 Explosive material 继续报 warning 而不阻止运行。
  • 新增多点点火和多材料输入模块测试并接入 CTest。

阶段 C:反应质量基准与释放量一致性

  • 新增每粒子 Explosive 反应质量基准状态。
  • 在 Explosive 状态分配过程中分配反应质量基准数组。
  • 在 Explosive 状态清理过程中清零反应质量基准数组。
  • 在模型构建阶段从当前粒子质量冻结反应质量基准。
  • 确认无 Explosive 输入时反应质量基准不影响 Water/Gas 算例。
  • 将 SOURCE 路径释放质量改为使用冻结反应质量基准。
  • 将 PHASE 路径释放质量改为使用冻结反应质量基准。
  • 保持 delta_lambda 作为唯一释放增量来源。
  • 保持 lambda 单调不可逆并限制在 [0,1]。
  • 保持 burn_time = 0 的瞬时反应行为。
  • 保持 burn_time > 0 的线性反应窗口行为。
  • 计算每粒子剩余可反应质量。
  • 计算全局 Explosive 初始反应质量。
  • 计算全局 Explosive 累计释放质量。
  • 计算全局 Explosive 剩余可反应质量。
  • 计算释放质量闭合误差诊断。
  • 计算释放能量闭合误差诊断。
  • 计算三向释放动量合计诊断。
  • 新增初始质量释放一致性测试并接入 CTest。
  • 新增 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 测试和验收记录。