Files
SPHLite/todo.md
T
2026-07-03 19:14:31 +08:00

22 KiB
Raw Blame History

SPHLite TODO

当前目标版本:0.6.0

本文档依据 docs/v6.0_development_plan.md 拆分。0.6.0 定位为 Shell 板壳粒子版本线的起点,目标是在 0.5.1 已完成 Solid 3D 实体结构粒子稳定化和结构算法加固的基础上,建立 Shell 输入、状态、Mindlin-Reissner 板壳运动学、厚度积分、材料点更新、显式推进、输出、restart、接口和测试 gate 的最小闭环。

所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.6.0 不实现真实水-气-结构工程爆炸响应、真实 FEM-SPH 耦合、工程级结构破坏 benchmark、完整板壳撕裂路径追踪、裂纹扩展、穿孔判据库、碎片云、壳-实体连接、复杂接触、焊缝失效库、大规模并行或 GPU 后端。

执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端。

阶段 A:版本基线、范围声明与 0.6.0 样例

  • 确认当前 git 状态干净或记录已有未提交内容。
  • 确认 v0.5.1 标签和远端发布提交可作为 0.6.0 开发基线。
  • 将核心软件版本更新为 0.6.0。
  • 将 CMake 项目版本更新为 0.6.0。
  • 更新 Fortran smoke 测试中的版本期望。
  • 更新 C API 测试中的版本期望。
  • 更新 C++ API 测试中的版本期望。
  • 更新 Python debug 测试中的版本期望。
  • 更新 CLI --version 和 inspect 版本期望。
  • 在 README 中记录 0.6.0 Shell 起步闭环开发定位。
  • 创建 Shell 0.6.0 最小 section 输入样例。
  • 创建 Shell 3 点厚度积分输入样例。
  • 创建 Shell 5 点厚度积分输入样例。
  • 创建 Shell director 显式给定输入样例。
  • 创建 Shell director 退化错误输入样例。
  • 创建 Shell 刚体平动输入样例。
  • 创建 Shell 单轴膜拉伸输入样例。
  • 创建 Shell 受控弯曲输入样例。
  • 创建 Shell 横向剪切输入样例。
  • 创建 Shell 弹性材料点输入样例。
  • 创建 Shell Johnson-Cook flow 输入样例。
  • 创建 Shell Johnson-Cook failure 输入样例。
  • 创建 Shell progressive softening 输入样例。
  • 创建 Shell 最小内力 smoke 输入样例。
  • 创建 Shell 0.6.0 显式推进 smoke 输入样例。
  • 创建 STATE_0_6 restart 测试输入样例。
  • 准备 STATE_0_5_1 restart 兼容读入测试夹具。
  • 创建 Shell material 缺失密度错误输入样例。
  • 创建 Shell section 非法厚度错误输入样例。
  • 创建 Shell section 非法积分点数量错误输入样例。
  • 创建 Shell section 指向非 Shell material 错误输入样例。
  • 创建 active Shell 粒子缺失 Shell section 错误输入样例。

阶段 B:Shell 输入解析、section 校验与 warning/error 路径

  • 复核现有 material 解析路径并保持 Water/Gas/Explosive/Solid 兼容。
  • 支持 TYPE=SHELL material 识别。
  • 支持 Shell material 密度读取和映射。
  • 支持 Shell material 弹性参数读取和映射。
  • 支持 Shell material Johnson-Cook flow 参数读取和映射。
  • 支持 Shell material Johnson-Cook failure 参数读取和映射。
  • 支持 Shell material softening 控制参数读取和映射。
  • 对 Shell material 缺失密度路径报 error。
  • 对 Shell material 非正密度路径报 error。
  • 对 Shell material 缺失弹性参数路径报 error。
  • 对 Shell material 非正弹性模量路径报 error。
  • 对 Shell material 非法泊松比路径报 error。
  • 对 Shell Johnson-Cook flow 非有限参数路径报 error。
  • 对 Shell Johnson-Cook failure 非完整或非有限参数路径报 error。
  • 对 Shell unsupported softening 类型路径报 error。
  • 对未被 active Shell 粒子使用的 Shell material 保持 warning。
  • 支持 *SHELL SECTION 或等价 section 子集解析。
  • 解析 Shell section 的 material 参数。
  • 解析 Shell section 的 thickness 参数。
  • 解析 Shell section 的 integration point 数量。
  • 解析 Shell section 的 shear correction 参数。
  • 对 Shell section 缺失 material 参数路径报 error。
  • 对 Shell section 指向不存在 material 路径报 error。
  • 对 Shell section 指向非 Shell material 路径报 error。
  • 对 Shell section 非正 thickness 路径报 error。
  • 对 Shell section 非法 integration point 数量路径报 error。
  • 对 Shell section 非法 shear correction 路径报 error。
  • 对存在 active Shell 粒子但缺失 Shell section 的模型报 error。
  • 确认 set 仍只表示集合,不参与 Shell 类型判断。
  • 确认 phase/status 默认值不改变 Water/Gas/Explosive/Solid 路径。
  • 新增 input_shell_section Fortran 输入测试。
  • 新增 input_shell_errors Fortran 输入测试。
  • 将 input_shell_section 接入 CTest。
  • 将 input_shell_errors 接入 CTest。

阶段 C:Shell 状态数组、厚度积分点和默认值

  • 设计 Shell 粒子级状态常量和数组布局。
  • 新增或补齐 Shell thickness 状态数组。
  • 新增或补齐 Shell director 状态数组。
  • 新增或补齐 Shell omega 状态数组。
  • 新增或补齐 Shell membrane strain 状态数组。
  • 新增或补齐 Shell bending strain 状态数组。
  • 新增或补齐 Shell shear strain 状态数组。
  • 新增或补齐 Shell damage 状态数组。
  • 新增或补齐 Shell softening 状态数组。
  • 新增或补齐 Shell internal energy 状态数组。
  • 新增或补齐 Shell failure status 状态数组。
  • 设计 Shell 厚度积分点状态常量和数组布局。
  • 新增或补齐 Shell integration point count 状态数组。
  • 新增或补齐 Shell integration point coordinate 状态数组。
  • 新增或补齐 Shell integration point weight 状态数组。
  • 新增或补齐 Shell integration point stress 状态数组。
  • 新增或补齐 Shell integration point strain 状态数组。
  • 新增或补齐 Shell integration point plastic strain 状态数组。
  • 新增或补齐 Shell integration point temperature 状态数组。
  • 新增或补齐 Shell integration point damage 状态数组。
  • 新增或补齐 Shell integration point softening 状态数组。
  • 在 Shell reset 路径初始化粒子级状态。
  • 在 Shell reset 路径初始化积分点状态。
  • 在 Shell allocate/build 路径分配粒子级状态。
  • 在 Shell allocate/build 路径分配积分点状态。
  • 在 Shell clear/finalize 路径释放粒子级状态。
  • 在 Shell clear/finalize 路径释放积分点状态。
  • 初始化 active Shell 粒子的 thickness。
  • 初始化 active Shell 粒子的 integration point count。
  • 初始化 active Shell 粒子的 integration point 坐标和权重。
  • 初始化 active Shell 粒子的 damage、softening 和 failure status。
  • 对非 Shell 粒子设置安全默认 Shell 状态。
  • 新增 shell_state_build 测试。
  • 新增 shell_section_integration 测试。
  • 将 shell_state_build 接入 CTest。
  • 将 shell_section_integration 接入 CTest。

阶段 D:Director、转动状态和参考面积/惯量

  • 设计 Shell director 初始化优先级。
  • 支持由输入或 section 相关信息设置 Shell 初始 director。
  • 支持由受控小模型参考面几何推断 Shell 初始 director。
  • 对无法推断 director 的 active Shell 粒子报 error。
  • 检查 Shell director 有限性。
  • 检查 Shell director 非零长度。
  • 对 Shell director 执行归一化。
  • 在归一化后记录 director 质量诊断。
  • 新增 Shell director 退化状态或诊断字段。
  • 新增 Shell angular velocity 状态默认值。
  • 新增 Shell angular acceleration 或等价力矩工作数组。
  • 新增 Shell rotational inertia 或等价面积/厚度惯量状态。
  • 初始化 active Shell 粒子的参考面积或等效面积。
  • 初始化 active Shell 粒子的转动惯量。
  • 对非 active Shell 粒子设置安全转动默认值。
  • 实现 Shell director 基于角速度的基础更新入口。
  • 实现 director 更新后的归一化保护。
  • 实现 Shell 转动状态有限性检查。
  • 计算 Shell 最大角速度诊断。
  • 计算 Shell director 退化数量诊断。
  • 确认无 active Shell 粒子时跳过 director 和转动更新。
  • 确认 Shell director 和转动状态不污染 Solid 粒子。
  • 新增 shell_director_update 测试。
  • 新增 shell_rotation_kinematics 测试。
  • 将 shell_director_update 接入 CTest。
  • 将 shell_rotation_kinematics 接入 CTest。

阶段 E:Mindlin-Reissner 运动学和应变计算

  • 设计 Shell 局部坐标系或局部分量顺序。
  • 新增 Shell 局部基向量或等价工作数组。
  • 实现 Shell 局部基有限性检查。
  • 实现 Shell 刚体平动下膜应变为零的路径。
  • 实现 Shell 刚体转动下膜应变受控路径。
  • 实现 Shell 单轴拉伸膜应变计算。
  • 实现 Shell 简单剪切膜应变计算。
  • 实现 Shell 受控曲率场弯曲应变计算。
  • 实现 Shell 横向剪切应变计算。
  • 将膜应变转换为局部 11,22,12 顺序。
  • 将弯曲应变转换为局部 11,22,12 顺序。
  • 将剪切应变转换为局部 13,23 顺序。
  • 新增 Shell strain increment 工作数组。
  • 由 Shell 运动学计算厚度积分点应变增量。
  • 将厚度位置对弯曲应变的贡献加入积分点应变。
  • 确认未使用积分点不参与应变计算。
  • 确认非 Shell 粒子不污染 Shell 应变状态。
  • 确认 failed Shell 粒子按受控策略跳过或保持状态。
  • 新增 shell_membrane_strain 测试。
  • 新增 shell_bending_strain 测试。
  • 新增 shell_shear_strain 测试。
  • 将 shell_membrane_strain 接入 CTest。
  • 将 shell_bending_strain 接入 CTest。
  • 将 shell_shear_strain 接入 CTest。

阶段 F:Shell 材料点、Johnson-Cook 失效和渐进软化

  • 复核 Solid Johnson-Cook 材料辅助过程的可复用边界。
  • 为 Shell 建立独立 material table 或映射状态。
  • 计算 Shell material 的弹性常数和结构波速。
  • 初始化 Shell integration point stress。
  • 初始化 Shell integration point strain。
  • 初始化 Shell integration point plastic strain。
  • 初始化 Shell integration point temperature。
  • 初始化 Shell integration point damage。
  • 初始化 Shell integration point softening。
  • 实现 Shell 积分点弹性 trial 更新。
  • 实现 Shell 局部平面应力或受控近似路径。
  • 实现 Shell Johnson-Cook flow 更新入口。
  • 实现 Shell Johnson-Cook failure strain 计算入口。
  • 实现 Shell integration point damage 单调累积。
  • 实现 Shell integration point softening 单调降低。
  • 实现 Shell 粒子级 damage 聚合。
  • 实现 Shell 粒子级 softening 聚合。
  • 实现 Shell 内能或等价塑性功增量。
  • 保持 Shell 温度状态可写入和可恢复。
  • 实现 Shell failure status 更新。
  • 实现 PHASE_SHELL_FAILED 不可逆切换。
  • 确认 failed Shell 粒子不被删除。
  • 确认 failed Shell 粒子质量不改变。
  • 确认 restart 后 Shell damage 不被重置。
  • 确认 restart 后 Shell softening 不被重置。
  • 新增 shell_elastic_material 测试。
  • 新增 shell_johnson_cook_flow 测试。
  • 新增 shell_johnson_cook_failure 测试。
  • 新增 shell_progressive_softening 测试。
  • 将 shell_elastic_material 接入 CTest。
  • 将 shell_johnson_cook_flow 接入 CTest。
  • 将 shell_johnson_cook_failure 接入 CTest。
  • 将 shell_progressive_softening 接入 CTest。

阶段 G:Shell 内力、内力矩、稳定时间步和显式推进

  • 新增 Shell 内力贡献工作数组。
  • 新增 Shell 内力矩贡献工作数组。
  • 新增 Shell internal force residual 诊断状态。
  • 新增 Shell internal moment residual 诊断状态。
  • 新增 Shell 最大加速度诊断状态。
  • 新增 Shell 最大角加速度或力矩诊断状态。
  • 实现零应力时 Shell 内力为零。
  • 实现零弯矩时 Shell 内力矩为零。
  • 实现刚体平动时 Shell 内力为零。
  • 实现刚体转动受控小模型下力矩有限路径。
  • 实现膜力对平动加速度的最小贡献路径。
  • 实现弯曲力矩对转动状态的最小贡献路径。
  • 实现横向剪切贡献的受控路径或明确跳过策略。
  • 将 Shell softening 作用到内力或应力结果量。
  • 确认 Shell 内力不污染 Water-only 算例。
  • 确认 Shell 内力不污染 Gas-only 算例。
  • 确认 Shell 内力不污染 Explosive-Gas-Water 算例。
  • 确认 Shell 内力不污染 Solid-only 算例。
  • 计算 Shell 总质量诊断。
  • 计算 Shell 总动量诊断。
  • 计算 Shell 转动诊断或角速度最大值。
  • 计算 Shell 动能诊断。
  • 计算 Shell 内能诊断。
  • 计算 Shell 最大膜应变诊断。
  • 计算 Shell 最大弯曲应变诊断。
  • 计算 Shell 最大剪切应变诊断。
  • 计算 Shell 最大 von Mises 或等效应力诊断。
  • 计算 Shell damage 范围诊断。
  • 计算 Shell softening 范围诊断。
  • 实现 dt_shell_wave 估计。
  • 实现 dt_shell_rot 估计。
  • 实现 dt_shell_acc 估计。
  • 将 Shell dt 合并为 Shell dtcrit。
  • 将 Shell dt 纳入全局 dt 估计。
  • 确认无 active Shell 时全局 dt 与 0.5.1 路径一致。
  • 将 Shell 运动学、材料更新、内力和诊断挂接到 Velocity-Verlet 步。
  • 确认 Shell-only 小模型可连续推进多步。
  • 新增 shell_internal_force_smoke 测试。
  • 新增 shell_stable_dt 测试。
  • 新增 shell_explicit_smoke 测试。
  • 将 shell_internal_force_smoke 接入 CTest。
  • 将 shell_stable_dt 接入 CTest。
  • 将 shell_explicit_smoke 接入 CTest。

阶段 H:CSV 输出、STATE_0_6 restart 与兼容读入

  • 在 summary CSV 中追加 shell_particles 字段。
  • 在 summary CSV 中追加 shell_failed_particles 字段。
  • 在 summary CSV 中追加 shell_mass 字段。
  • 在 summary CSV 中追加 shell_momentum 字段。
  • 在 summary CSV 中追加 shell_kinetic_energy 字段。
  • 在 summary CSV 中追加 shell_internal_energy 字段。
  • 在 summary CSV 中追加 shell_max_membrane_strain 字段。
  • 在 summary CSV 中追加 shell_max_bending_strain 字段。
  • 在 summary CSV 中追加 shell_max_shear_strain 字段。
  • 在 summary CSV 中追加 shell_max_von_mises 字段。
  • 在 summary CSV 中追加 shell_damage_min 字段。
  • 在 summary CSV 中追加 shell_damage_max 字段。
  • 在 summary CSV 中追加 shell_softening_min 字段。
  • 在 summary CSV 中追加 shell_softening_max 字段。
  • 在 summary CSV 中追加 shell_dt_wave 字段。
  • 在 summary CSV 中追加 shell_dt_rot 字段。
  • 在 summary CSV 中追加 shell_dt_accel 字段。
  • 在 summary CSV 中追加 shell_dtcrit 字段。
  • 在粒子 CSV 中追加 shell_thickness 字段。
  • 在粒子 CSV 中追加 shell_director_x 字段。
  • 在粒子 CSV 中追加 shell_director_y 字段。
  • 在粒子 CSV 中追加 shell_director_z 字段。
  • 在粒子 CSV 中追加 shell_omega_norm 字段。
  • 在粒子 CSV 中追加 shell_damage 字段。
  • 在粒子 CSV 中追加 shell_softening 字段。
  • 在粒子 CSV 中追加 shell_failure_status 字段。
  • 更新 output 测试锁定 0.6.0 CSV header。
  • 将 restart 状态版本更新为 STATE_0_6。
  • 将 Shell 粒子级状态写入 0.6.0 restart。
  • 将 Shell 积分点状态写入 0.6.0 restart。
  • 将 Shell material/section 映射写入或恢复到 0.6.0 restart。
  • 将 Shell 诊断和 dt 状态写入 0.6.0 restart。
  • 从 STATE_0_6 restart 读回 Shell 粒子级状态。
  • 从 STATE_0_6 restart 读回 Shell 积分点状态。
  • 从 STATE_0_6 restart 读回后继续显式步。
  • 从 STATE_0_5_1 restart 兼容读入并初始化空 Shell 状态。
  • 从 STATE_0_5 restart 兼容读入并初始化空 Shell 状态。
  • 从更早可支持 restart 读入时初始化空 Shell 状态。
  • 确认 restart 后不重复初始化 Shell thickness。
  • 确认 restart 后不重复初始化 Shell director。
  • 确认 restart 后不重复初始化 Shell omega。
  • 确认 restart 后不重复初始化 Shell 积分点状态。
  • 确认 restart 后不重复初始化 Shell damage。
  • 确认 restart 后不重复初始化 Shell softening。
  • 确认 restart 后不重复初始化 Shell failure status。
  • 新增 shell_output 测试。
  • 新增 shell_restart_060 测试。
  • 新增 shell_restart_051_compat 测试。
  • 将 shell_output 接入 CTest。
  • 将 shell_restart_060 接入 CTest。
  • 将 shell_restart_051_compat 接入 CTest。

阶段 I:Fortran API、C ABI、C++、Python 与 CLI

  • 新增 sph_get_shell_counts Fortran API。
  • 新增 sph_get_shell_summary Fortran API。
  • 新增 sph_get_shell_state Fortran API。
  • 新增 sph_get_shell_integration_state Fortran API。
  • 新增 sph_get_shell_dt_limits Fortran API。
  • 为 Shell Fortran API 补齐未初始化错误路径。
  • 为 Shell Fortran API 补齐未 build 错误路径。
  • 为 Shell Fortran API 补齐小容量错误路径。
  • 在 C 头文件中声明 Shell summary 查询函数。
  • 在 C 头文件中声明 Shell particle state 查询函数。
  • 在 C 头文件中声明 Shell integration state 查询函数。
  • 在 C ABI 中实现 Shell summary 查询。
  • 在 C ABI 中实现 Shell particle state 查询。
  • 在 C ABI 中实现 Shell integration state 查询。
  • 在 C ABI 中校验 Shell API 空指针错误路径。
  • 在 C ABI 中校验 Shell API 非正容量错误路径。
  • 在 C ABI 中校验 Shell API 小容量错误路径。
  • 在 C ABI 中锁定 Shell particle state 展开顺序。
  • 在 C ABI 中锁定 Shell integration state 展开顺序。
  • 在 C API 测试中覆盖 Shell summary 查询。
  • 在 C API 测试中覆盖 Shell particle state 查询。
  • 在 C API 测试中覆盖 Shell integration state 查询。
  • 在 C++ wrapper 中新增 Shell summary 薄包装。
  • 在 C++ wrapper 中新增 Shell particle state 薄包装。
  • 在 C++ wrapper 中新增 Shell integration state 薄包装。
  • 在 C++ API 测试中覆盖 Shell wrapper。
  • 在 Python ctypes 中新增 Shell summary 薄包装。
  • 在 Python ctypes 中新增 Shell particle state 薄包装。
  • 在 Python ctypes 中新增 Shell integration state 薄包装。
  • 在 Python inspect 中追加 Shell 0.6.0 诊断字段。
  • 在 Python checker 中覆盖 Shell 0.6.0 小模型。
  • 在 Python checker 中覆盖 STATE_0_6 restart 读回。
  • 在 Python checker 中覆盖 STATE_0_5_1 restart 兼容读入。
  • 在 CLI inspect 中追加 shell_particles 字段。
  • 在 CLI inspect 中追加 shell_failed_particles 字段。
  • 在 CLI inspect 中追加 shell_mass 字段。
  • 在 CLI inspect 中追加 shell_max_membrane_strain 字段。
  • 在 CLI inspect 中追加 shell_max_bending_strain 字段。
  • 在 CLI inspect 中追加 shell_max_shear_strain 字段。
  • 在 CLI inspect 中追加 shell_max_von_mises 字段。
  • 在 CLI inspect 中追加 shell_damage_range 字段。
  • 在 CLI inspect 中追加 shell_softening_range 字段。
  • 在 CLI inspect 中追加 shell_dt_limits 字段。
  • 在 CLI checker 中覆盖 Shell inspect、run 和 restart。
  • 确认新增 Shell API 不改变既有 Water/Gas/Explosive/Solid 接口语义。
  • 新增 shell_api 测试并接入 CTest。
  • 新增 shell_c_api 测试并接入 CTest。
  • 新增 shell_python 测试并接入 CTest。
  • 新增 shell_cli 测试并接入 CTest。

阶段 J:源码尺寸、回归门禁、文档同步与发布准备

  • 新增 shell_source_size 检查项并接入 CTest。
  • 复核 tests/source_size_exceptions.txt 中 stale 例外。
  • 拆分过大的 Shell state 源文件或过长过程。
  • 拆分过大的 Shell section 源文件或过长过程。
  • 拆分过大的 Shell kinematics 源文件或过长过程。
  • 拆分过大的 Shell material 源文件或过长过程。
  • 拆分过大的 Shell force 源文件或过长过程。
  • 拆分过大的 Shell restart 源文件或过长过程。
  • 拆分过大的 Shell API 源文件或过长过程。
  • 保持 0.5.1 完整 gate 全部通过。
  • 单独运行 0.5.0 Solid 专项 gate。
  • 单独运行 0.5.1 Solid 专项 gate。
  • 单独运行 0.6.0 Shell 专项 gate。
  • 运行 source_size 检查并确认无新增无理由例外。
  • 运行 git diff --check 并清理空白问题。
  • 更新 README 的 0.6.0 当前状态和不交付范围。
  • 更新 06 号文档的 0.6.0 release gate。
  • 更新 09 号文档的 0.6.0 验收记录占位。
  • 更新 11 号文档的 0.6.0 benchmark/gate 矩阵。
  • 确认文档不宣称已实现真实水-气-结构工程爆炸响应。
  • 确认文档不宣称已实现真实 FEM-SPH 耦合。
  • 确认文档不宣称已实现工程级结构破坏 benchmark。
  • 确认文档不宣称已实现完整板壳撕裂路径追踪。
  • 确认文档不宣称已实现穿孔判据库或碎片云。
  • 确认未新增壳-实体连接或局部壳/实体混合结构连接算法。
  • 确认未新增几何、网格或粒子生成能力。
  • 确认未新增 FEMLite 直接依赖。
  • 确认未修改 SPHLite 文件夹之外的内容。
  • 确认默认 gate、0.5.1 回归 gate、0.6.0 Shell gate、source size 和 git diff --check 全部通过。
  • 汇总 0.6.0 已完成能力、未交付范围和已知限制。
  • 准备 0.6.0 发布前本地提交记录。