8.4 KiB
8.4 KiB
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=EXPLOSIVEmaterial 输入样例。 - 创建 explosive section 绑定炸药粒子的输入样例。
- 创建 product Gas material 使用 JWL EOS 的输入样例。
- 创建
*SPHLITE EXPLOSIVEprogrammed burn 控制输入样例。 - 创建
*SPHLITE IGNITION单点点火输入样例。 - 创建
CONVERSION=PHASE的炸药到 Gas 转化输入样例。 - 创建
CONVERSION=SOURCE的 Gas 源项注入输入样例。 - 创建爆速为非法值的错误输入样例。
- 创建 product Gas material 缺失或非法的错误输入样例。
- 创建点火字段缺失或非法的错误输入样例。
阶段 B:Explosive 输入解析、材料控制与校验
- 为
TYPE=EXPLOSIVEmaterial 增加输入识别路径。 - 为 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_summaryFortran API。 - 增加
sph_set_ignition_pointFortran 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 测试和验收记录。