22 KiB
22 KiB
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_6restart 测试输入样例。 - 准备
STATE_0_5_1restart 兼容读入测试夹具。 - 创建 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=SHELLmaterial 识别。 - 支持 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_sectionFortran 输入测试。 - 新增
input_shell_errorsFortran 输入测试。 - 将
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_6restart 读回 Shell 粒子级状态。 - 从
STATE_0_6restart 读回 Shell 积分点状态。 - 从
STATE_0_6restart 读回后继续显式步。 - 从
STATE_0_5_1restart 兼容读入并初始化空 Shell 状态。 - 从
STATE_0_5restart 兼容读入并初始化空 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_countsFortran API。 - 新增
sph_get_shell_summaryFortran API。 - 新增
sph_get_shell_stateFortran API。 - 新增
sph_get_shell_integration_stateFortran API。 - 新增
sph_get_shell_dt_limitsFortran 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_6restart 读回。 - 在 Python checker 中覆盖
STATE_0_5_1restart 兼容读入。 - 在 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 发布前本地提交记录。