148 lines
8.4 KiB
Markdown
148 lines
8.4 KiB
Markdown
# 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:版本基线与输入样例
|
||
|
||
- [x] 确认当前 git 状态并记录 0.3.1 开发起点。
|
||
- [x] 确认 `v0.3.0` 标签和 0.3.0 发布提交可作为 0.3.1 基线。
|
||
- [x] 将核心软件版本更新为 `0.3.1`。
|
||
- [x] 将 CMake 项目版本更新为 `0.3.1`。
|
||
- [x] 更新 Fortran smoke 测试中的版本期望。
|
||
- [x] 更新 C API 测试中的版本期望。
|
||
- [x] 更新 C++ API 测试中的版本期望。
|
||
- [x] 更新 Python debug 测试中的版本期望。
|
||
- [x] 更新 CLI `--version` 和 inspect 版本期望。
|
||
- [x] 在 README 中记录 0.3.1 Gas 稳定化开发定位。
|
||
- [x] 创建空气类 `TYPE=GAS` 理想气体输入样例。
|
||
- [x] 创建爆轰产物类 `TYPE=GAS` JWL 输入样例。
|
||
- [x] 创建 `TYPE=GAS` Stiffened gas 输入样例。
|
||
- [x] 创建同一模型同时包含空气和爆轰产物 Gas material 的输入样例。
|
||
- [x] 创建同一模型包含三类 Gas EOS 的输入样例。
|
||
- [x] 创建多个 Gas section 绑定不同 Gas material 的输入样例。
|
||
- [x] 创建 Gas material 没有关联 active 粒子的 warning 输入样例。
|
||
- [x] 创建某个 Gas material 缺失 `*DENSITY` 的错误输入样例。
|
||
- [x] 创建某个 Gas material 缺失 `*SPHLITE EOS` 的错误输入样例。
|
||
- [x] 创建 `*SPHLITE EOS` 引用不存在 material 的错误输入样例。
|
||
|
||
## 阶段 B:Gas 多材料输入解析与状态表
|
||
|
||
- [x] 为 Gas material 数量增加集中式统计字段。
|
||
- [x] 为 Gas material 内部 id 增加存储字段。
|
||
- [x] 为 Gas material 名称增加存储字段。
|
||
- [x] 为 Gas material EOS 类型增加存储字段。
|
||
- [x] 为 Gas material 密度默认值增加存储字段。
|
||
- [x] 为 Gas material 内能默认值增加存储字段。
|
||
- [x] 为 Gas material 温度默认值增加存储字段。
|
||
- [x] 为理想气体 EOS 增加 material 级参数表。
|
||
- [x] 为 JWL EOS 增加 material 级参数表。
|
||
- [x] 为 Stiffened gas EOS 增加 material 级参数表。
|
||
- [x] 增加 Gas material 状态表初始化过程。
|
||
- [x] 增加 Gas material 状态表清理过程。
|
||
- [x] 增加按 material 名称查找 Gas material id 的过程。
|
||
- [x] 将 `*MATERIAL, TYPE=GAS` 解析结果注册到 Gas material 状态表。
|
||
- [x] 将 `*SPHLITE EOS, MATERIAL=...` 解析结果绑定到对应 Gas material。
|
||
- [x] 对同一 Gas material 重复定义 EOS 的输入报 error。
|
||
- [x] 对非 Gas material 定义 Gas EOS 的输入报 error。
|
||
- [x] 对 Gas material 缺失 EOS 的输入报 error。
|
||
- [x] 对 Gas material 无 active 粒子的输入报 warning。
|
||
- [x] 保持 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 耦合。
|