13 KiB
13 KiB
SPHLite TODO
当前目标版本:0.7.0
本文档面向用户指定的 docs/v7.0_development_plan.md。当前仓库中暂未检出该计划文件;待 docs/v7.0_development_plan.md 补入后,应先复核本文档。本清单暂按已发布的 0.6.1、01-06 号文档、docs/v6.1_development_plan.md 中的 0.7.0 后续路线拆分。0.7.0 暂定位为水-气-结构局部爆炸 smoke 起点,覆盖小型 Water/Gas/Explosive/Solid/Shell 链路。
所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.7.0 不交付真实工程级水下接触爆炸响应,不交付真实 FEM-SPH 接触耦合或连续体耦合,不交付工程级船舱破坏 benchmark,不交付复杂撕裂、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。
执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端。
阶段 A:版本基线、范围声明与 0.7.0 样例
- 确认当前 git 状态并记录已有未提交内容。
- 确认
v0.6.1标签和远端发布提交可作为 0.7.0 开发基线。 - 复核
docs/v7.0_development_plan.md是否已补入仓库。 - 若
docs/v7.0_development_plan.md缺失,在 todo 顶部保留复核提示。 - 将核心软件版本更新为
0.7.0。 - 将 CMake 项目版本更新为
0.7.0。 - 更新 Fortran smoke 测试中的版本期望。
- 更新 C API 测试中的版本期望。
- 更新 C++ API 测试中的版本期望。
- 更新 Python debug 测试中的版本期望。
- 更新 CLI
--version和 inspect 版本期望。 - 在 README 中记录 0.7.0 水-气-结构局部爆炸 smoke 定位。
- 在 README 中明确 0.7.0 不交付工程级爆炸响应。
- 在 README 中明确 0.7.0 不交付真实 FEM-SPH 耦合。
- 创建 Water/Gas/Explosive/Solid 最小混合输入样例。
- 创建 Water/Gas/Explosive/Shell 最小混合输入样例。
- 创建 Water/Gas/Explosive/Solid/Shell 混合输入样例。
- 创建无结构粒子的局部爆炸 smoke 输入样例。
- 创建无水粒子的 Gas/Explosive/Structure 错误或 warning 样例。
- 创建无 Gas product material 的 Explosive 错误输入样例。
- 创建结构载荷目标 set 缺失错误输入样例。
- 创建结构载荷半径非法错误输入样例。
- 创建结构载荷比例系数非有限错误输入样例。
- 创建 Shell-only 受控爆炸载荷诊断样例。
- 创建 Solid-only 受控爆炸载荷诊断样例。
- 创建 Solid/Shell 混合载荷隔离样例。
- 运行 0.6.1 完整 gate 并记录基线结果。
- 准备阶段 A 本地提交说明。
阶段 B:0.7.0 输入控制、结构目标和局部爆炸区域
- 设计 0.7.0 局部爆炸 smoke 的输入关键词边界。
- 优先复用既有 Abaqus 子集表达材料、section、set 和 element 信息。
- 定义 SPHLite 调试扩展关键词的最小集合。
- 设计局部爆炸区域名称、中心和半径字段。
- 设计结构载荷目标 set 或 elset 字段。
- 设计结构载荷源 phase 过滤字段。
- 设计结构载荷目标 phase 过滤字段。
- 设计压力载荷比例系数字段。
- 设计冲量或时间窗口控制字段。
- 设计载荷投影模式字段。
- 设计 Solid 和 Shell 目标共用的输入约定。
- 支持读取局部爆炸区域控制参数。
- 支持读取结构载荷目标集合名称。
- 支持读取源相过滤参数。
- 支持读取目标相过滤参数。
- 支持读取载荷比例系数。
- 支持读取载荷时间窗口。
- 支持读取载荷投影模式。
- 校验局部爆炸区域半径为正有限值。
- 校验载荷比例系数为有限值。
- 校验时间窗口为非负有限值。
- 校验源 phase 名称合法。
- 校验目标 phase 名称合法。
- 校验目标 set 存在。
- 对未被使用的局部爆炸控制项报 warning。
- 对 active 结构粒子缺失载荷控制保持 no-op。
- 新增
input_blast_region测试。 - 新增
input_blast_errors测试。 - 将输入控制测试接入 CTest。
- 准备阶段 B 本地提交说明。
阶段 C:局部爆炸源项快照和载荷候选筛选
- 设计局部爆炸源项快照数据结构。
- 设计源粒子到结构粒子的邻域筛选规则。
- 设计载荷候选计数诊断。
- 设计载荷源相质量诊断。
- 设计载荷源相能量诊断。
- 设计载荷源相平均压力诊断。
- 设计局部爆炸区域内 Gas 体积诊断。
- 设计局部爆炸区域内 Explosive 反应进度诊断。
- 设计局部爆炸区域内 Water 压力范围诊断。
- 设计局部爆炸区域内结构目标数量诊断。
- 在显式步前刷新 Water 压力快照。
- 在显式步前刷新 Gas 压力快照。
- 在 Explosive 更新后刷新 Gas 源项贡献快照。
- 在载荷构造前刷新结构目标 active 状态。
- 对非 active 源粒子执行跳过规则。
- 对 failed 结构粒子执行受控跳过或保留规则。
- 对非目标 set 结构粒子执行跳过规则。
- 对局部爆炸区域外源粒子执行跳过规则。
- 对局部爆炸区域外目标粒子执行跳过规则。
- 确认无源粒子时返回安全默认诊断。
- 确认无目标粒子时返回安全默认诊断。
- 确认 Water-only 模型不进入结构载荷路径。
- 确认 Gas-only 模型不进入结构载荷路径。
- 确认 Explosive-only 模型不进入结构载荷路径。
- 确认 Solid-only 模型不读取 Gas 源项。
- 确认 Shell-only 模型不读取 Gas 源项。
- 新增
blast_source_snapshot测试。 - 新增
blast_target_filter测试。 - 将源项快照测试接入 CTest。
- 准备阶段 C 本地提交说明。
阶段 D:结构外载荷缓存、投影和守恒诊断
- 设计结构外载荷缓存数组布局。
- 设计 Solid 外载荷缓存字段。
- 设计 Shell 外载荷缓存字段。
- 设计载荷投影的方向约定。
- 设计载荷投影的权重归一化约定。
- 设计压力到力的面积或体积尺度约定。
- 设计载荷做功诊断。
- 设计载荷冲量诊断。
- 设计载荷动量输入诊断。
- 设计载荷能量输入诊断。
- 初始化结构外载荷缓存默认值。
- 在每个显式步开始前清零结构外载荷缓存。
- 将局部 Water 压力贡献映射到候选结构目标。
- 将局部 Gas 压力贡献映射到候选结构目标。
- 将 Explosive release 诊断贡献映射到载荷统计。
- 对 Solid 目标累加外力贡献。
- 对 Shell 目标累加外力贡献。
- 对 Shell 目标累加等效外力矩占位诊断。
- 对权重和为零的候选对报 warning 或跳过。
- 检查外载荷有限性。
- 检查外载荷缓存不污染 Water 粒子。
- 检查外载荷缓存不污染 Gas 粒子。
- 检查外载荷缓存不污染 Explosive 粒子。
- 检查 Solid/Shell 目标之间载荷隔离。
- 检查无 active 结构目标时载荷统计为零。
- 检查无局部爆炸源时载荷统计为零。
- 新增
blast_load_accumulator测试。 - 新增
blast_load_conservation测试。 - 将结构外载荷测试接入 CTest。
- 准备阶段 D 本地提交说明。
阶段 E:显式推进接入、Solid/Shell 响应和隔离规则
- 设计局部爆炸载荷在 Velocity-Verlet 中的调用顺序。
- 确认 Explosive 更新早于爆炸载荷投影。
- 确认 Gas 源项应用早于结构载荷诊断。
- 确认 Water/Gas 压力更新早于结构载荷投影。
- 将 Solid 外载荷并入 Solid 加速度或外力入口。
- 将 Shell 外载荷并入 Shell 受控外力入口。
- 对尚未完成的 Shell 内力路径保持受控 no-op 或诊断占位。
- 确认 Shell 外载荷不宣称完整 Shell 动力学闭环。
- 确认 Solid 外载荷不改变既有 Solid-only gate 结果。
- 确认 Shell 外载荷不改变既有 Shell 运动学 gate 结果。
- 确认 Water-only 显式步结果保持稳定。
- 确认 Gas-only 显式步结果保持稳定。
- 确认 Explosive-Gas 显式步结果保持稳定。
- 确认 Solid-only 显式步结果保持稳定。
- 确认无载荷控制时完整显式步行为不变。
- 添加局部爆炸载荷启用开关。
- 添加局部爆炸载荷禁用路径测试。
- 添加单步载荷施加测试。
- 添加多步载荷累积测试。
- 添加载荷时间窗口结束后清零测试。
- 添加结构加速度方向检查测试。
- 添加 Shell director 不被外载荷路径非法修改的测试。
- 添加 failed Solid 目标处理测试。
- 添加 failed Shell 目标处理测试。
- 新增
blast_solver_order测试。 - 新增
blast_solid_response测试。 - 新增
blast_shell_response测试。 - 新增
blast_noop_regression测试。 - 将显式推进接入测试接入 CTest。
- 准备阶段 E 本地提交说明。
阶段 F:诊断、输出、restart 占位和公开接口边界
- 设计 0.7.0 局部爆炸 summary 诊断结构。
- 记录局部爆炸区域 active 源粒子数。
- 记录局部爆炸区域 active 目标粒子数。
- 记录 Water 压力贡献统计。
- 记录 Gas 压力贡献统计。
- 记录 Explosive release 贡献统计。
- 记录 Solid 接收总载荷。
- 记录 Shell 接收总载荷。
- 记录结构载荷总冲量。
- 记录结构载荷总做功。
- 记录结构载荷最大粒子力。
- 记录结构载荷最大粒子加速度贡献。
- 记录被跳过源粒子数量。
- 记录被跳过目标粒子数量。
- 设计 summary CSV 的 0.7.0 调试字段。
- 将局部爆炸 summary 写入 summary CSV。
- 设计粒子 CSV 的 0.7.0 调试字段。
- 将结构外载荷字段写入粒子 CSV。
- 确认默认输出不开启时不生成临时结果。
- 设计 restart 中 0.7.0 状态边界。
- 明确 0.7.0 是否写入正式
STATE_0_7。 - 若写入 restart,保存局部爆炸控制和诊断状态(0.7.0 已决策不写入)。
- 若不写入 restart,在文档中明确为非交付范围。
- 保持 0.6.1 restart 兼容读入路径稳定。
- 设计 Fortran 内部诊断查询入口。
- 明确 C ABI 是否暴露 0.7.0 调试字段。
- 若暴露 C ABI,补齐小容量和空指针错误路径(0.7.0 已决策不暴露)。
- 若不暴露 C ABI,在文档中明确为非交付范围。
- 新增
blast_summary测试。 - 新增
blast_output测试。 - 新增
blast_restart_boundary测试。 - 将诊断输出测试接入 CTest。
- 准备阶段 F 本地提交说明。
阶段 G:局部爆炸 smoke、回归 gate 和文档发布准备
- 设计 0.7.0 局部爆炸 smoke 的最小物理链路。
- 设计 Water/Gas/Explosive/Solid smoke 验收指标。
- 设计 Water/Gas/Explosive/Shell smoke 验收指标。
- 设计 Water/Gas/Explosive/Solid/Shell smoke 验收指标。
- 实现单步局部爆炸 smoke 测试。
- 实现多步局部爆炸 smoke 测试。
- 检查 smoke 中 Gas 体积或压力统计方向。
- 检查 smoke 中 Explosive 反应进度单调性。
- 检查 smoke 中 Solid/Shell 载荷方向。
- 检查 smoke 中载荷冲量非负或受控。
- 检查 smoke 中能量诊断有限性。
- 检查 smoke 中所有粒子状态有限性。
- 运行 Water 回归 gate。
- 运行 Gas 回归 gate。
- 运行 Explosive 回归 gate。
- 运行 Solid 回归 gate。
- 运行 Shell 0.6.1 回归 gate。
- 运行 CouplingInterface 回归 gate。
- 运行 output 回归 gate。
- 运行 restart 回归 gate。
- 运行完整 CTest。
- 运行 0.7.0 局部爆炸专项 gate。
- 运行 source size 相关 gate。
- 运行
git diff --check。 - 更新 README 中 0.7.0 当前状态和不交付范围。
- 更新
docs/06_test_and_verification_plan.md的 0.7.0 release gate。 - 更新
docs/09_release_history.md的 0.7.0 本地验收记录。 - 更新
docs/11_benchmark_matrix.md的 0.7.0 gate 矩阵。 - 确认文档不宣称工程级水下接触爆炸响应。
- 确认文档不宣称真实 FEM-SPH 联合运行。
- 确认文档不宣称完整舱段破坏 benchmark。
- 确认输出目录、CSV、VTK、restart 和临时结果未提交。
- 确认代码、构建脚本、测试和工具目录未新增 FEMLite 直接依赖。
- 准备 0.7.0 发布提交说明。