Files
SPHLite/todo.md
T
2026-07-03 12:53:34 +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.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:版本基线、范围声明与输入样例
- [x] 确认当前 git 状态并记录 0.4.0 开发起点。
- [x] 确认 0.3.1 最终提交可作为 0.4.0 开发基线。
- [x] 将核心软件版本更新为 `0.4.0`。
- [x] 将 CMake 项目版本更新为 `0.4.0`。
- [x] 更新 Fortran smoke 测试中的版本期望。
- [x] 更新 C API 测试中的版本期望。
- [x] 更新 C++ API 测试中的版本期望。
- [x] 更新 Python debug 测试中的版本期望。
- [x] 更新 CLI `--version` 和 inspect 版本期望。
- [x] 在 README 中记录 0.4.0 Explosive 起步版本定位。
- [x] 创建最小 `TYPE=EXPLOSIVE` material 输入样例。
- [x] 创建 explosive section 绑定炸药粒子的输入样例。
- [x] 创建 product Gas material 使用 JWL EOS 的输入样例。
- [x] 创建 `*SPHLITE EXPLOSIVE` programmed burn 控制输入样例。
- [x] 创建 `*SPHLITE IGNITION` 单点点火输入样例。
- [x] 创建 `CONVERSION=PHASE` 的炸药到 Gas 转化输入样例。
- [x] 创建 `CONVERSION=SOURCE` 的 Gas 源项注入输入样例。
- [x] 创建爆速为非法值的错误输入样例。
- [x] 创建 product Gas material 缺失或非法的错误输入样例。
- [x] 创建点火字段缺失或非法的错误输入样例。
## 阶段 B:Explosive 输入解析、材料控制与校验
- [x] 为 `TYPE=EXPLOSIVE` material 增加输入识别路径。
- [x] 为 explosive material 数量增加集中式统计字段。
- [x] 为 explosive material 内部 id 增加存储字段。
- [x] 为 explosive material 名称增加存储字段。
- [x] 为 explosive 初始密度增加 material 级存储字段。
- [x] 为 explosive 爆速增加 material 级存储字段。
- [x] 为 explosive 单位质量能量增加 material 级存储字段。
- [x] 为 explosive 反应时间窗口增加 material 级存储字段。
- [x] 为 explosive product Gas material 映射增加存储字段。
- [x] 为 explosive conversion mode 增加存储字段。
- [x] 增加 explosive material 状态表初始化过程。
- [x] 增加 explosive material 状态表清理过程。
- [x] 增加按 material 名称查找 explosive material id 的过程。
- [x] 将 `*SPHLITE EXPLOSIVE` 解析结果绑定到 explosive material。
- [x] 将 `*SPHLITE IGNITION` 解析结果绑定到 explosive material。
- [x] 对 explosive material 缺失 `*DENSITY` 的输入报 error。
- [x] 对 explosive material 缺失 `*SPHLITE EXPLOSIVE` 的输入报 error。
- [x] 对 explosive section 未绑定 active 粒子的输入报 warning。
- [x] 对 product material 不是 Gas material 的输入报 error。
- [x] 对 product Gas material 缺失 EOS 的输入报 error。
## 阶段 C:Explosive 模块状态、点火与爆轰到达时间
- [x] 新增 `src/explosive` 模块目录和 Fortran 源文件骨架。
- [x] 将 Explosive 源文件接入 CMake 构建列表。
- [x] 增加 `sph_explosive_reset` 生命周期入口。
- [x] 增加 `sph_explosive_build` 模型构建入口。
- [x] 增加 `sph_explosive_finalize` 或清理入口。
- [x] 为每粒子爆轰到达时间增加状态数组。
- [x] 为每粒子反应进度 `lambda` 增加状态数组。
- [x] 为每粒子累计释放质量增加状态数组。
- [x] 为每粒子累计释放能量增加状态数组。
- [x] 为每粒子累计释放动量增加状态数组。
- [x] 为每粒子 ignition status 增加状态数组。
- [x] 增加 Explosive 状态数组分配过程。
- [x] 增加 Explosive 状态数组清零过程。
- [x] 增加 Explosive active 粒子筛选过程。
- [x] 增加单点点火记录的内部设置过程。
- [x] 增加多点点火记录的状态预留和清理过程。
- [x] 实现按初始坐标计算单点爆轰到达时间。
- [x] 实现多点点火到达时间取最小值的预留路径。
- [x] 增加爆轰到达时间范围诊断过程。
- [x] 增加爆轰到达时间模块测试并接入 CTest。
## 阶段 D:反应进度、释放量、Gas 源项与 phase 转化
- [x] 实现 programmed burn 反应进度目标值计算。
- [x] 实现 `burn_time = 0` 的瞬时反应路径。
- [x] 实现 `burn_time > 0` 的线性反应窗口路径。
- [x] 保证 `lambda` 被限制在 `[0,1]` 范围内。
- [x] 保证 `lambda` 单调不可逆增加。
- [x] 计算每步 `delta_lambda` 反应增量。
- [x] 按 `delta_lambda * mass_initial` 计算释放质量。
- [x] 按释放质量和单位质量能量计算释放能量。
- [x] 按释放质量和当前速度计算释放动量。
- [x] 将释放质量累计到 Explosive 诊断状态。
- [x] 将释放能量累计到 Explosive 诊断状态。
- [x] 将释放动量累计到 Explosive 诊断状态。
- [x] 实现 `CONVERSION=SOURCE` 到 Gas 源项缓存的注入路径。
- [x] 实现 `CONVERSION=PHASE` 的完全反应后 phase 转化路径。
- [x] 将完全反应粒子的 material 改为 product Gas material。
- [x] 在 phase 转化后刷新 Gas 压力和 summary。
- [x] 对无法确定目标 Gas 状态的 source 注入路径报 error。
- [x] 将 Explosive 更新挂接到显式求解器步骤中。
- [x] 增加反应时间步约束诊断或预留字段。
- [x] 确认无 Explosive 输入时 Water/Gas 算例不进入 Explosive 更新路径。
## 阶段 E:Summary、Output、Restart、API、C++、Python 与 CLI
- [x] 增加 Explosive summary 内部统计过程。
- [x] 统计 explosive 粒子总数和已反应粒子数。
- [x] 统计 `lambda` 最小值、最大值和平均值。
- [x] 统计累计释放质量、能量和三向动量。
- [x] 统计爆轰到达时间最小值和最大值。
- [x] 将 Explosive summary 字段写入 summary CSV。
- [x] 将 Explosive 关键粒子状态写入粒子 CSV 输出。
- [x] 将 0.4.0 restart 状态版本更新为 `STATE_0_4`。
- [x] 将 Explosive material 表写入 0.4.0 restart。
- [x] 将 product Gas material 映射写入 0.4.0 restart。
- [x] 将点火记录写入 0.4.0 restart。
- [x] 将每粒子爆轰到达时间写入 0.4.0 restart。
- [x] 将每粒子反应进度和累计释放量写入 0.4.0 restart。
- [x] 从 0.4.0 restart 读回 Explosive 状态并继续显式步。
- [x] 从 0.3.1 restart 读回时初始化空 Explosive 状态。
- [x] 增加 `sph_get_explosive_summary` Fortran API。
- [x] 增加 `sph_set_ignition_point` Fortran API。
- [x] 在 C ABI 中追加点火点设置和 Explosive summary 查询接口。
- [x] 在 C++ wrapper 和 Python ctypes 中增加 Explosive 薄包装。
- [x] 在 CLI inspect/run 中增加 Explosive 字段检查。
## 阶段 F:测试接入、回归、文档同步与发布门禁
- [x] 新增 `input_explosive` 测试并接入 CTest。
- [x] 新增 `input_explosive_errors` 测试并接入 CTest。
- [x] 新增 `explosive_detonation_time` 测试并接入 CTest。
- [x] 新增 `explosive_reaction_progress` 测试并接入 CTest。
- [x] 新增 `explosive_release_source` 测试并接入 CTest。
- [x] 新增 `explosive_to_gas_phase` 测试并接入 CTest。
- [x] 新增 `explosive_gas_coupling` 测试并接入 CTest。
- [x] 新增 `explosive_summary` 测试并接入 CTest。
- [x] 新增 `explosive_restart_040` 测试并接入 CTest。
- [x] 新增 `explosive_restart_031_compat` 测试并接入 CTest。
- [x] 新增 `explosive_c_api` 测试并接入 CTest。
- [x] 新增 `explosive_python` 测试并接入 CTest。
- [x] 新增 `explosive_cli` 测试并接入 CTest。
- [x] 新增 `explosive_source_size` 测试或检查项并接入 CTest。
- [x] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。
- [x] 保持 0.3.1 默认 gate 全部通过。
- [x] 单独运行 0.4.0 新增 Explosive gate。
- [x] 运行 `source_size` 检查并确认无新增无理由例外。
- [x] 运行 `git diff --check` 并清理空白问题。
- [x] 更新 README、06、09 和 11 号文档的 0.4.0 测试和验收记录。