# 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` 板壳粒子小型结构动力学闭环: ```text 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 建议建立以下粒子级状态: ```fortran 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,可采用压缩数组或三维数组: ```fortran 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 路线。弹性材料点可作为退化路径和单元测试基础。 材料更新建议路径: ```text 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 约束建议包括: ```text 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 应保持追加式扩展。建议新增: ```c 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 为: ```powershell 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、完整撕裂路径追踪和碎片云。