Files
CCLite/SPHLite/docs/v6.0_development_plan.md
2026-07-05 22:48:27 +08:00

29 KiB
Raw Permalink Blame History

SPHLite v6.0 开发计划

文档状态:0.6.0 开发计划草案

目标软件版本:SPHLite 0.6.0

1. 文档定位

本文档用于规划 SPHLite 0.6.0 版本的开发范围。0.6.0 是 Shell 板壳粒子版本线的起点,目标是在 0.5.1 已完成 Solid 3D 实体结构粒子稳定化和结构算法加固的基础上,建立 Shell 输入、状态、Mindlin-Reissner 板壳运动学、厚度积分、材料点更新、显式推进、输出、restart、接口和测试 gate 的最小闭环。

0.6.0 不作为真实水-气-结构工程爆炸响应版本,也不作为 FEM-SPH 耦合版本。0.6.0 的重点是让板壳粒子从占位进入可独立验证的小型结构动力学路径,为后续水-气-结构 smoke、板壳撕裂/穿孔加固和 Shell-FEMLite 壳连续体耦合提供稳定状态和接口基础。

2. 依据文件

本计划依据以下 01-06 号文档制定:

  • docs/01_requirements_specification.md
  • docs/02_software_architecture_design.md
  • docs/03_detailed_design.md
  • docs/04_mathematical_model_and_algorithms.md
  • docs/05_interface_control_document.md
  • docs/06_test_and_verification_plan.md

同时,0.6.0 以已发布的 0.5.1 Solid 稳定化版本为开发基线。

3. 版本定位

3.1 与 0.5.1 的关系

0.5.1 已完成以下 Solid 稳定化能力:

  • Solid material/section 输入、Johnson-Cook flow/failure、damage、softening 和显式推进闭环。
  • Solid 参考邻域、修正矩阵、变形梯度、速度梯度、应变率和最小内力路径。
  • Solid 能量、动量、最大应变率、最大加速度、内力残差和参考质量诊断。
  • Solid CSV 输出、STATE_0_5_1 restart、STATE_0_5 兼容读入和粒子级状态接口。
  • Fortran API、C ABI、C++ wrapper、Python ctypes、CLI 和 0.5.1 专项 CTest gate。

0.6.0 不重写 0.5.1 的 Solid 结构算法。0.6.0 应保持 0.5.1 完整 gate 稳定,并在此基础上建立 Shell 独立状态和计算路径。

3.2 与 0.7.0 的关系

0.7.0 建议作为水-气-结构局部爆炸 smoke 的起点。0.6.0 不实现真实水-气-结构耦合载荷闭环,不实现舱段破坏工程算例。0.6.0 只需要保证 Shell 的状态、输出、restart 和接口足够稳定,使 0.7.0 可以将 Water/Gas/Explosive 的载荷路径施加到 Solid/Shell 结构粒子上。

3.3 与耦合版本的关系

真实 FEM-SPH 接触耦合和连续体耦合仍属于后续 0.8/0.9。0.6.0 只维护 SPHLite 内部 Shell 粒子状态和中立 CouplingInterface 边界,不直接依赖 FEMLite,不修改 FEMLite,也不引入外部 CouplingModule 作为依赖。

3.4 0.6.0 核心目标

0.6.0 的核心目标是形成 Shell 板壳粒子小型结构动力学闭环:

0.5.1 Solid and common infrastructure baseline
  -> Shell material and section input
  -> Shell state arrays and thickness integration layout
  -> director, angular velocity and shell kinematics
  -> membrane, bending and transverse shear strain measures
  -> through-thickness material point update
  -> minimal shell internal force and moment diagnostics
  -> Velocity-Verlet explicit smoke
  -> STATE_0_6 restart and STATE_0_5_1 compatibility
  -> Shell API, C ABI, C++ wrapper, Python ctypes and CLI fields

4. 开发原则

4.1 保持 0.6 版本线边界

0.6.0 只交付 Shell 板壳粒子的最小闭环,不进入真实水-气-结构爆炸响应、真实 FEM-SPH 耦合、工程级船舱破坏 benchmark、复杂撕裂面追踪或碎片云。

4.2 保持求解器定位

SPHLite 仍是求解器,不负责几何建模、网格生成或粒子生成。新增 .inp 样例和 Python checker 只能作为测试、示例或验收辅助工具,不作为求解器几何、网格或粒子生成功能宣传。

4.3 保持 Fortran 95 和集中型数据管理

核心实现继续使用 Fortran 95。Shell 新状态应纳入集中数据库或 Shell 模块级状态管理,不采用面向对象粒子类设计。C ABI、C++ wrapper、Python ctypes 和 CLI 继续作为薄接口层。

4.4 保持显式动力学主流程

时间推进继续只支持 Velocity-Verlet 显式动力学。0.6.0 可新增 Shell 平动、转动、内力、内力矩和稳定时间步约束,但不引入隐式求解、静力求解、非线性静力求解或隐式-显式混合接口。

4.5 小型可测优先

Shell 结构算法必须先通过小型、可重复测试验收。0.6.0 不追求复杂撕裂、穿孔、接触、焊缝失效或工程舱段破坏,只要求板壳状态、运动学、厚度积分、材料更新和显式推进链路可测。

4.6 Shell 与 Solid 分离

Solid 和 Shell 分别处理实体结构粒子和板壳结构粒子,不互相伪装。Shell 可以复用通用材料模型或数学辅助过程,但必须拥有独立的 section、状态数组、诊断字段、restart 块和 API 语义。

5. 0.6.0 交付目标

0.6.0 建议交付以下内容:

  1. 将软件版本更新为 0.6.0。
  2. 保持 0.5.1 默认 gate 全部通过。
  3. 建立 Shell material/section 输入识别和校验路径。
  4. 支持 *SHELL SECTION 或等价 Abaqus section 子集,识别厚度、积分点数量和材料映射。
  5. 支持 3 点和 5 点厚度积分,默认 3 点。
  6. 建立 Shell 状态数组,包括厚度、director、角速度、膜应变、弯曲应变、横向剪切应变、damage、softening 和失效状态。
  7. 建立 Shell 厚度积分点状态,包括积分点应力、应变、塑性应变、温度或等效温升、damage 和 softening。
  8. 初始化 active Shell 粒子的厚度、director、积分点权重和参考面积或等效面积。
  9. 实现 director 或法向的安全初始化和归一化检查。
  10. 实现 Shell 平动和转动运动学入口。
  11. 实现 Mindlin-Reissner 小变形膜应变、弯曲应变和横向剪切应变的受控计算路径。
  12. 实现厚度积分点材料更新入口,优先复用 Johnson-Cook 路线,允许弹性退化路径作为测试基础。
  13. 实现 Shell damage、softening 和 PHASE_SHELL_FAILED 不可逆状态切换。
  14. 实现最小 Shell 内力和内力矩贡献路径,至少支持小型对称或简化布置 smoke。
  15. 实现 Shell 动量、角动量或等价转动诊断、动能、内能、damage/softening 范围和最大应变诊断。
  16. 将 Shell 平动和转动稳定时间步纳入全局 dt 估计。
  17. 将 Shell 接入 Velocity-Verlet 显式推进,形成 Shell-only 小模型 smoke。
  18. 在 summary CSV 和粒子 CSV 中追加必要的 Shell 调试字段。
  19. 将 restart 状态版本更新为 STATE_0_6,保存 Shell 持久状态和诊断。
  20. 保持 STATE_0_5_1 和更早可支持 restart 兼容读入,并初始化空 Shell 状态。
  21. 新增 Shell summary、particle state 和 integration point state 的 Fortran API 和 C ABI。
  22. 在 C++ wrapper、Python ctypes 和 CLI 中追加 Shell 0.6.0 诊断字段。
  23. 新增 Shell 0.6.0 专项 CTest gate,并保持 source size 受控。
  24. 更新 README、06、09 和 11 号文档中的 0.6.0 测试、验收和不交付范围。
  25. 不新增 FEMLite 直接依赖,不修改 SPHLite 文件夹之外的内容。

6. 非交付范围

0.6.0 不交付以下内容:

  1. 不实现真实水-气-结构工程爆炸响应。
  2. 不实现爆炸载荷作用下的船舱破坏工程 benchmark。
  3. 不实现真实 FEM-SPH 接触耦合或连续体耦合。
  4. 不实现完整板壳撕裂路径追踪、裂纹扩展、穿孔判据库或碎片云。
  5. 不实现壳-实体连接、壳-实体过渡或局部壳/实体混合结构连接算法。
  6. 不实现复杂接触、碰撞、摩擦或碎片-流体相互作用。
  7. 不实现焊缝失效库、多层复合板壳或材料分层脱粘。
  8. 不实现热传导、熔化、相变或完整热-力耦合。
  9. 不实现大规模并行、GPU 后端或性能优化版本。
  10. 不新增几何、网格或粒子生成能力。

7. 输入和校验

7.1 Shell material 识别

Shell 结构材料通过 *MATERIAL 的 type 或等价字段识别。0.6.0 应支持 TYPE=SHELL 或与 01-06 文档一致的 Shell material 识别方式,并保持 material 作为物理类型判断来源。

Shell material 校验建议包括:

  • Shell material 必须有正密度。
  • 弹性模量必须为正值。
  • 泊松比必须处于受控范围。
  • Johnson-Cook flow 参数必须完整且有限。
  • 请求 failure 时 Johnson-Cook failure 参数必须完整且有限。
  • softening 类型必须为已支持类型;不支持类型报 error。
  • 未被 active Shell 粒子使用的 Shell material 可 warning,不阻断其他路径运行。

7.2 Shell section 识别

*SHELL SECTION 或等价 Abaqus section 子集作为板壳 section 入口。0.6.0 应确认:

  • Shell section 必须指向存在的 Shell material。
  • Shell section 指向非 Shell material 时应报 error。
  • Shell section 必须有正厚度。
  • 厚度积分点数量只接受 3 或 5,未给定时默认 3。
  • 剪切修正系数若给定必须为正有限值;未给定时使用受控默认值。
  • 存在 active Shell 粒子但缺失 Shell section 时应报 error。
  • set 仍只表示集合,不作为 Shell 类型判断依据。

7.3 Shell 粒子和 2D 几何

Shell 面向 2D 几何板壳粒子,通过 section 识别厚度和板壳属性。0.6.0 不新增几何生成器或网格生成器。测试输入可以手写或由 Python 辅助脚本生成 .inp,但该脚本只属于测试辅助。

0.6.0 若需要从输入元素推断 Shell 粒子的局部面积、邻接或法向,应限于已有 Abaqus 子集和测试小模型,并在文档中说明其近似范围。

8. Shell 状态设计

8.1 粒子级状态

0.6.0 建议建立以下粒子级状态:

real(rk), allocatable :: shell_thickness(:)
real(rk), allocatable :: shell_director(:,:)
real(rk), allocatable :: shell_omega(:,:)
real(rk), allocatable :: shell_membrane_strain(:,:)
real(rk), allocatable :: shell_bending_strain(:,:)
real(rk), allocatable :: shell_shear_strain(:,:)
real(rk), allocatable :: shell_softening(:)
real(rk), allocatable :: shell_damage(:)
real(rk), allocatable :: shell_internal_energy(:)
integer, allocatable :: shell_failure_status(:)

数组约定:

  • shell_director(3,npart) 表示 Shell director 或法向。
  • shell_omega(3,npart) 表示角速度或转动相关状态。
  • shell_membrane_strain(3,npart) 使用局部顺序 11,22,12。
  • shell_bending_strain(3,npart) 使用局部顺序 11,22,12。
  • shell_shear_strain(2,npart) 使用局部顺序 13,23。

8.2 厚度积分点状态

0.6.0 建议建立厚度积分点状态。若固定最大积分点数为 5,可采用压缩数组或三维数组:

real(rk), allocatable :: shell_ip_stress(:,:,:)
real(rk), allocatable :: shell_ip_strain(:,:,:)
real(rk), allocatable :: shell_ip_plastic_strain(:,:)
real(rk), allocatable :: shell_ip_temperature(:,:)
real(rk), allocatable :: shell_ip_damage(:,:)
real(rk), allocatable :: shell_ip_softening(:,:)
integer, allocatable :: shell_ip_count(:)

建议约定:

  • shell_ip_stress(component,ip,particle)。
  • component 第一版可使用局部壳应力顺序 11,22,12,13,23。
  • ip 最大为 5,实际积分点数量由 section 决定。
  • 未使用积分点应设置安全默认值,不参与计算和输出诊断。

8.3 诊断状态

Shell 诊断建议包括:

  • active Shell 粒子数。
  • failed Shell 粒子数。
  • Shell 总质量。
  • Shell 总动量。
  • Shell 转动诊断或角速度最大值。
  • Shell 动能和内能。
  • Shell 最大膜应变、最大弯曲应变、最大剪切应变。
  • Shell 最大 von Mises 或等效应力。
  • Shell damage 和 softening 范围。
  • Shell dt 限制。
  • Shell 内力和内力矩残差。

9. Mindlin-Reissner 运动学

9.1 Director 初始化和更新

0.6.0 应实现 director 或法向状态的初始化和基础更新:

  • 输入或几何推断得到初始 director。
  • 未给定 director 时,可从受控小模型的参考面几何推断,无法推断时报 error。
  • director 必须有限且非零。
  • director 初始化后归一化。
  • 显式步中由角速度或转动增量更新 director。
  • 更新后继续归一化,避免长度漂移。

9.2 平动和转动自由度

Shell 粒子共享通用粒子数据库中的 x、v、a 平动状态。Shell 模块额外维护转动相关状态:

  • 角速度 omega。
  • 角加速度或等价转动力矩贡献。
  • 转动惯量或等价面积/厚度惯量。

0.6.0 可先实现简化转动路径,用小型模型验证方向、量级和有限性,不要求完整生产级壳单元刚度矩阵。

9.3 膜、弯曲和横向剪切应变

Mindlin-Reissner 路线下,0.6.0 应建立以下应变量:

  • 膜应变:由中面位移或速度梯度得到。
  • 弯曲应变:由 director/转角梯度得到。
  • 横向剪切应变:由 director 与中面法向或位移梯度组合得到。

第一版测试应覆盖:

  • 刚体平动下 Shell 应变为零。
  • 刚体转动或受控转动下膜应变为零或受控。
  • 简单单轴拉伸下膜应变方向正确。
  • 简单曲率场下弯曲应变方向正确。
  • director 非有限或退化路径受控报错。

10. 厚度积分和材料更新

10.1 厚度积分点

0.6.0 支持 3 点和 5 点厚度积分:

  • 默认 3 点。
  • 5 点用于更高精度或强非线性板壳响应的预留路径。
  • 积分点坐标和权重由 Shell section 或内部默认表确定。
  • 积分点状态必须写入 restart。

10.2 壳材料点更新

0.6.0 Shell 材料路线与结构长期目标保持一致,优先使用 Johnson-Cook flow/failure 路线。弹性材料点可作为退化路径和单元测试基础。

材料更新建议路径:

membrane/bending/shear strain increment
  -> through-thickness integration point strain
  -> elastic trial or Johnson-Cook flow correction
  -> Johnson-Cook damage update
  -> progressive softening
  -> stress resultants and shell diagnostics

第一版可采用局部平面应力或受控近似,但必须在文档和测试中明确其小型 smoke 范围。

10.3 失效和撕裂初步状态

0.6.0 应建立 Shell 失效和撕裂初步状态,但不交付完整撕裂路径追踪:

  • damage 单调不减。
  • softening 单调不增。
  • PHASE_SHELL_FAILED 不可逆。
  • 失效不删除粒子,不改变质量。
  • restart 后 damage、softening 和 failure status 不被重置。
  • 可以统计撕裂候选或 failed Shell 数量,但不生成裂纹面、碎片云或穿孔形态。

11. Shell 内力、内力矩和时间步

11.1 最小 Shell 内力路径

0.6.0 建议实现最小 Shell 内力和内力矩贡献路径。第一版目标是形成可测链路:

  • 零应力和零应变时内力为零。
  • 刚体平动不产生虚假内力。
  • 受控小模型下膜力方向和量级有限。
  • 受控小模型下弯曲力矩方向和量级有限。
  • softening 可降低失效粒子的承载贡献。
  • 无 active Shell 粒子时跳过 Shell 内力路径,不影响 Water/Gas/Explosive/Solid。

11.2 稳定时间步

0.6.0 继续使用 Velocity-Verlet 显式推进。Shell dt 约束建议包括:

dt_shell_wave = cfl * h / (c_shell + |v|)
dt_shell_rot  = cfl_rot * sqrt(I / (|M| + eps))
dt_shell_acc  = cfl_acc * sqrt(h / (|a_shell| + eps))
dt_shell      = min(dt_shell_wave, dt_shell_rot, dt_shell_acc)

默认 gate 应验证:

  • 无 active Shell 时不影响全局 dt。
  • 有 active Shell 时 Shell dt 有限且为正。
  • 转动或内力矩增大时转动约束可收紧。
  • restart 后 Shell dt 诊断一致。

11.3 与既有模块隔离

Shell 内力、转动力矩和诊断不得改变 Water-only、Gas-only、Explosive-Gas-Water 和 Solid-only 既有算例结果。0.6.0 必须保留 0.5.1 完整回归。

12. 输出和 Restart

12.1 CSV 输出

0.6.0 建议在 summary CSV 中追加或确认以下字段:

  • shell_particles
  • shell_failed_particles
  • shell_mass
  • shell_momentum
  • shell_kinetic_energy
  • shell_internal_energy
  • shell_max_membrane_strain
  • shell_max_bending_strain
  • shell_max_shear_strain
  • shell_max_von_mises
  • shell_damage_min
  • shell_damage_max
  • shell_softening_min
  • shell_softening_max
  • shell_dt_wave
  • shell_dt_rot
  • shell_dt_accel
  • shell_dtcrit

粒子 CSV 可追加:

  • shell_thickness
  • shell_director_x
  • shell_director_y
  • shell_director_z
  • shell_omega_norm
  • shell_damage
  • shell_softening
  • shell_failure_status

如果字段过多,0.6.0 可优先将完整积分点状态放入 API 和 module tests,CSV 只保留 release gate 最有价值的字段。

12.2 Restart

0.6.0 建议写入 STATE_0_6。必须保存或可恢复:

  • 0.5.1 已有粒子通用状态。
  • Velocity-Verlet 所需 v、a 和 vhalf。
  • Water、Gas、Explosive 和 Solid 既有模块状态。
  • Shell material/section 表或可恢复映射。
  • Shell per-particle 厚度、director、角速度、应变、damage、softening、内能和失效状态。
  • Shell 厚度积分点应力、应变、塑性、温度、damage 和 softening。
  • Shell dt、能量、动量、转动和失效诊断。
  • 输出计数和时间控制状态。

兼容读入:

  • STATE_0_6:完整读回。
  • STATE_0_5_1:读回 0.5.1 状态,并初始化空 Shell 状态。
  • STATE_0_5 及更早可支持状态:初始化空 Shell 状态。

restart 后继续显式步不得重复初始化 Shell thickness、director、omega、积分点状态、damage、softening 或 failure status。

13. API、C ABI、C++、Python 和 CLI

13.1 Fortran API

0.6.0 建议新增或补强:

  • sph_get_shell_counts
  • sph_get_shell_summary
  • sph_get_shell_state
  • sph_get_shell_integration_state
  • sph_get_shell_dt_limits

若积分点状态查询过大,Fortran API 可拆分为计数查询、summary 查询、粒子级 caller-allocated buffer 查询和积分点 caller-allocated buffer 查询。

13.2 C ABI

C ABI 应保持追加式扩展。建议新增:

int sphlite_get_shell_summary(int *active_count,
                              int *failed_count,
                              double *values,
                              int value_capacity);

int sphlite_get_shell_particle_state(int max_particles,
                                     double *values,
                                     int value_capacity,
                                     int *failure_status,
                                     int *integration_point_count,
                                     int *count);

int sphlite_get_shell_integration_state(int max_particles,
                                        int max_integration_points,
                                        double *values,
                                        int value_capacity,
                                        int *count);

建议 Shell 粒子级 values 至少包含:

  • 厚度。
  • director 3 分量。
  • omega 3 分量。
  • membrane strain 3 分量。
  • bending strain 3 分量。
  • shear strain 2 分量。
  • damage。
  • softening。

积分点状态展开顺序应明确锁定,例如:

  • values[component + ncomp * (ip + max_ip * particle)]

空指针、非正容量、未初始化状态和小容量必须走既有错误路径。

13.3 C++ wrapper 和 Python ctypes

C++ 和 Python 继续做 C ABI 薄包装,不重新定义 Shell 物理语义。Python checker 应覆盖:

  • Shell summary 查询。
  • Shell particle state 查询。
  • Shell integration point state 查询。
  • Shell 小模型 inspect/run。
  • STATE_0_6 restart 读回。
  • STATE_0_5_1 restart 兼容读入后的空 Shell 默认状态。

13.4 CLI

CLI inspect/run 可追加:

  • shell_particles
  • shell_failed_particles
  • shell_mass
  • shell_max_membrane_strain
  • shell_max_bending_strain
  • shell_max_shear_strain
  • shell_max_von_mises
  • shell_damage_range
  • shell_softening_range
  • shell_dt_limits

CLI 测试应覆盖:

  • Shell 0.6.0 输入 inspect。
  • Shell-only 小模型 run。
  • Shell restart 读回 inspect 或 run。
  • Shell 错误输入。

14. 测试计划

14.1 新增 0.6.0 测试

建议新增以下测试:

  • input_shell_section:Shell material、Shell section、厚度、积分点和剪切修正参数读取。
  • input_shell_errors:缺密度、非法厚度、非法积分点、非 Shell material section 和缺 Shell section error 路径。
  • shell_state_build:Shell 状态数组分配、默认值、active/failed 计数和非 Shell 安全默认值。
  • shell_section_integration:3 点和 5 点厚度积分坐标、权重和默认选择。
  • shell_director_update:director 初始化、归一化、退化错误和受控更新。
  • shell_rotation_kinematics:角速度、转动惯量或等价转动状态。
  • shell_membrane_strain:刚体平动零膜应变和单轴拉伸膜应变。
  • shell_bending_strain:受控曲率场下弯曲应变。
  • shell_shear_strain:Mindlin-Reissner 横向剪切应变方向和量级。
  • shell_elastic_material:Shell 积分点弹性退化路径。
  • shell_johnson_cook_flow:Shell 积分点 Johnson-Cook flow 路径。
  • shell_johnson_cook_failure:Shell 积分点 damage 和 failure status。
  • shell_progressive_softening:Shell damage/softening 单调性和范围限制。
  • shell_internal_force_smoke:Shell 最小内力和内力矩有限性。
  • shell_stable_dt:Shell 平动、转动和加速度 dt 约束。
  • shell_explicit_smoke:Shell-only 小模型 Velocity-Verlet 显式推进。
  • shell_output:summary CSV 和粒子 CSV 的 Shell 字段。
  • shell_restart_060:STATE_0_6 写入读回并继续显式步。
  • shell_restart_051_compat:STATE_0_5_1 兼容读入并初始化空 Shell 状态。
  • shell_api:Fortran API 的 Shell summary、state 和 integration state 查询。
  • shell_c_api:C ABI 的 Shell summary、state、空指针和小容量错误路径。
  • shell_python:Python ctypes 的 Shell 0.6.0 诊断和 restart 读回。
  • shell_cli:CLI 的 Shell inspect/run/restart 字段。
  • shell_source_size:Shell 0.6.0 source size 和 stale exception 检查。

14.2 既有回归测试

0.6.0 必须继续通过 0.5.1 完整 gate,包括:

  • Water gate。
  • Gas gate。
  • Explosive gate。
  • Solid 0.5.0 gate。
  • Solid 0.5.1 gate。
  • output/restart gate。
  • C API/C++/Python/CLI gate。
  • source size gate。

14.3 建议 0.6.0 Release Gate

建议 0.6.0 默认 gate 为:

cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_solid_material|input_solid_errors|solid_state_build|solid_elastic_material|solid_johnson_cook_flow|solid_johnson_cook_failure|solid_progressive_softening|solid_gradient_correction|solid_stable_dt|solid_explicit_smoke|solid_output|solid_restart_050|solid_restart_041_compat|solid_c_api|solid_python|solid_cli|solid_source_size)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(solid_051_input_validation|solid_reference_neighbor|solid_correction_matrix|solid_velocity_gradient|solid_strain_increment|solid_internal_force_pair|solid_uniform_stress_balance|solid_softening_force|solid_energy_diagnostics|solid_dt_acceleration|solid_restart_051|solid_restart_050_compat|solid_state_api|solid_python_051|solid_cli_051|solid_051_source_size)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_shell_section|input_shell_errors|shell_state_build|shell_section_integration|shell_director_update|shell_rotation_kinematics|shell_membrane_strain|shell_bending_strain|shell_shear_strain|shell_elastic_material|shell_johnson_cook_flow|shell_johnson_cook_failure|shell_progressive_softening|shell_internal_force_smoke|shell_stable_dt|shell_explicit_smoke|shell_output|shell_restart_060|shell_restart_051_compat|shell_api|shell_c_api|shell_python|shell_cli|shell_source_size)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure
git diff --check

15. 建议开发阶段

若后续根据本计划生成 todo.md,建议按以下阶段拆分:

  1. 0.6.0 版本号、0.5.1 发布基线和文档范围确认。
  2. Shell 0.6.0 输入样例、错误输入样例和小型 smoke 样例准备。
  3. Shell material 和 Shell section 输入解析。
  4. Shell 输入校验、warning/error 和 set/material/section 边界。
  5. Shell 粒子级状态数组分配、初始化和释放。
  6. Shell 厚度积分点状态数组分配、初始化和释放。
  7. Shell section 厚度、3/5 积分点和剪切修正参数。
  8. director 初始化、归一化、退化检查和基础更新。
  9. Shell 角速度、转动惯量和转动诊断状态。
  10. Shell 参考面积或等效面积、质量和惯量初始化。
  11. 膜应变计算和刚体平动回归。
  12. 弯曲应变计算和受控曲率测试。
  13. 横向剪切应变计算和退化测试。
  14. 厚度积分点弹性材料点路径。
  15. 厚度积分点 Johnson-Cook flow 路径。
  16. 厚度积分点 Johnson-Cook failure、damage 和 softening 路径。
  17. Shell 失效不可逆、PHASE_SHELL_FAILED 和不删除粒子策略。
  18. Shell 最小内力和内力矩贡献。
  19. Shell 能量、动量、转动、damage/softening 和应变诊断。
  20. Shell 平动、转动和加速度稳定时间步。
  21. Shell 接入 Velocity-Verlet 显式推进。
  22. Shell summary CSV 和粒子 CSV 字段扩展。
  23. STATE_0_6 restart 写入。
  24. STATE_0_6 restart 读回。
  25. STATE_0_5_1 和更早 restart 兼容读入。
  26. Fortran API 和 C ABI 的 Shell summary/state/integration state 查询。
  27. C++ wrapper、Python ctypes 和 CLI 扩展。
  28. source size 复核和必要拆分。
  29. 0.5.1 全量回归和 0.6.0 新增 gate。
  30. README、06、09 和 11 号文档同步。

16. 验收标准

0.6.0 应满足以下验收标准:

  1. 软件版本为 0.6.0。
  2. 0.5.1 release gate 继续通过。
  3. Shell material 和 Shell section 输入校验路径清晰。
  4. Shell 厚度、director、omega、膜/弯/剪应变、积分点状态、damage、softening 和 failure status 可初始化和查询。
  5. 3 点和 5 点厚度积分可用,默认 3 点。
  6. director 在受控小模型中初始化、归一化和更新正确。
  7. 膜应变、弯曲应变和横向剪切应变在受控小算例中与预期一致。
  8. Shell 积分点材料更新可走弹性和 Johnson-Cook 路线。
  9. Shell damage、softening 和 PHASE_SHELL_FAILED 不可逆,且不删除粒子、不改变质量。
  10. 最小 Shell 内力和内力矩路径可运行,并通过零应力、刚体平动和受控小模型测试。
  11. Shell 能量、动量、转动、最大应变、damage/softening 和 dt 诊断可用。
  12. Shell dt 约束有限为正,并可进入全局 dt 估计。
  13. STATE_0_6 restart 可恢复 Shell 0.6.0 状态并继续显式步。
  14. STATE_0_5_1 restart 可兼容读入,并初始化空 Shell 状态。
  15. Shell summary、particle state 和 integration state 的 Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 字段可用。
  16. 默认 gate、0.5.1 回归 gate、0.6.0 Shell gate、source size 和 git diff --check 通过。
  17. 文档不宣称 0.6.0 已实现真实水-气-结构爆炸响应、真实 FEM-SPH 耦合或工程级结构破坏 benchmark。
  18. 文档明确 0.6.0 只交付 Shell 最小闭环,不交付完整撕裂路径追踪、穿孔或碎片云。
  19. 不新增 FEMLite 直接依赖。
  20. 不修改 SPHLite 文件夹之外的内容。

17. 风险与控制

风险 表现 控制方式
0.6.0 范围膨胀 试图进入水-气-结构工程爆炸、FEM-SPH 耦合或完整穿孔撕裂 限定为 Shell 小型结构算法闭环
Shell 与 Solid 边界混淆 Shell 复用 Solid 状态或 API 语义导致接口不清 Shell 独立 section、状态、restart 和 API;只复用通用数学/材料辅助
director 退化 法向无法推断、长度为零或非有限 输入校验、几何推断失败报 error、更新后归一化
厚度积分状态膨胀 积分点状态堆入单个大文件,source size 失败 按 shell_state、shell_section、shell_kinematics、shell_material、shell_restart、shell_api 拆分
Mindlin-Reissner 运动学错误 膜/弯/剪应变方向或量级错误 刚体平动、单轴拉伸、受控曲率和剪切小模型 gate
内力和内力矩不稳 小模型中出现非物理加速度或转动漂移 先做零应力、刚体平动、对称布置和有限性测试
Shell 更新影响既有算例 无 Shell 输入时仍进入 Shell 路径 无 active Shell 时直接跳过,并保持 0.5.1 全量回归
restart 不完整 读回后 director、积分点状态或 failure status 丢失 STATE_0_6 保存完整 Shell 持久状态
API 兼容破坏 修改既有 C ABI 字段或数组约定 新增 Shell API,不改变既有 Water/Gas/Explosive/Solid 接口含义

18. 0.7.0 启动条件

满足以下条件后,可以启动 0.7.0 水-气-结构局部爆炸 smoke:

  1. 0.6.0 Shell 输入、状态、运动学、厚度积分、材料点和显式推进 gate 稳定。
  2. Shell output、restart、API、CLI 和 Python 诊断稳定。
  3. 0.5.1 Water/Gas/Explosive/Solid gate 仍可重复通过。
  4. Shell 和 Solid 的失效/softening 状态不删除粒子、不改变质量,并可在 restart 后恢复。
  5. 文档明确 0.6.0 尚未实现真实 FEM-SPH 耦合、工程级水下爆炸结构破坏 benchmark、完整撕裂路径追踪和碎片云。