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

24 KiB
Raw Permalink Blame History

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 最小闭环:

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 ... 扩展。

建议最小输入形式:

*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 关键词:

*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 状态

建议第一阶段保存:

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 流动应力建议采用:

sigma_y = (A + B * eps_p^n)
          * (1 + C * ln(epsdot_p / epsdot0))
          * (1 - Tstar^m)

其中:

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 损伤累积建议采用:

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 建议第一版使用线性软化:

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 的显式步建议顺序:

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 结构波速约束建议为:

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 应保持追加式扩展。建议新增:

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 为:

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。