Files
SPHLite/todo.md
T
2026-07-03 12:11:47 +08:00

8.4 KiB
Raw Blame History

SPHLite TODO

当前目标版本:0.4.0

本文档依据 docs/v4.0_development_plan.md 拆分。0.4.0 定位为 Explosive 模块起步版本,目标是在 0.3.1 Gas 多材料、EOS 分派、源项缓存、扩展诊断和 restart 兼容基础上,建立炸药粒子的解析点火、爆轰到达时间、反应进度和向 Gas 释放质量、动量、能量的最小闭环。

所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.4.0 不实现 Solid、Shell、真实 FEM-SPH 耦合、工程级水下爆炸 benchmark、完整化学反应爆轰模型或球面经验载荷主模型。

执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端。

阶段 A:版本基线、范围声明与输入样例

  • 确认当前 git 状态并记录 0.4.0 开发起点。
  • 确认 0.3.1 最终提交可作为 0.4.0 开发基线。
  • 将核心软件版本更新为 0.4.0。
  • 将 CMake 项目版本更新为 0.4.0。
  • 更新 Fortran smoke 测试中的版本期望。
  • 更新 C API 测试中的版本期望。
  • 更新 C++ API 测试中的版本期望。
  • 更新 Python debug 测试中的版本期望。
  • 更新 CLI --version 和 inspect 版本期望。
  • 在 README 中记录 0.4.0 Explosive 起步版本定位。
  • 创建最小 TYPE=EXPLOSIVE material 输入样例。
  • 创建 explosive section 绑定炸药粒子的输入样例。
  • 创建 product Gas material 使用 JWL EOS 的输入样例。
  • 创建 *SPHLITE EXPLOSIVE programmed burn 控制输入样例。
  • 创建 *SPHLITE IGNITION 单点点火输入样例。
  • 创建 CONVERSION=PHASE 的炸药到 Gas 转化输入样例。
  • 创建 CONVERSION=SOURCE 的 Gas 源项注入输入样例。
  • 创建爆速为非法值的错误输入样例。
  • 创建 product Gas material 缺失或非法的错误输入样例。
  • 创建点火字段缺失或非法的错误输入样例。

阶段 B:Explosive 输入解析、材料控制与校验

  • 为 TYPE=EXPLOSIVE material 增加输入识别路径。
  • 为 explosive material 数量增加集中式统计字段。
  • 为 explosive material 内部 id 增加存储字段。
  • 为 explosive material 名称增加存储字段。
  • 为 explosive 初始密度增加 material 级存储字段。
  • 为 explosive 爆速增加 material 级存储字段。
  • 为 explosive 单位质量能量增加 material 级存储字段。
  • 为 explosive 反应时间窗口增加 material 级存储字段。
  • 为 explosive product Gas material 映射增加存储字段。
  • 为 explosive conversion mode 增加存储字段。
  • 增加 explosive material 状态表初始化过程。
  • 增加 explosive material 状态表清理过程。
  • 增加按 material 名称查找 explosive material id 的过程。
  • 将 *SPHLITE EXPLOSIVE 解析结果绑定到 explosive material。
  • 将 *SPHLITE IGNITION 解析结果绑定到 explosive material。
  • 对 explosive material 缺失 *DENSITY 的输入报 error。
  • 对 explosive material 缺失 *SPHLITE EXPLOSIVE 的输入报 error。
  • 对 explosive section 未绑定 active 粒子的输入报 warning。
  • 对 product material 不是 Gas material 的输入报 error。
  • 对 product Gas material 缺失 EOS 的输入报 error。

阶段 C:Explosive 模块状态、点火与爆轰到达时间

  • 新增 src/explosive 模块目录和 Fortran 源文件骨架。
  • 将 Explosive 源文件接入 CMake 构建列表。
  • 增加 sph_explosive_reset 生命周期入口。
  • 增加 sph_explosive_build 模型构建入口。
  • 增加 sph_explosive_finalize 或清理入口。
  • 为每粒子爆轰到达时间增加状态数组。
  • 为每粒子反应进度 lambda 增加状态数组。
  • 为每粒子累计释放质量增加状态数组。
  • 为每粒子累计释放能量增加状态数组。
  • 为每粒子累计释放动量增加状态数组。
  • 为每粒子 ignition status 增加状态数组。
  • 增加 Explosive 状态数组分配过程。
  • 增加 Explosive 状态数组清零过程。
  • 增加 Explosive active 粒子筛选过程。
  • 增加单点点火记录的内部设置过程。
  • 增加多点点火记录的状态预留和清理过程。
  • 实现按初始坐标计算单点爆轰到达时间。
  • 实现多点点火到达时间取最小值的预留路径。
  • 增加爆轰到达时间范围诊断过程。
  • 增加爆轰到达时间模块测试并接入 CTest。

阶段 D:反应进度、释放量、Gas 源项与 phase 转化

  • 实现 programmed burn 反应进度目标值计算。
  • 实现 burn_time = 0 的瞬时反应路径。
  • 实现 burn_time > 0 的线性反应窗口路径。
  • 保证 lambda 被限制在 [0,1] 范围内。
  • 保证 lambda 单调不可逆增加。
  • 计算每步 delta_lambda 反应增量。
  • 按 delta_lambda * mass_initial 计算释放质量。
  • 按释放质量和单位质量能量计算释放能量。
  • 按释放质量和当前速度计算释放动量。
  • 将释放质量累计到 Explosive 诊断状态。
  • 将释放能量累计到 Explosive 诊断状态。
  • 将释放动量累计到 Explosive 诊断状态。
  • 实现 CONVERSION=SOURCE 到 Gas 源项缓存的注入路径。
  • 实现 CONVERSION=PHASE 的完全反应后 phase 转化路径。
  • 将完全反应粒子的 material 改为 product Gas material。
  • 在 phase 转化后刷新 Gas 压力和 summary。
  • 对无法确定目标 Gas 状态的 source 注入路径报 error。
  • 将 Explosive 更新挂接到显式求解器步骤中。
  • 增加反应时间步约束诊断或预留字段。
  • 确认无 Explosive 输入时 Water/Gas 算例不进入 Explosive 更新路径。

阶段 E:Summary、Output、Restart、API、C++、Python 与 CLI

  • 增加 Explosive summary 内部统计过程。
  • 统计 explosive 粒子总数和已反应粒子数。
  • 统计 lambda 最小值、最大值和平均值。
  • 统计累计释放质量、能量和三向动量。
  • 统计爆轰到达时间最小值和最大值。
  • 将 Explosive summary 字段写入 summary CSV。
  • 将 Explosive 关键粒子状态写入粒子 CSV 输出。
  • 将 0.4.0 restart 状态版本更新为 STATE_0_4。
  • 将 Explosive material 表写入 0.4.0 restart。
  • 将 product Gas material 映射写入 0.4.0 restart。
  • 将点火记录写入 0.4.0 restart。
  • 将每粒子爆轰到达时间写入 0.4.0 restart。
  • 将每粒子反应进度和累计释放量写入 0.4.0 restart。
  • 从 0.4.0 restart 读回 Explosive 状态并继续显式步。
  • 从 0.3.1 restart 读回时初始化空 Explosive 状态。
  • 增加 sph_get_explosive_summary Fortran API。
  • 增加 sph_set_ignition_point Fortran API。
  • 在 C ABI 中追加点火点设置和 Explosive summary 查询接口。
  • 在 C++ wrapper 和 Python ctypes 中增加 Explosive 薄包装。
  • 在 CLI inspect/run 中增加 Explosive 字段检查。

阶段 F:测试接入、回归、文档同步与发布门禁

  • 新增 input_explosive 测试并接入 CTest。
  • 新增 input_explosive_errors 测试并接入 CTest。
  • 新增 explosive_detonation_time 测试并接入 CTest。
  • 新增 explosive_reaction_progress 测试并接入 CTest。
  • 新增 explosive_release_source 测试并接入 CTest。
  • 新增 explosive_to_gas_phase 测试并接入 CTest。
  • 新增 explosive_gas_coupling 测试并接入 CTest。
  • 新增 explosive_summary 测试并接入 CTest。
  • 新增 explosive_restart_040 测试并接入 CTest。
  • 新增 explosive_restart_031_compat 测试并接入 CTest。
  • 新增 explosive_c_api 测试并接入 CTest。
  • 新增 explosive_python 测试并接入 CTest。
  • 新增 explosive_cli 测试并接入 CTest。
  • 新增 explosive_source_size 测试或检查项并接入 CTest。
  • 复核 tests/source_size_exceptions.txt 中 stale 例外。
  • 保持 0.3.1 默认 gate 全部通过。
  • 单独运行 0.4.0 新增 Explosive gate。
  • 运行 source_size 检查并确认无新增无理由例外。
  • 运行 git diff --check 并清理空白问题。
  • 更新 README、06、09 和 11 号文档的 0.4.0 测试和验收记录。