Files
SPHLite/todo.md
T

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,保存局部爆炸控制和诊断状态。
  • 若不写入 restart,在文档中明确为非交付范围。
  • 保持 0.6.1 restart 兼容读入路径稳定。
  • 设计 Fortran 内部诊断查询入口。
  • 明确 C ABI 是否暴露 0.7.0 调试字段。
  • 若暴露 C ABI,补齐小容量和空指针错误路径。
  • 若不暴露 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 发布提交说明。