208 lines
11 KiB
Markdown
208 lines
11 KiB
Markdown
# SPHLite TODO
|
||
|
||
当前目标版本:0.7.1
|
||
|
||
本文档面向用户指定的 `docs/v7.1_development_plan.md`。当前仓库中暂未检出该计划文件;补入后应首先复核本清单,并按计划文件修正版本范围、gate 名称和不交付边界。
|
||
|
||
在 `docs/v7.1_development_plan.md` 缺失期间,本清单按 01-06 号文档、0.7.0 已发布边界、README 当前状态和 0.7.0 blast 实现现状拆分。0.7.1 暂定位为局部爆炸链路稳定化版本:在 0.7.0 小型 Water/Gas/Explosive/Solid/Shell smoke 起点之上,加固多 blast region、载荷叠加、诊断一致性、restart 边界和 release gate,不进入 0.8 FEM-SPH 接触耦合,也不宣称工程级水下接触爆炸响应。
|
||
|
||
所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。核心代码继续遵守 Fortran95 约束,C/C++/Python 接口只在语义冻结后再扩展。执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端,除非用户另行要求。
|
||
|
||
## 阶段 A:0.7.1 基线、计划复核和版本边界
|
||
|
||
- [x] 确认当前 git 工作区状态并记录已有未提交内容。
|
||
- [x] 确认 `v0.7.0` 标签和远端发布提交可作为 0.7.1 开发基线。
|
||
- [x] 检查 `docs/v7.1_development_plan.md` 是否已补入仓库。
|
||
- [x] 若 `docs/v7.1_development_plan.md` 仍缺失,在本清单顶部保留复核提示。
|
||
- [x] 若 `docs/v7.1_development_plan.md` 已补入,逐条比对并修正本清单范围。
|
||
- [x] 确认 0.7.1 定位为局部爆炸稳定化版本,而不是 0.8 耦合版本。
|
||
- [x] 确认 0.7.1 不交付真实 FEM-SPH 接触耦合或连续体耦合。
|
||
- [x] 确认 0.7.1 不交付工程级船舱水下接触爆炸 benchmark。
|
||
- [x] 将核心 Fortran 版本号更新为 `0.7.1`。
|
||
- [x] 将 CMake 项目版本更新为 `0.7.1`。
|
||
- [x] 更新 Fortran smoke 测试中的版本期望。
|
||
- [x] 更新 C API 测试中的版本期望。
|
||
- [x] 更新 C++ API 测试中的版本期望。
|
||
- [x] 更新 Python debug 测试中的版本期望。
|
||
- [x] 更新 CLI `--version` 和 inspect 版本期望。
|
||
- [x] 更新 README 当前开发版本为 `0.7.1`。
|
||
- [x] 在 README 中说明 0.7.1 的局部爆炸稳定化范围。
|
||
- [x] 在 README 中说明 0.7.1 的不交付边界。
|
||
- [x] 准备 0.7.1 release gate 的初始测试名称清单。
|
||
- [x] 准备阶段 A 本地提交说明。
|
||
|
||
## 阶段 B:blast region 输入稳定化和多区域控制
|
||
|
||
- [x] 复核现有 `*SPHLITE BLAST REGION` 关键词字段。
|
||
- [x] 明确 0.7.1 多 blast region 的输入语义。
|
||
- [x] 明确 blast region 名称唯一性规则。
|
||
- [x] 明确重复 blast region 名称的 error 路径。
|
||
- [x] 明确 blast region 最大数量超过上限的 error 路径。
|
||
- [x] 明确 `ENABLED` 或等价启停字段的默认值。
|
||
- [x] 明确源 phase 默认值仍保持 0.7.0 行为。
|
||
- [x] 明确目标 phase 默认值仍保持 0.7.0 行为。
|
||
- [x] 明确 `TARGET SET` 缺失时继续报 error。
|
||
- [x] 明确空 target set 的 warning 或 no-op 规则。
|
||
- [x] 明确中心坐标必须为有限值。
|
||
- [x] 明确半径必须为正有限值。
|
||
- [x] 明确载荷比例系数必须为有限值。
|
||
- [x] 明确时间窗必须为非负有限值。
|
||
- [x] 明确未知 source phase 的 error 路径。
|
||
- [x] 明确未知 target phase 的 error 路径。
|
||
- [x] 明确未知 projection mode 的 error 路径。
|
||
- [x] 支持同一输入文件中读取多个 blast region。
|
||
- [x] 保持单 region 0.7.0 输入样例兼容。
|
||
- [x] 新增 `input_blast_multiregion` 测试。
|
||
- [x] 新增 `input_blast_region_errors_071` 测试。
|
||
- [x] 将 0.7.1 blast 输入测试接入 CTest。
|
||
- [x] 准备阶段 B 本地提交说明。
|
||
|
||
## 阶段 C:源项快照、目标筛选和多区域诊断
|
||
|
||
- [x] 复核现有 blast source snapshot 数据结构。
|
||
- [x] 确认 source snapshot 按 region 独立刷新。
|
||
- [x] 统计每个 region 内 active Water 源粒子数量。
|
||
- [x] 统计每个 region 内 active Gas 源粒子数量。
|
||
- [x] 统计每个 region 内 active Explosive 源粒子数量。
|
||
- [x] 统计每个 region 内源粒子总质量。
|
||
- [x] 统计每个 region 内源粒子总能量。
|
||
- [x] 统计每个 region 内 Water 压力范围。
|
||
- [x] 统计每个 region 内 Gas 总体积。
|
||
- [x] 统计每个 region 内 Explosive 平均反应进度。
|
||
- [x] 对 region 外源粒子执行跳过计数。
|
||
- [x] 对非 active 源粒子执行跳过计数。
|
||
- [x] 对不匹配 source phase 的粒子执行跳过计数。
|
||
- [x] 确认无源粒子时返回安全默认诊断。
|
||
- [x] 复核现有 blast target 筛选规则。
|
||
- [x] 确认 target 筛选按 region 独立执行。
|
||
- [x] 按 target set 筛选结构粒子。
|
||
- [x] 按 target phase 筛选 Solid 和 Shell 粒子。
|
||
- [x] 跳过 failed Solid 目标并记录计数。
|
||
- [x] 跳过 failed Shell 目标并记录计数。
|
||
- [x] 确认无目标粒子时返回安全默认诊断。
|
||
- [x] 新增 `blast_multiregion_snapshot` 测试。
|
||
- [x] 新增 `blast_multiregion_target_filter` 测试。
|
||
- [x] 将源项和目标筛选测试接入 CTest。
|
||
- [x] 准备阶段 C 本地提交说明。
|
||
|
||
## 阶段 D:结构载荷缓存、叠加和守恒诊断
|
||
|
||
- [x] 复核现有 Solid 外载荷缓存数组布局。
|
||
- [x] 复核现有 Shell 外载荷缓存数组布局。
|
||
- [x] 确认每个显式步开始前清零 blast 外载荷缓存。
|
||
- [x] 确认禁用 blast load 时缓存保持零值。
|
||
- [x] 支持多个 blast region 对同一 Solid 目标载荷叠加。
|
||
- [x] 支持多个 blast region 对同一 Shell 目标载荷叠加。
|
||
- [x] 保持 Solid 和 Shell 外载荷缓存相互隔离。
|
||
- [x] 保持 Water 粒子不被结构外载荷缓存污染。
|
||
- [x] 保持 Gas 粒子不被结构外载荷缓存污染。
|
||
- [x] 保持 Explosive 粒子不被结构外载荷缓存污染。
|
||
- [x] 统一距离权重归一化的零分母处理。
|
||
- [x] 统一非有限载荷贡献的跳过处理。
|
||
- [x] 记录每个 region 的载荷目标数。
|
||
- [x] 记录每个 region 的载荷 pair 数。
|
||
- [x] 记录每个 region 的零权重 pair 数。
|
||
- [x] 记录每个 region 的非有限贡献数。
|
||
- [x] 记录每个 region 的总力。
|
||
- [x] 记录每个 region 的 Solid 分力。
|
||
- [x] 记录每个 region 的 Shell 分力。
|
||
- [x] 记录每个 region 的冲量累计。
|
||
- [x] 记录每个 region 的做功累计。
|
||
- [x] 记录每个 region 的最大粒子力。
|
||
- [x] 新增 `blast_load_superposition` 测试。
|
||
- [x] 新增 `blast_load_diagnostics_071` 测试。
|
||
- [x] 将结构载荷稳定化测试接入 CTest。
|
||
- [x] 准备阶段 D 本地提交说明。
|
||
|
||
## 阶段 E:Velocity-Verlet 接入、时间窗和响应回归
|
||
|
||
- [ ] 复核 blast load 在 Velocity-Verlet 显式步中的调用顺序。
|
||
- [ ] 确认 Explosive 更新早于 blast source snapshot。
|
||
- [ ] 确认 Gas 源项应用早于结构载荷投影。
|
||
- [ ] 确认 Water 压力更新早于结构载荷投影。
|
||
- [ ] 确认 Gas 压力更新早于结构载荷投影。
|
||
- [ ] 确认 blast load 只在时间窗内生效。
|
||
- [ ] 确认时间窗结束后外载荷缓存清零。
|
||
- [ ] 确认禁用 blast load 时完整显式步保持 no-op。
|
||
- [ ] 将 Solid blast 外载荷并入 Solid 加速度路径。
|
||
- [ ] 保持 Solid-only 无 blast 输入回归结果不变。
|
||
- [ ] 将 Shell blast 平动外载荷并入 Shell 受控入口。
|
||
- [ ] 保持 Shell director 不被 blast 外载荷非法修改。
|
||
- [ ] 保持 Shell 内力路径仍不宣称完整闭环。
|
||
- [ ] 验证 Solid/Shell 混合目标的载荷隔离。
|
||
- [ ] 验证多个 region 叠加后的 Solid 响应方向。
|
||
- [ ] 验证多个 region 叠加后的 Shell 响应方向。
|
||
- [ ] 验证 failed Solid 目标不产生响应。
|
||
- [ ] 验证 failed Shell 目标不产生响应。
|
||
- [ ] 验证 Water-only 模型不进入结构载荷路径。
|
||
- [ ] 验证 Gas-only 模型不进入结构载荷路径。
|
||
- [ ] 验证 Explosive-only 模型不进入结构载荷路径。
|
||
- [ ] 新增 `blast_solver_order_071` 测试。
|
||
- [ ] 新增 `blast_response_multiregion` 测试。
|
||
- [ ] 新增 `blast_noop_regression_071` 测试。
|
||
- [ ] 将显式推进回归测试接入 CTest。
|
||
- [ ] 准备阶段 E 本地提交说明。
|
||
|
||
## 阶段 F:输出、restart 边界和公开接口策略
|
||
|
||
- [ ] 复核 0.7.0 summary CSV blast 字段。
|
||
- [ ] 扩展 summary CSV 的多 region 输出规则。
|
||
- [ ] 保持单 region summary CSV 字段兼容。
|
||
- [ ] 为多 region 输出记录 region 数量。
|
||
- [ ] 为多 region 输出记录每个 region 的源粒子数量。
|
||
- [ ] 为多 region 输出记录每个 region 的目标粒子数量。
|
||
- [ ] 为多 region 输出记录每个 region 的总力。
|
||
- [ ] 为多 region 输出记录每个 region 的能量输入。
|
||
- [ ] 为多 region 输出记录每个 region 的跳过计数。
|
||
- [ ] 复核 particle CSV blast 外载荷字段。
|
||
- [ ] 确认 particle CSV 输出叠加后的粒子外载荷。
|
||
- [ ] 确认默认未开启输出时不生成临时结果文件。
|
||
- [ ] 明确 0.7.1 是否新增正式 blast restart state。
|
||
- [ ] 若不新增正式 state,保持 `STATE_0_7` 未冻结边界并补充测试。
|
||
- [ ] 若新增正式 state,保存 blast 控制、诊断和外载荷缓存。
|
||
- [ ] 若新增正式 state,验证读回后继续显式步一致。
|
||
- [ ] 保持既有 restart 兼容读入路径稳定。
|
||
- [ ] 明确 0.7.1 不新增公开 C ABI blast 稳定接口。
|
||
- [ ] 明确 0.7.1 不新增 C++ wrapper blast 稳定接口。
|
||
- [ ] 明确 0.7.1 不新增 Python blast 稳定接口。
|
||
- [ ] 保留 Fortran 内部 blast summary 查询入口。
|
||
- [ ] 新增 `blast_output_071` 测试。
|
||
- [ ] 新增 `blast_restart_boundary_071` 或 `blast_restart_071` 测试。
|
||
- [ ] 将输出和 restart 测试接入 CTest。
|
||
- [ ] 准备阶段 F 本地提交说明。
|
||
|
||
## 阶段 G:smoke、门禁、文档和发布准备
|
||
|
||
- [ ] 设计 0.7.1 多 region 局部爆炸 smoke 样例。
|
||
- [ ] 新增 Solid 多 region blast smoke 输入样例。
|
||
- [ ] 新增 Shell 多 region blast smoke 输入样例。
|
||
- [ ] 新增 Solid/Shell 混合多 region blast smoke 输入样例。
|
||
- [ ] 新增禁用 blast load 的 smoke 回归样例。
|
||
- [ ] 新增空 target set 或无 active target 的 smoke 样例。
|
||
- [ ] 验证 smoke 中所有粒子状态保持有限。
|
||
- [ ] 验证 smoke 中 Explosive 反应进度单调或受控。
|
||
- [ ] 验证 smoke 中 Gas 体积和压力诊断方向受控。
|
||
- [ ] 验证 smoke 中 Solid/Shell 载荷方向受控。
|
||
- [ ] 验证 smoke 中冲量和能量诊断为有限值。
|
||
- [ ] 新增 `blast_smoke_071` 测试。
|
||
- [ ] 运行 Water 回归 gate。
|
||
- [ ] 运行 Gas 回归 gate。
|
||
- [ ] 运行 Explosive 回归 gate。
|
||
- [ ] 运行 Solid 回归 gate。
|
||
- [ ] 运行 Shell 回归 gate。
|
||
- [ ] 运行 0.7.0 blast 回归 gate。
|
||
- [ ] 运行 0.7.1 blast 专项 gate。
|
||
- [ ] 运行完整 CTest。
|
||
- [ ] 运行 source size 相关 gate。
|
||
- [ ] 运行 `git diff --check`。
|
||
- [ ] 检查代码、构建脚本、测试和工具目录未新增 FEMLite 直接依赖。
|
||
- [ ] 检查输出目录、CSV、VTK、restart 和临时结果未被提交。
|
||
- [ ] 更新 `docs/06_test_and_verification_plan.md` 的 0.7.1 release gate。
|
||
- [ ] 更新 `docs/09_release_history.md` 的 0.7.1 本地验收记录。
|
||
- [ ] 更新 `docs/11_benchmark_matrix.md` 的 0.7.1 gate 矩阵。
|
||
- [ ] 更新 README 的 0.7.1 当前状态和不交付范围。
|
||
- [ ] 确认文档不宣称真实 FEM-SPH 联合运行。
|
||
- [ ] 确认文档不宣称工程级船舱破坏 benchmark。
|
||
- [ ] 准备 0.7.1 发布提交说明。
|
||
- [ ] 准备阶段 G 本地提交说明。
|