635 lines
29 KiB
Markdown
635 lines
29 KiB
Markdown
# 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、完整撕裂路径追踪和碎片云。
|