11 KiB
11 KiB
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 基线、计划复核和版本边界
- 确认当前 git 工作区状态并记录已有未提交内容。
- 确认
v0.7.0标签和远端发布提交可作为 0.7.1 开发基线。 - 检查
docs/v7.1_development_plan.md是否已补入仓库。 - 若
docs/v7.1_development_plan.md仍缺失,在本清单顶部保留复核提示。 - 若
docs/v7.1_development_plan.md已补入,逐条比对并修正本清单范围。 - 确认 0.7.1 定位为局部爆炸稳定化版本,而不是 0.8 耦合版本。
- 确认 0.7.1 不交付真实 FEM-SPH 接触耦合或连续体耦合。
- 确认 0.7.1 不交付工程级船舱水下接触爆炸 benchmark。
- 将核心 Fortran 版本号更新为
0.7.1。 - 将 CMake 项目版本更新为
0.7.1。 - 更新 Fortran smoke 测试中的版本期望。
- 更新 C API 测试中的版本期望。
- 更新 C++ API 测试中的版本期望。
- 更新 Python debug 测试中的版本期望。
- 更新 CLI
--version和 inspect 版本期望。 - 更新 README 当前开发版本为
0.7.1。 - 在 README 中说明 0.7.1 的局部爆炸稳定化范围。
- 在 README 中说明 0.7.1 的不交付边界。
- 准备 0.7.1 release gate 的初始测试名称清单。
- 准备阶段 A 本地提交说明。
阶段 B:blast region 输入稳定化和多区域控制
- 复核现有
*SPHLITE BLAST REGION关键词字段。 - 明确 0.7.1 多 blast region 的输入语义。
- 明确 blast region 名称唯一性规则。
- 明确重复 blast region 名称的 error 路径。
- 明确 blast region 最大数量超过上限的 error 路径。
- 明确
ENABLED或等价启停字段的默认值。 - 明确源 phase 默认值仍保持 0.7.0 行为。
- 明确目标 phase 默认值仍保持 0.7.0 行为。
- 明确
TARGET SET缺失时继续报 error。 - 明确空 target set 的 warning 或 no-op 规则。
- 明确中心坐标必须为有限值。
- 明确半径必须为正有限值。
- 明确载荷比例系数必须为有限值。
- 明确时间窗必须为非负有限值。
- 明确未知 source phase 的 error 路径。
- 明确未知 target phase 的 error 路径。
- 明确未知 projection mode 的 error 路径。
- 支持同一输入文件中读取多个 blast region。
- 保持单 region 0.7.0 输入样例兼容。
- 新增
input_blast_multiregion测试。 - 新增
input_blast_region_errors_071测试。 - 将 0.7.1 blast 输入测试接入 CTest。
- 准备阶段 B 本地提交说明。
阶段 C:源项快照、目标筛选和多区域诊断
- 复核现有 blast source snapshot 数据结构。
- 确认 source snapshot 按 region 独立刷新。
- 统计每个 region 内 active Water 源粒子数量。
- 统计每个 region 内 active Gas 源粒子数量。
- 统计每个 region 内 active Explosive 源粒子数量。
- 统计每个 region 内源粒子总质量。
- 统计每个 region 内源粒子总能量。
- 统计每个 region 内 Water 压力范围。
- 统计每个 region 内 Gas 总体积。
- 统计每个 region 内 Explosive 平均反应进度。
- 对 region 外源粒子执行跳过计数。
- 对非 active 源粒子执行跳过计数。
- 对不匹配 source phase 的粒子执行跳过计数。
- 确认无源粒子时返回安全默认诊断。
- 复核现有 blast target 筛选规则。
- 确认 target 筛选按 region 独立执行。
- 按 target set 筛选结构粒子。
- 按 target phase 筛选 Solid 和 Shell 粒子。
- 跳过 failed Solid 目标并记录计数。
- 跳过 failed Shell 目标并记录计数。
- 确认无目标粒子时返回安全默认诊断。
- 新增
blast_multiregion_snapshot测试。 - 新增
blast_multiregion_target_filter测试。 - 将源项和目标筛选测试接入 CTest。
- 准备阶段 C 本地提交说明。
阶段 D:结构载荷缓存、叠加和守恒诊断
- 复核现有 Solid 外载荷缓存数组布局。
- 复核现有 Shell 外载荷缓存数组布局。
- 确认每个显式步开始前清零 blast 外载荷缓存。
- 确认禁用 blast load 时缓存保持零值。
- 支持多个 blast region 对同一 Solid 目标载荷叠加。
- 支持多个 blast region 对同一 Shell 目标载荷叠加。
- 保持 Solid 和 Shell 外载荷缓存相互隔离。
- 保持 Water 粒子不被结构外载荷缓存污染。
- 保持 Gas 粒子不被结构外载荷缓存污染。
- 保持 Explosive 粒子不被结构外载荷缓存污染。
- 统一距离权重归一化的零分母处理。
- 统一非有限载荷贡献的跳过处理。
- 记录每个 region 的载荷目标数。
- 记录每个 region 的载荷 pair 数。
- 记录每个 region 的零权重 pair 数。
- 记录每个 region 的非有限贡献数。
- 记录每个 region 的总力。
- 记录每个 region 的 Solid 分力。
- 记录每个 region 的 Shell 分力。
- 记录每个 region 的冲量累计。
- 记录每个 region 的做功累计。
- 记录每个 region 的最大粒子力。
- 新增
blast_load_superposition测试。 - 新增
blast_load_diagnostics_071测试。 - 将结构载荷稳定化测试接入 CTest。
- 准备阶段 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 本地提交说明。