Files
SPHLite/todo.md
T
2026-07-03 10:45:32 +08:00

8.4 KiB
Raw Blame History

SPHLite TODO

当前目标版本:0.3.1

本文档依据 docs/v3.1_development_plan.md 拆分。0.3.1 定位为 Gas 模块稳定化和前置加固版本,目标是在 0.3.0 Gas 最小闭环基础上,补强多 Gas material/EOS、Gas 源项占位、诊断一致性、restart 兼容性、接口覆盖和 release gate 可维护性。

所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.3.1 不实现 Explosive 解析点火、爆轰传播、反应进度、炸药 phase 迁移、Solid/Shell 生产求解路径或真实 FEM-SPH 耦合。

执行约定:每完成 20 个待办事项,进行一次本地 git 提交,暂不推送远端。

阶段 A:版本基线与输入样例

  • 确认当前 git 状态并记录 0.3.1 开发起点。
  • 确认 v0.3.0 标签和 0.3.0 发布提交可作为 0.3.1 基线。
  • 将核心软件版本更新为 0.3.1。
  • 将 CMake 项目版本更新为 0.3.1。
  • 更新 Fortran smoke 测试中的版本期望。
  • 更新 C API 测试中的版本期望。
  • 更新 C++ API 测试中的版本期望。
  • 更新 Python debug 测试中的版本期望。
  • 更新 CLI --version 和 inspect 版本期望。
  • 在 README 中记录 0.3.1 Gas 稳定化开发定位。
  • 创建空气类 TYPE=GAS 理想气体输入样例。
  • 创建爆轰产物类 TYPE=GAS JWL 输入样例。
  • 创建 TYPE=GAS Stiffened gas 输入样例。
  • 创建同一模型同时包含空气和爆轰产物 Gas material 的输入样例。
  • 创建同一模型包含三类 Gas EOS 的输入样例。
  • 创建多个 Gas section 绑定不同 Gas material 的输入样例。
  • 创建 Gas material 没有关联 active 粒子的 warning 输入样例。
  • 创建某个 Gas material 缺失 *DENSITY 的错误输入样例。
  • 创建某个 Gas material 缺失 *SPHLITE EOS 的错误输入样例。
  • 创建 *SPHLITE EOS 引用不存在 material 的错误输入样例。

阶段 B:Gas 多材料输入解析与状态表

  • 为 Gas material 数量增加集中式统计字段。
  • 为 Gas material 内部 id 增加存储字段。
  • 为 Gas material 名称增加存储字段。
  • 为 Gas material EOS 类型增加存储字段。
  • 为 Gas material 密度默认值增加存储字段。
  • 为 Gas material 内能默认值增加存储字段。
  • 为 Gas material 温度默认值增加存储字段。
  • 为理想气体 EOS 增加 material 级参数表。
  • 为 JWL EOS 增加 material 级参数表。
  • 为 Stiffened gas EOS 增加 material 级参数表。
  • 增加 Gas material 状态表初始化过程。
  • 增加 Gas material 状态表清理过程。
  • 增加按 material 名称查找 Gas material id 的过程。
  • 将 *MATERIAL, TYPE=GAS 解析结果注册到 Gas material 状态表。
  • 将 *SPHLITE EOS, MATERIAL=... 解析结果绑定到对应 Gas material。
  • 对同一 Gas material 重复定义 EOS 的输入报 error。
  • 对非 Gas material 定义 Gas EOS 的输入报 error。
  • 对 Gas material 缺失 EOS 的输入报 error。
  • 对 Gas material 无 active 粒子的输入报 warning。
  • 保持 0.3.0 单 Gas material 输入兼容通过。

阶段 C:EOS 分派、状态初始化与时间步

  • 将 Gas 压力更新改为按粒子 material_id 分派 EOS。
  • 为理想气体压力更新增加 material 级分派测试。
  • 为 JWL 压力更新增加 material 级分派测试。
  • 为 Stiffened gas 压力更新增加 material 级分派测试。
  • 增加空气和爆轰产物混合输入的逐粒子压力检查。
  • 对 Gas 粒子 material 无 EOS 的状态更新路径报 error。
  • 将 Gas 初始密度设置改为按 material 分派。
  • 将 Gas 初始内能设置改为按 material 分派。
  • 将 Gas 初始温度设置改为按 material 分派。
  • 将 Gas 初始压力设置改为按 material EOS 计算。
  • 将 Gas 默认质量控制策略改为按 material 或共享策略处理。
  • 将 Gas 默认体积控制策略改为按 material 或共享策略处理。
  • 将 Gas 默认光滑长度策略改为按 material 或共享策略处理。
  • 将 Gas 外部体力策略保持为共享路径并补充混合材料测试。
  • 将 Gas 声速估计改为按 material/EOS 分派。
  • 将 Gas CFL 时间步限制改为记录 gas_dt_cfl。
  • 将 Gas 加速度时间步限制改为记录 gas_dt_accel。
  • 将 Gas 临界时间步取值改为使用各分量最小值。
  • 增加混合 Gas material 的时间步估计测试。
  • 确认 Water 时间步和 pressure wave smoke 行为未被 Gas 改动影响。

阶段 D:Gas 源项占位、诊断与输出

  • 增加 gas_mass_source(:) 状态数组。
  • 增加 gas_energy_source(:) 状态数组。
  • 增加 gas_momentum_source(:,:) 状态数组。
  • 在粒子数量变化或模型初始化时分配 Gas 源项数组。
  • 在模型清理时释放 Gas 源项数组。
  • 实现 sph_gas_clear_sources 内部过程。
  • 实现 sph_gas_add_source_by_particle 内部过程。
  • 实现 sph_gas_apply_sources_explicit 内部过程。
  • 实现 sph_gas_get_source_summary 内部过程。
  • 对非法粒子 id 添加 Gas 源项时报 error。
  • 对非 Gas 粒子添加 Gas 源项时报 error。
  • 对非法数值源项添加 Gas 源项时报 error。
  • 增加 Gas 质量源项累计和清零测试。
  • 增加 Gas 动量源项累计和清零测试。
  • 增加 Gas 能量源项累计和清零测试。
  • 增加 Gas 源项显式应用后质量变化测试。
  • 增加 Gas 源项显式应用后速度或动量变化测试。
  • 增加 Gas 源项显式应用后内能或能量变化测试。
  • 扩展 Gas summary,输出动量和密度范围。
  • 扩展 Gas output,输出稳定的 0.3.1 诊断字段。

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

  • 设计 0.3.1 restart 的 Gas state revision 标识。
  • 将 Gas material/EOS 表写入 0.3.1 restart。
  • 将 Gas 默认粒子控制状态写入 0.3.1 restart。
  • 将 Gas 外部体力状态写入 0.3.1 restart。
  • 将 Gas 源项缓存写入 0.3.1 restart。
  • 将 Gas dt 诊断写入 0.3.1 restart。
  • 将 Gas bubble metrics 历史状态写入 0.3.1 restart。
  • 从 0.3.1 restart 读回 Gas material/EOS 表。
  • 从 0.3.1 restart 读回 Gas 源项缓存。
  • 从 0.3.1 restart 读回后重建邻域并继续显式步。
  • 增加读取 0.3.0 STATE_0_3 restart 的兼容路径。
  • 为 0.3.0 restart 缺失的 Gas material 表初始化默认值。
  • 为 0.3.0 restart 缺失的 Gas 源项状态初始化零值。
  • 增加 sph_get_gas_extended_summary Fortran API。
  • 增加 sph_get_gas_source_summary Fortran API。
  • 在 C ABI 中追加 Gas extended summary 查询接口。
  • 在 C ABI 中追加 Gas source summary 查询接口。
  • 在 C++ wrapper 中增加 Gas extended/source summary 薄包装。
  • 在 Python ctypes 中增加 Gas extended/source summary 薄包装。
  • 在 CLI inspect/run 中增加 0.3.1 Gas 扩展字段检查。

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

  • 新增 input_gas_multimaterial 测试并接入 CTest。
  • 新增 gas_eos_dispatch 测试并接入 CTest。
  • 新增 gas_source 测试并接入 CTest。
  • 新增 gas_source_errors 测试并接入 CTest。
  • 新增 gas_extended_summary 测试并接入 CTest。
  • 新增 gas_restart_031 测试并接入 CTest。
  • 新增 gas_restart_030_compat 测试并接入 CTest。
  • 新增 gas_cli_extended 测试并接入 CTest。
  • 新增 gas_python_extended 测试并接入 CTest。
  • 新增 gas_source_size_cleanup 测试或检查项并接入 CTest。
  • 复核 tests/source_size_exceptions.txt 中 stale 例外。
  • 拆分因 0.3.1 改动变长的 Fortran 过程。
  • 保持 0.3.0 默认 gate 全部通过。
  • 单独运行 0.3.1 新增 Gas 稳定化 gate。
  • 运行 source_size 检查并确认无新增无理由例外。
  • 运行 git diff --check 并清理空白问题。
  • 更新 docs/06_test_and_verification_plan.md 的 0.3.1 测试范围。
  • 更新 docs/09_release_history.md 的 0.3.1 待发布记录。
  • 更新 docs/11_benchmark_matrix.md 的 0.3.1 验收矩阵。
  • 确认文档未宣称 0.3.1 已实现 Explosive、Solid、Shell 或真实 FEM-SPH 耦合。