Files
SPHLite/docs/v5.0_development_plan.md
T
2026-07-03 14:25:14 +08:00

630 lines
24 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# SPHLite v5.0 开发计划
文档状态:0.5.0 开发计划草案
目标软件版本:SPHLite 0.5.0
## 1. 文档定位
本文档用于规划 SPHLite 0.5.0 版本的开发范围。0.5.0 是 `Solid` 版本线的起步版本,目标是在 0.4.1 已完成 `Water`、`Gas`、`Explosive` 最小稳定闭环的基础上,建立 3D 实体结构 SPH 粒子的输入、状态、本构、失效、显式推进、restart、接口和测试 gate。
0.5.0 不作为完整水-气-结构爆炸响应版本,也不作为 `Shell` 或 FEM-SPH 耦合版本。0.5.0 的重点是让 `Solid` 具备可独立验证的结构材料和显式动力学最小闭环,使后续 0.6 `Shell`、0.7 水-气-结构 smoke 和 0.8/0.9 耦合版本能够依赖稳定的结构粒子状态与接口。
## 2. 依据文件
本计划依据以下文件制定:
- `README.md`
- `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`
- `docs/v4.1_development_plan.md`
- `docs/09_release_history.md`
- `docs/10_development_roadmap.md`
- `docs/11_benchmark_matrix.md`
## 3. 版本定位
### 3.1 与 0.4.1 的关系
0.4.1 已完成 `Explosive` 稳定化:
- 多点点火和多炸药 material 输入。
- 基于冻结反应质量的释放量统计。
- release balance、SOURCE/PHASE 诊断。
- Water/Gas/Explosive 混合 smoke。
- `STATE_0_4_1` restart 和 `STATE_0_4` 兼容读入。
- release balance 的 Fortran API、C ABI、C++ wrapper、Python ctypes、CLI 和专项 gate。
- 完整 CTest、Explosive 专项 gate、source size 和 `git diff --check` 均已通过。
0.5.0 不重写 `Water`、`Gas` 或 `Explosive` 路线。0.5.0 必须保持 0.4.1 全量 gate 稳定,并在此基础上新增 `Solid` 能力。`Solid` 加入后不得改变 Water-only、Gas-only、Explosive-Gas-Water 算例的既有结果和接口语义。
### 3.2 与 0.6.0 的关系
0.6.0 建议作为 `Shell` 版本线起点。0.5.0 不实现 Mindlin-Reissner 板壳、厚度积分、director/角速度或板壳撕裂。0.5.0 可以在 material、section、phase/status 和 restart 中保留 `Shell` 已有占位,但不得宣称已实现板壳结构响应。
### 3.3 与耦合版本的关系
真实 FEM-SPH 接触耦合和连续体耦合仍属于后续 0.8/0.9。0.5.0 只维护 SPHLite 内部 `Solid` 粒子状态和中立 `CouplingInterface` 既有边界,不直接依赖 FEMLite,不修改 FEMLite,也不引入外部 CouplingModule 作为依赖。
### 3.4 0.5.0 核心目标
0.5.0 的核心目标是形成 3D `Solid` 最小闭环:
```text
Solid input/material/section
-> Solid particle state allocation
-> reference configuration and neighbor/correction state
-> elastic and Johnson-Cook material-point update
-> Johnson-Cook damage and progressive softening
-> Solid explicit step and stable dt contribution
-> Solid output/restart/API/CLI/Python diagnostics
-> 0.4.1 full regression remains stable
```
## 4. 开发原则
### 4.1 保持 0.5 版本线边界
0.5.0 只交付 3D `Solid` 实体结构粒子的最小闭环,不进入 `Shell`、真实水-气-结构耦合、真实 FEM-SPH 耦合或工程级船舱破坏 benchmark。
### 4.2 保持求解器定位
SPHLite 仍是求解器,不负责几何建模、网格生成或粒子生成。新增 `.inp` 样例和 Python 脚本只能作为测试/示例辅助工具,不作为求解器功能宣传。
### 4.3 保持 Fortran 95 和集中型数据管理
核心实现继续使用 Fortran 95。`Solid` 状态应纳入集中数据库和模块级状态管理,不采用面向对象粒子类设计。C ABI、C++ wrapper、Python ctypes 和 CLI 继续作为薄接口层。
### 4.4 保持显式动力学主流程
时间推进继续只支持 Velocity-Verlet 显式动力学。0.5.0 可新增 `Solid` 结构波速稳定时间步约束和结构内力更新,但不引入隐式求解、静力求解、非线性静力求解或隐式-显式混合接口。
### 4.5 先材料点和小型结构闭环,再工程破坏
Johnson-Cook 材料模型和失效模型必须先通过材料点、小型均匀变形和小型结构 smoke 验收。0.5.0 不追求复杂断裂路径、碎片云、焊缝失效或工程级舱段破坏。
### 4.6 不破坏既有接口
C ABI 必须追加式扩展。不得改变 0.4.1 已有函数的字段含义、数组长度约定或错误码语义。新增 `Solid` 诊断应优先使用新增函数和新增 CLI/Python 字段。
## 5. 0.5.0 交付目标
0.5.0 建议交付以下内容:
1. 将软件版本更新为 `0.5.0`。
2. 保持 0.4.1 默认 gate 全部通过。
3. 新增 `TYPE=SOLID` material 输入识别和 Solid section 识别。
4. 支持 Solid material 的密度、弹性参数和 Johnson-Cook 参数读取。
5. 支持 Johnson-Cook 失效参数读取,并为渐进软化保留输入或默认策略。
6. 新增 `Solid` 模块生命周期:reset、allocate/build、advance、finalize。
7. 新增 Solid per-particle 状态数组,包括应力、应变、塑性应变、塑性应变率、温度、损伤、软化和失效状态。
8. 建立参考构型相关状态,包括参考坐标、参考体积、参考邻域或修正梯度所需矩阵。
9. 实现弹性材料点更新,作为 Johnson-Cook 调试和回归退化路径。
10. 实现 Johnson-Cook 流动应力材料点计算。
11. 实现 Johnson-Cook 损伤累积和失效判据的最小闭环。
12. 实现失效后的渐进软化,不删除粒子,使用 `PHASE_SOLID_FAILED` 和 status 表达失效。
13. 实现小型 Solid 显式推进路径,至少能处理 Solid-only 小模型的内力、体力或受控均匀变形 smoke。
14. 将 Solid 结构波速或等价稳定时间步约束纳入 `sph_estimate_stable_dt`。
15. 新增 Solid summary,包括质量、动量、动能、内能、最大应力、塑性应变范围、损伤范围和失效粒子数。
16. 在粒子 CSV 和 summary CSV 中追加 Solid 诊断字段。
17. 将 0.5.0 restart 状态版本更新为 `STATE_0_5`,保存 Solid material 表、Solid 状态和诊断。
18. 保持 `STATE_0_4_1`、`STATE_0_4` 和 `STATE_0_3_1` 等既有 restart 兼容读入,并初始化空 Solid 状态。
19. 新增 Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 的 Solid summary 查询。
20. 新增 0.5.0 Solid 专项 CTest gate,并保持 source size 受控。
21. 更新 README、06、09 和 11 号文档中的 0.5.0 测试和验收记录。
22. 不新增 FEMLite 直接依赖,不修改 SPHLite 文件夹之外的内容。
## 6. 非交付范围
0.5.0 不交付以下内容:
1. 不实现 `Shell` Mindlin-Reissner 生产求解路径。
2. 不实现板壳厚度积分、director 更新、板壳撕裂或穿孔。
3. 不实现真实水-气-结构耦合载荷闭环。
4. 不实现爆炸载荷作用下的船体破坏工程 benchmark。
5. 不实现真实 FEM-SPH 接触耦合或连续体耦合。
6. 不实现生产级断裂面追踪、裂纹扩展、碎片云或焊缝失效库。
7. 不实现复杂接触、碰撞、摩擦或碎片-流体相互作用。
8. 不实现热传导、熔化、相变或完整热-力耦合。
9. 不实现大规模并行、GPU 后端或性能优化版本。
10. 不新增几何、网格或粒子生成能力。
## 7. 输入范围
### 7.1 Solid material 识别
0.5.0 应复用 Abaqus 风格 `.inp` 子集。能复用 Abaqus 关键词时不新增关键词;Abaqus 难以表达的 SPHLite 专有行为才使用 `*SPHLITE ...` 扩展。
建议最小输入形式:
```text
*MATERIAL, NAME=STEEL, TYPE=SOLID
*DENSITY
7850.0
*ELASTIC
210.0E9, 0.30
*PLASTIC, HARDENING=JOHNSON COOK
A, B, N, C, M, EPSDOT0, TROOM, TMELT
*DAMAGE INITIATION, CRITERION=JOHNSON COOK
D1, D2, D3, D4, D5
*SPHLITE SOLID CONTROL, MATERIAL=STEEL, SOFTENING=LINEAR
```
如果现有输入层更适合使用已建立的 `*SPHLITE ...` material/control 风格,0.5.0 可在实现阶段收敛语法,但必须满足:
- material 可明确识别为 `Solid`。
- 密度缺失时报 error。
- 弹性参数缺失时报 error。
- Johnson-Cook 参数缺失或非法时报 error。
- Johnson-Cook 失效参数缺失时,若本算例请求失效,则报 error。
- 不影响运行的 Abaqus 未支持关键词继续 warning。
### 7.2 Solid section
3D 实体结构粒子通过 material 识别为 `Solid`,通过 section 识别实体 section 属性。建议支持 Abaqus 风格 `*SOLID SECTION` 或既有等价 section 关键词:
```text
*SOLID SECTION, ELSET=HULL_SOLID, MATERIAL=STEEL
```
set 仍只表示集合,不作为类型判断依据。`Solid` 的计算行为必须由 phase、material 和 section 共同确定。
### 7.3 初始条件和边界
0.5.0 可复用既有粒子位置、速度、体力和时间控制输入。结构专项测试可使用:
- 初始速度或体力驱动。
- 小型均匀拉伸/压缩速度场。
- 简化约束或固定粒子 status。
0.5.0 不要求实现完整边界条件库、接触边界或 FEM 驱动边界。
## 8. Solid 状态设计
### 8.1 模块级 material 状态
建议新增 Solid material 表,至少保存:
- material id 和名称映射。
- 密度 `rho0`。
- 弹性模量 `E`。
- 泊松比 `nu`。
- 剪切模量 `G`。
- 体积模量 `K`。
- 参考声速或结构波速。
- Johnson-Cook 流动参数 `A`、`B`、`n`、`C`、`m`。
- 参考应变率 `epsdot0`。
- 室温 `Troom` 和熔化温度 `Tmelt`。
- 比热或等效温升参数。
- Taylor-Quinney 系数或等效塑性功转温升系数。
- Johnson-Cook 失效参数 `D1` 到 `D5`。
- 软化模型类型和软化参数。
### 8.2 每粒子 Solid 状态
建议第一阶段保存:
```fortran
real(rk), allocatable :: solid_stress(:,:)
real(rk), allocatable :: solid_strain(:,:)
real(rk), allocatable :: solid_plastic_strain(:)
real(rk), allocatable :: solid_plastic_strain_rate(:)
real(rk), allocatable :: solid_temperature(:)
real(rk), allocatable :: solid_damage(:)
real(rk), allocatable :: solid_softening(:)
real(rk), allocatable :: solid_internal_energy(:)
real(rk), allocatable :: solid_deformation_gradient(:,:,:)
real(rk), allocatable :: solid_correction_matrix(:,:,:)
integer, allocatable :: solid_failure_status(:)
```
其中:
- `solid_stress(6,npart)` 使用 Voigt 顺序,建议为 `xx, yy, zz, xy, yz, zx`。
- `solid_strain(6,npart)` 保存可恢复的总应变或等价应变状态。
- `solid_deformation_gradient(3,3,npart)` 保存变形梯度或等价 Total Lagrangian 状态。
- `solid_correction_matrix(3,3,npart)` 保存参考构型梯度修正或其占位。
- `solid_damage(i)` 范围为 `[0,1]`。
- `solid_softening(i)` 表示承载能力折减因子,范围为 `[0,1]`。
- `solid_failure_status(i)` 表达未失效、软化中、已失效等状态。
如果实现阶段为了保持 Fortran 95 和 source size 控制而拆分数组,语义必须保持可恢复、可诊断和可测试。
### 8.3 phase 和 status
0.5.0 应使用已规划的 phase/status:
- active Solid 粒子:`PHASE_SOLID`。
- 失效 Solid 粒子:`PHASE_SOLID_FAILED`。
- 失效不删除粒子。
- phase/status 改变是不可逆历史过程。
失效粒子在 0.5.0 中可以继续保留质量、动量和输出状态。其后续接触、碎片或流体相互作用留给后续版本。
## 9. 本构与失效模型
### 9.1 弹性退化路径
0.5.0 应先实现弹性退化路径,用于材料点和 Solid-only smoke:
- 读取 `E` 和 `nu`。
- 计算 `G`、`K` 或 Lamé 参数。
- 由应变增量更新 Cauchy 应力或等价应力。
- 输出应力、应变、内能和稳定时间步诊断。
弹性路径是调试和回归工具,不替代 Johnson-Cook 主路线。
### 9.2 Johnson-Cook 流动应力
Johnson-Cook 流动应力建议采用:
```text
sigma_y = (A + B * eps_p^n)
* (1 + C * ln(epsdot_p / epsdot0))
* (1 - Tstar^m)
```
其中:
```text
Tstar = clamp((T - Troom) / (Tmelt - Troom), 0, 1)
```
0.5.0 可允许等温退化测试,此时 `T = Troom`,热软化项为 1。即使第一版采用等温退化,数据库和 restart 仍必须保存温度状态。
### 9.3 塑性更新
0.5.0 建议采用小步显式返回映射或等价稳定的材料点更新:
- 计算试应力。
- 计算 von Mises 等效应力。
- 判断屈服。
- 更新等效塑性应变和等效塑性应变率。
- 更新应力和塑性功。
- 更新温度或等效温升占位。
第一版测试应覆盖弹性区、屈服后硬化区和应变率项。
### 9.4 Johnson-Cook 失效
Johnson-Cook 损伤累积建议采用:
```text
D = D + delta_eps_p / eps_f
```
失效应变 `eps_f` 由 Johnson-Cook 失效参数、应力三轴度、应变率和温度项计算。0.5.0 可先实现最小可测路径:
- 对单轴拉伸或给定三轴度材料点计算 `eps_f`。
- 损伤 `D` 单调增加。
- `D >= 1` 时进入失效或软化状态。
- 非法 `eps_f <= 0` 或非有限值时报 error 或受控保护。
### 9.5 渐进软化
失效后采用渐进软化,不瞬时删除粒子。0.5.0 建议第一版使用线性软化:
```text
softening = max(0, 1 - (D - 1) / softening_width)
effective_stress = softening * stress
```
具体公式可在实现阶段微调,但必须满足:
- 软化因子单调不增。
- 软化因子限制在 `[0,1]`。
- 失效状态不可逆。
- 输出和 restart 可恢复软化状态。
## 10. Solid SPH 算法范围
### 10.1 Total/Corrected Lagrangian 路线
0.5.0 应沿用 04 号文档的 Total Lagrangian / corrected Lagrangian SPH 路线。建议第一版至少建立:
- 参考邻域或参考构型权重。
- 梯度修正矩阵或其稳定占位。
- 变形梯度或速度梯度计算入口。
- 内力和能量诊断入口。
如果第一版完整 TL-SPH 内力实现风险过大,可以采用小型、受控的 corrected gradient smoke 作为最小闭环,但必须保留状态和测试边界,避免文档宣称工程级结构响应。
### 10.2 Solid 显式步
0.5.0 的显式步建议顺序:
```text
Velocity-Verlet predictor
Water/Gas/Explosive updates when active
Solid kinematic gradient update
Solid constitutive update
Solid internal force and acceleration contribution
External body force contribution
Velocity-Verlet corrector
Diagnostics/output/restart hooks
```
Water-only、Gas-only、Explosive-only 算例不应进入 Solid 更新路径。Solid-only 算例应可在无 Water/Gas/Explosive 输入时单独推进。
### 10.3 Solid 稳定时间步
Solid 结构波速约束建议为:
```text
dt_solid = cfl * h / (c_solid + |v|)
```
其中 `c_solid` 可由弹性参数估计。0.5.0 gate 应验证:
- 无 Solid 粒子时不影响既有 dt。
- Solid 粒子存在时 dt 为有限正值。
- 不同材料参数可改变 Solid dt 限制。
### 10.4 Solid 诊断
Solid summary 建议包括:
- active Solid 粒子数。
- failed Solid 粒子数。
- Solid 总质量。
- Solid 总动量。
- Solid 动能。
- Solid 内能。
- 最大 von Mises 应力。
- 等效塑性应变最小值和最大值。
- 损伤最小值和最大值。
- 最小 softening 因子。
- Solid dt 限制。
## 11. API、C ABI、C++、Python 和 CLI
### 11.1 Fortran API
建议新增:
- `sph_get_solid_summary`
- `sph_get_solid_material_summary`
- `sph_get_solid_state`
- `sph_solid_get_failure_counts`
若实现阶段认为完整 state 查询会导致接口过大,0.5.0 可先交付 summary 和 failure counts,粒子级详细状态通过 CSV 和 restart 验收。
### 11.2 C ABI
C ABI 应保持追加式扩展。建议新增:
```c
int sphlite_get_solid_summary(int *active_count,
int *failed_count,
double *mass,
double *momentum,
double *energy_values,
double *stress_values,
double *damage_values);
```
建议字段:
- `momentum[0..2]`:Solid 总动量。
- `energy_values[0]`:动能。
- `energy_values[1]`:内能。
- `stress_values[0]`:最大 von Mises 应力。
- `stress_values[1]`:最大压力或平均等效应力。
- `damage_values[0]`:最小 damage。
- `damage_values[1]`:最大 damage。
- `damage_values[2]`:最小 softening。
所有输出数组由调用方分配。空指针、非正容量或未初始化状态必须走既有错误路径。
### 11.3 C++ wrapper 和 Python ctypes
C++ 和 Python 继续做 C ABI 薄包装,不重新定义 Solid 物理语义。Python checker 应覆盖:
- Solid material inspect。
- Solid summary 查询。
- Solid run 后 damage/stress 字段。
- Solid restart 读回后的 summary 一致性。
### 11.4 CLI
CLI inspect/run 应追加 Solid 字段:
- `solid_active_particles`
- `solid_failed_particles`
- `solid_mass`
- `solid_max_von_mises`
- `solid_plastic_strain_max`
- `solid_damage_max`
- `solid_dt_limit`
CLI 测试应覆盖:
- Solid 输入 inspect。
- Solid-only 小模型 run。
- Solid 错误输入。
- Solid restart 读回 inspect 或 run。
## 12. 输出和 Restart
### 12.1 CSV 输出
0.5.0 建议在 summary CSV 中追加 Solid 字段:
- `solid_active_particles`
- `solid_failed_particles`
- `solid_mass`
- `solid_momentum_x`
- `solid_momentum_y`
- `solid_momentum_z`
- `solid_kinetic_energy`
- `solid_internal_energy`
- `solid_max_von_mises`
- `solid_plastic_strain_min`
- `solid_plastic_strain_max`
- `solid_damage_min`
- `solid_damage_max`
- `solid_softening_min`
- `solid_dt_limit`
粒子 CSV 可追加:
- `solid_stress_xx`
- `solid_stress_yy`
- `solid_stress_zz`
- `solid_stress_xy`
- `solid_stress_yz`
- `solid_stress_zx`
- `solid_plastic_strain`
- `solid_damage`
- `solid_softening`
- `solid_failure_status`
如果粒子 CSV 字段过多,0.5.0 可先输出关键字段,并通过 restart/module test 覆盖完整内部状态。
### 12.2 Restart
0.5.0 restart 建议写入 `STATE_0_5`。必须保存:
- 粒子通用状态。
- Velocity-Verlet 所需 `v`、`a`、`vhalf`。
- Water、Gas、Explosive 既有状态。
- Solid material 表。
- Solid per-particle 状态。
- Solid 诊断和 dt 状态。
- 未来 Shell/CouplingInterface 已有占位状态。
兼容读入:
- `STATE_0_5`:完整读回。
- `STATE_0_4_1`:初始化空 Solid 状态。
- `STATE_0_4`:初始化空 Solid 状态,并保持 Explosive 兼容读入。
- `STATE_0_3_1` 及更早可支持状态:初始化空 Solid 状态。
restart 后继续显式步不得重复初始化 Solid 应力、塑性应变、损伤或失败状态。
## 13. 测试计划
### 13.1 新增 0.5.0 测试
建议新增以下测试:
- `input_solid_material`:Solid material、elastic、Johnson-Cook 和 Solid section 输入。
- `input_solid_errors`:缺密度、缺弹性参数、非法 Johnson-Cook 参数、非法 section。
- `solid_state_build`:Solid 状态分配、phase/material/section 识别和默认值。
- `solid_elastic_material`:弹性材料点应力更新。
- `solid_johnson_cook_flow`:Johnson-Cook 流动应力、硬化、应变率项和热项退化。
- `solid_johnson_cook_failure`:Johnson-Cook 损伤累积和失效阈值。
- `solid_progressive_softening`:失效后软化单调、不可逆且不删除粒子。
- `solid_gradient_correction`:参考构型梯度修正或等价占位状态可构建。
- `solid_stable_dt`:Solid 结构波速 dt 约束。
- `solid_explicit_smoke`:Solid-only 小模型可显式推进。
- `solid_output`:summary CSV 和粒子 CSV 的 Solid 字段。
- `solid_restart_050`:`STATE_0_5` 写入读回并继续显式步。
- `solid_restart_041_compat`:`STATE_0_4_1` 兼容读入并初始化空 Solid 状态。
- `solid_c_api`:C ABI Solid summary 查询和错误路径。
- `solid_python`:Python ctypes Solid summary 和 run/inspect 字段。
- `solid_cli`:CLI inspect/run 输出 Solid 字段。
- `solid_source_size`:Solid 模块 source size 和 stale exception 检查。
### 13.2 既有回归测试
0.5.0 必须继续通过 0.4.1 完整 gate,包括:
- Water gate。
- Gas gate。
- Explosive 0.4.0 gate。
- Explosive 0.4.1 gate。
- output/restart gate。
- C API/C++/Python/CLI gate。
- source size gate。
### 13.3 建议 0.5.0 Release Gate
建议 0.5.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 "^source_size$" --output-on-failure
git diff --check
```
## 14. 建议开发阶段
若后续根据本计划生成 `todo.md`,建议按以下阶段拆分:
1. 0.5.0 版本号和 0.4.1 发布基线确认。
2. Solid 输入样例和错误输入样例准备。
3. Solid material/section 输入解析。
4. Solid material 表和 Johnson-Cook 参数存储。
5. Solid per-particle 状态数组和生命周期。
6. Solid phase/status 默认值和失效状态枚举复核。
7. 弹性材料点更新和单测。
8. Johnson-Cook 流动应力材料点和单测。
9. Johnson-Cook 损伤/失效材料点和单测。
10. 渐进软化状态和单测。
11. 参考构型、梯度修正或等价 TL-SPH 状态构建。
12. Solid 内力/体力/显式推进最小 smoke。
13. Solid 稳定时间步估计。
14. Solid summary 和 diagnostics。
15. summary CSV 和粒子 CSV 字段扩展。
16. `STATE_0_5` restart 写入。
17. `STATE_0_5` restart 读回。
18. `STATE_0_4_1` 和更早 restart 兼容读入。
19. Fortran API 和 C ABI 追加接口。
20. C++ wrapper、Python ctypes 和 CLI 扩展。
21. source size 复核和必要拆分。
22. 0.4.1 全量回归和 0.5.0 新增 gate。
23. README、06、09 和 11 号文档同步。
## 15. 验收标准
0.5.0 应满足以下验收标准:
1. 软件版本为 `0.5.0`。
2. 0.4.1 release gate 继续通过。
3. Solid material 和 Solid section 可从 `.inp` 明确识别。
4. 密度、弹性参数、Johnson-Cook 参数和失效参数校验路径清晰。
5. Solid 状态可分配、初始化、清理和重复 build。
6. 弹性材料点测试通过。
7. Johnson-Cook 流动应力测试覆盖硬化、应变率项和热项退化。
8. Johnson-Cook 损伤单调累积,并在达到阈值后触发失效状态。
9. 渐进软化单调、不可逆,且不删除粒子。
10. Solid-only 小模型可执行 Velocity-Verlet 显式推进。
11. Solid 结构波速 dt 约束为有限正值,并可进入全局 dt 估计。
12. Solid summary、CSV output、Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 字段可用。
13. `STATE_0_5` restart 可恢复 Solid 状态并继续显式步。
14. `STATE_0_4_1` restart 可兼容读入,并初始化空 Solid 状态。
15. 默认 gate、0.5.0 Solid 专项 gate、source size 和 `git diff --check` 通过。
16. 文档不宣称 0.5.0 已实现 Shell、真实水-气-结构爆炸响应、真实 FEM-SPH 耦合或工程级结构破坏 benchmark。
17. 不新增 FEMLite 直接依赖。
18. 不修改 SPHLite 文件夹之外的内容。
## 16. 风险与控制
| 风险 | 表现 | 控制方式 |
| --- | --- | --- |
| 0.5.0 范围膨胀 | 试图同时实现 Shell、水-气-结构工程爆炸或 FEM-SPH 耦合 | 限定为 Solid 最小闭环和 Solid-only gate |
| Johnson-Cook 参数语义不稳 | 输入字段顺序、单位或温度项解释不清 | 使用明确输入样例和材料点测试锁定语义 |
| TL-SPH 内力实现过大 | 一次性实现完整结构算法导致 source size 和测试风险 | 先材料点、梯度状态和小型 smoke,逐步扩大 |
| 失效处理破坏质量守恒 | 删除粒子或改变粒子质量导致诊断跳变 | 失效不删除粒子,仅 phase/status 和 softening 改变 |
| Solid 更新影响既有算例 | 无 Solid 输入时仍进入 Solid 路径 | 无 active Solid 时直接跳过,并保持 0.4.1 全量回归 |
| API 兼容破坏 | 修改已有 summary 字段或数组约定 | 新增 Solid API,不改变 0.4.1 接口含义 |
| restart 不完整 | 读回后应力、塑性、损伤或 softening 丢失 | `STATE_0_5` 保存完整 Solid 模块级状态 |
| source size 债务扩大 | Solid 本构、状态和 restart 堆入单个大文件 | 按 state/material/reaction 或 state/material/solid/restart/helper 拆分 |
## 17. 0.6.0 启动条件
满足以下条件后,可以启动 0.6.0 `Shell`:
1. 0.5.0 Solid material、Johnson-Cook 和失效材料点 gate 稳定。
2. Solid 状态、output、restart、API、CLI 和 Python 诊断稳定。
3. Solid-only 显式 smoke 可重复通过。
4. 0.4.1 Water/Gas/Explosive gate 仍可重复通过。
5. 0.5.0 文档明确尚未实现 Shell、真实 FEM-SPH 耦合和工程级水下爆炸结构破坏 benchmark。