8.6 KiB
8.6 KiB
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_4restart 兼容测试所需输入或夹具。 - 创建缺少匹配点火记录的错误输入样例。
阶段 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_balanceFortran API。 - 新增
sphlite_get_explosive_release_balanceC 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 测试和验收记录。