630 lines
24 KiB
Markdown
630 lines
24 KiB
Markdown
# 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。
|