148 lines
8.4 KiB
Markdown
148 lines
8.4 KiB
Markdown
# 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 模块状态、点火与爆轰到达时间
|
||
|
||
- [ ] 新增 `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 测试和验收记录。
|