From 98d05aa94d6eb1ff84d1035f39c9bc7f461b443c Mon Sep 17 00:00:00 2001 From: Codex Date: Fri, 3 Jul 2026 16:54:45 +0800 Subject: [PATCH] Start 0.5.1 Solid stabilization --- CMakeLists.txt | 2 +- README.md | 7 +- docs/v5.1_development_plan.md | 513 ++++++++++++++++++ src/core/sph_precision.f90 | 2 +- tests/data/solid_bad_johnson_cook_nan_051.inp | 16 + tests/data/solid_bad_poisson_051.inp | 14 + tests/data/solid_bad_softening_051.inp | 15 + tests/data/solid_explicit_smoke_051.inp | 21 + tests/data/solid_force_pair_051.inp | 16 + tests/data/solid_missing_section_051.inp | 13 + tests/data/solid_reference_degenerate_051.inp | 18 + tests/data/solid_reference_normal_051.inp | 22 + tests/data/solid_restart_050_compat_051.inp | 20 + tests/data/solid_restart_051.inp | 25 + tests/data/solid_section_non_solid_051.inp | 13 + tests/data/solid_softening_force_051.inp | 21 + tests/data/solid_uniaxial_velocity_051.inp | 20 + tests/data/solid_uniform_stress_051.inp | 24 + tests/data/solid_uniform_translation_051.inp | 20 + tests/interface/test_c_api.c | 2 +- tests/interface/test_cpp_api.cpp | 2 +- tests/unit/test_smoke.f90 | 2 +- todo.md | 448 ++++++++------- tools/testing/test_cli.py | 4 +- tools/testing/test_python_debug.py | 2 +- 25 files changed, 1054 insertions(+), 208 deletions(-) create mode 100644 docs/v5.1_development_plan.md create mode 100644 tests/data/solid_bad_johnson_cook_nan_051.inp create mode 100644 tests/data/solid_bad_poisson_051.inp create mode 100644 tests/data/solid_bad_softening_051.inp create mode 100644 tests/data/solid_explicit_smoke_051.inp create mode 100644 tests/data/solid_force_pair_051.inp create mode 100644 tests/data/solid_missing_section_051.inp create mode 100644 tests/data/solid_reference_degenerate_051.inp create mode 100644 tests/data/solid_reference_normal_051.inp create mode 100644 tests/data/solid_restart_050_compat_051.inp create mode 100644 tests/data/solid_restart_051.inp create mode 100644 tests/data/solid_section_non_solid_051.inp create mode 100644 tests/data/solid_softening_force_051.inp create mode 100644 tests/data/solid_uniaxial_velocity_051.inp create mode 100644 tests/data/solid_uniform_stress_051.inp create mode 100644 tests/data/solid_uniform_translation_051.inp diff --git a/CMakeLists.txt b/CMakeLists.txt index 002bcdd..dd0d223 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,6 +1,6 @@ cmake_minimum_required(VERSION 3.20) -project(SPHLite VERSION 0.5.0 LANGUAGES C CXX Fortran) +project(SPHLite VERSION 0.5.1 LANGUAGES C CXX Fortran) set(CMAKE_C_STANDARD 99) set(CMAKE_C_STANDARD_REQUIRED ON) diff --git a/README.md b/README.md index cfde3b2..77f4ca6 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。 -当前开发版本:0.5.0。该版本定位为 `Solid` 3D 实体结构粒子起步版本,在 0.4.1 已建立 Water/Gas/Explosive 稳定闭环的基础上,完成 Solid 输入、状态、本构、失效、显式推进、restart、接口和测试 gate 的最小闭环。不交付 `Shell` 的生产路径,也不交付真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行或工程级结构破坏 benchmark。 +当前开发版本:0.5.1。该版本定位为 `Solid` 3D 实体结构粒子稳定化和结构算法加固版本,在 0.5.0 已建立 Solid 最小闭环的基础上,补强参考构型、速度梯度、应变率、最小内力、能量诊断、restart 兼容和接口可观测性。不交付 `Shell` 的生产路径,也不交付真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行或工程级结构破坏 benchmark。 代码仓库地址: @@ -63,7 +63,7 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: ## 当前状态 -0.5.0 当前已在 0.4.1 `Explosive` 稳定化基线之上完成 `Solid` 起步闭环。0.4.1 已完成内容主要包括: +0.5.1 当前在 0.5.0 `Solid` 起步闭环基线之上开展 `Solid` 稳定化和结构算法加固。0.5.0 已完成内容主要包括: - CMake/CTest 工程骨架和 Fortran 95 核心库。 - C ABI、C++ 头文件薄包装和 Python `ctypes` 调试入口。 @@ -78,6 +78,7 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: - 0.5.0 新增 `Solid` 3D 实体结构粒子的 material/section 输入、密度/弹性参数、Johnson-Cook flow/failure 参数、softening 控制和 Solid 输入错误路径。 - 0.5.0 新增 Solid 状态数组、弹性与 Johnson-Cook 材料点、damage 累积、线性渐进软化、结构波速稳定时间步、Solid-only 显式 smoke、CSV 输出和 `STATE_0_5` restart。 - 0.5.0 追加 Solid summary、failure counts、Fortran API、C ABI、C++ wrapper、Python `ctypes`、CLI 字段和 Solid 专项 CTest gate。 +- 0.5.1 计划补强 Solid 参考邻域质量、修正矩阵、变形梯度、速度梯度、应变率、最小内力、softening 力学作用、能量诊断、`STATE_0_5_1` restart 和粒子级状态接口。 - CouplingInterface 的中立数据导出、外部粒子力导入和诊断占位保持可用;真实 FEM-SPH 联合运行仍由外部 CouplingModule 后续实现。 -- `Shell` 仍为后续阶段,不在 0.5.0 交付生产计算路径。 +- `Shell` 仍为后续阶段,不在 0.5.1 交付生产计算路径。 - 0.5.0 本地 gate 已通过:完整 CTest 83/83,0.4.1 Explosive 回归 gate 14/14,0.5.0 Solid 专项 gate 17/17,`source_size` 1/1,`git diff --check` 通过。 diff --git a/docs/v5.1_development_plan.md b/docs/v5.1_development_plan.md new file mode 100644 index 0000000..fe80f25 --- /dev/null +++ b/docs/v5.1_development_plan.md @@ -0,0 +1,513 @@ +# SPHLite v5.1 开发计划 + +文档状态:0.5.1 开发计划草案 + +目标软件版本:SPHLite 0.5.1 + +## 1. 文档定位 + +本文档用于规划 SPHLite 0.5.1 版本的开发范围。0.5.1 是 `Solid` 版本线的稳定化和结构算法加固版本,目标是在 0.5.0 已完成 3D 实体结构粒子输入、状态、本构、失效、显式推进、restart、接口和 gate 最小闭环的基础上,补强 Solid 参考构型、速度梯度、应变率、最小内力、能量诊断、restart 兼容和接口可观测性。 + +0.5.1 不作为 `Shell` 版本,也不作为真实水-气-结构工程爆炸响应版本。0.5.1 的重点是让 `Solid` 从材料点和体力驱动 smoke,推进到更清晰的结构 SPH 算法闭环,使后续 `Shell`、水-气-结构 smoke 和 FEM-SPH 耦合版本能够依赖更稳定的结构粒子力学状态。 + +## 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.5.1 以已发布的 0.5.0 Solid 起步闭环为开发基线。 + +## 3. 版本定位 + +### 3.1 与 0.5.0 的关系 + +0.5.0 已完成以下 Solid 最小闭环: + +- `TYPE=SOLID` material 和 `*SOLID SECTION` 输入识别。 +- Solid 密度、弹性、Johnson-Cook flow/failure 和 softening 参数读取。 +- Solid 应力、应变、塑性应变、温度、damage、softening、内能、失效状态等状态数组。 +- 弹性材料点、Johnson-Cook 材料点、失效 damage 累积和线性渐进软化。 +- Solid-only 显式 smoke、结构波速稳定时间步、CSV 输出和 `STATE_0_5` restart。 +- Solid summary、failure counts、Fortran API、C ABI、C++ wrapper、Python ctypes、CLI 字段和 Solid 专项 gate。 + +0.5.1 不重写 0.5.0 的材料输入和接口边界。0.5.1 应保持 0.5.0 全量 gate 稳定,并在此基础上增强 Solid 结构计算的可测性和可恢复性。 + +### 3.2 与 0.6.0 的关系 + +0.6.0 仍建议作为 `Shell` 版本线起点。0.5.1 不实现 Mindlin-Reissner 板壳生产路径,不实现厚度积分点、director、角速度、板壳撕裂或穿孔。0.5.1 可继续维护 `Shell` phase/status 和 section 占位,但不得宣称已实现板壳结构响应。 + +### 3.3 与耦合版本的关系 + +真实 FEM-SPH 接触耦合和连续体耦合仍属于后续 0.8/0.9。0.5.1 只维护 SPHLite 内部 `Solid` 粒子状态和中立 `CouplingInterface` 边界,不直接依赖 FEMLite,不修改 FEMLite,也不引入外部 CouplingModule 作为依赖。 + +### 3.4 0.5.1 核心目标 + +0.5.1 的核心目标是形成更可靠的 3D `Solid` 小型结构动力学闭环: + +```text +0.5.0 Solid material/state/restart/API baseline + -> reference neighbor and correction quality checks + -> velocity gradient and strain-rate update + -> stress update driven by kinematics + -> stress/softening contribution to internal force + -> energy and momentum diagnostics + -> STATE_0_5_1 restart and STATE_0_5 compatibility + -> 0.5.0 full regression remains stable +``` + +## 4. 开发原则 + +### 4.1 保持 0.5 版本线边界 + +0.5.1 只加固 3D `Solid` 实体结构粒子能力,不进入 `Shell`、真实水-气-结构耦合、真实 FEM-SPH 耦合或工程级船舱破坏 benchmark。 + +### 4.2 保持求解器定位 + +SPHLite 仍是求解器,不负责几何建模、网格生成或粒子生成。新增 `.inp` 样例和 Python 脚本只能作为测试、示例或 checker 辅助工具,不作为求解器功能宣传。 + +### 4.3 保持 Fortran 95 和集中型数据管理 + +核心实现继续使用 Fortran 95。Solid 新状态应纳入集中数据库或 Solid 模块级状态管理,不采用面向对象粒子类设计。C ABI、C++ wrapper、Python ctypes 和 CLI 继续作为薄接口层。 + +### 4.4 保持显式动力学主流程 + +时间推进继续只支持 Velocity-Verlet 显式动力学。0.5.1 可增强 Solid 应变率、内力和能量路径,但不引入隐式求解、静力求解、非线性静力求解或隐式-显式混合接口。 + +### 4.5 小型可测优先 + +Solid 结构算法增强必须先通过小型、可重复测试验收。0.5.1 不追求复杂断裂路径、碎片云、焊缝失效、复杂接触或工程级舱段破坏。 + +### 4.6 不破坏既有接口 + +C ABI 必须追加式扩展。不得改变 0.5.0 已有函数的字段含义、数组长度约定或错误码语义。新增 Solid 粒子级状态查询应采用新函数和 caller-allocated buffer 风格。 + +## 5. 0.5.1 交付目标 + +0.5.1 建议交付以下内容: + +1. 将软件版本更新为 `0.5.1`。 +2. 保持 0.5.0 默认 gate 全部通过。 +3. 加固 Solid material、section、phase/status 的输入校验和 warning/error 路径。 +4. 建立或补强 Solid 参考邻域质量诊断,包括参考邻居数、退化邻域和修正矩阵状态。 +5. 实现 Solid 修正矩阵的有限性、奇异性和条件质量检查。 +6. 实现或补强 Solid 速度梯度计算入口。 +7. 实现 Solid 应变率和应变增量更新入口。 +8. 让弹性和 Johnson-Cook 材料点更新能够由 Solid 运动学增量驱动。 +9. 实现最小 Solid 内力贡献路径,至少覆盖应力散度或等价对称力贡献。 +10. 保证零应力、均匀平动和无 active Solid 粒子时不产生虚假内力。 +11. 保证简单成对或对称粒子布置下内力动量残差受控。 +12. 将 softening 作用到应力或内力贡献路径,并保持失效不可逆。 +13. 加固 Solid 动能、内能、塑性功、damage、softening 和动量诊断。 +14. 新增 Solid 最大应变率、最大加速度或内力残差等调试诊断。 +15. 将 Solid 结构波速和加速度约束继续纳入全局 dt 估计,并覆盖 0.5.0 回归。 +16. 将 restart 状态版本更新为 `STATE_0_5_1`,保存新增 Solid 持久状态和诊断。 +17. 保持 `STATE_0_5` restart 兼容读入,并为新增状态提供安全默认值。 +18. 保持 `STATE_0_4_1`、`STATE_0_4` 和更早可支持状态兼容读入。 +19. 在 summary CSV 和粒子 CSV 中追加必要的 Solid 0.5.1 调试字段。 +20. 新增 Solid 粒子级状态查询 Fortran API 和 C ABI。 +21. 在 C++ wrapper、Python ctypes 和 CLI 中追加 Solid 0.5.1 诊断字段。 +22. 新增 0.5.1 Solid 专项 CTest gate,并保持 source size 受控。 +23. 更新 README、06、09 和 11 号文档中的 0.5.1 测试、验收和不交付范围。 +24. 不新增 FEMLite 直接依赖,不修改 SPHLite 文件夹之外的内容。 + +## 6. 非交付范围 + +0.5.1 不交付以下内容: + +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.1 应保持 0.5.0 已支持的 Solid 输入语法,并加固以下校验: + +- Solid material 必须有正密度。 +- 弹性模量必须为正值。 +- 泊松比必须处于受控范围。 +- Johnson-Cook flow 参数必须有限。 +- 请求 failure 时 Johnson-Cook failure 参数必须完整且有限。 +- softening 类型必须为已支持类型;不支持类型报 error。 +- 未被 active Solid 粒子使用的 Solid material 可 warning,不阻断其他路径运行。 + +### 7.2 Solid section 校验 + +`*SOLID SECTION` 继续作为 3D 实体结构 section 入口。0.5.1 应确认: + +- section 指向的 material 必须存在。 +- Solid section 指向非 Solid material 时应报 error。 +- 缺少 Solid section 且存在 active Solid 粒子时应报 error 或给出明确默认策略。 +- set 仍只表示集合,不作为 Solid 类型判断依据。 + +### 7.3 初始条件和受控小算例 + +0.5.1 的 Solid 小算例可继续使用已有 `*SPHLITE BODY FORCE`、初始速度和时间控制。若需要固定粒子或简化约束,应优先使用现有 status/phase/control 路径,不新增复杂边界条件库。 + +## 8. 参考构型和梯度修正 + +### 8.1 参考邻域 + +Solid 结构计算应以参考构型为主。0.5.1 建议保存或诊断: + +- 每个 active Solid 粒子的参考邻居数。 +- 参考邻域权重和参考体积。 +- 参考邻域是否退化。 +- 与非 Solid 粒子的过滤规则。 + +参考邻域不足时,0.5.1 可先 warning 或报受控 error。默认 gate 应覆盖退化邻域和正常邻域两类路径。 + +### 8.2 修正矩阵 + +0.5.1 建议将 `solid_correction_matrix(3,3,npart)` 从占位推进到可诊断状态: + +- 构建参考梯度矩阵。 +- 判断矩阵有限性。 +- 判断行列式是否接近退化。 +- 保存或统计修正质量指标。 +- 对不可逆矩阵采用受控 fallback,不静默给出错误内力。 + +若 0.5.1 仍不交付完整工程 TL-SPH 修正,应在文档和测试中明确其小型 smoke 范围。 + +### 8.3 变形梯度 + +0.5.1 建议补强 `solid_deformation_gradient(3,3,npart)`: + +- 初始状态为单位阵。 +- 显式步中由速度梯度或位移梯度更新。 +- 受控小变形测试下与解析预期一致。 +- restart 后可恢复。 + +## 9. 运动学、本构和失效耦合 + +### 9.1 速度梯度和应变率 + +0.5.1 建议新增或补强以下计算: + +- `Solid` 速度梯度 `L = grad(v)`。 +- 小应变率或等价对称部分 `D = 0.5 * (L + L^T)`。 +- 旋转部分或 Jaumann 率后续预留。 +- 等效塑性应变率的安全计算。 + +第一版测试应覆盖: + +- 均匀平动下速度梯度为零。 +- 简单拉伸速度场下应变率方向和量级正确。 +- 非 Solid 粒子不污染 Solid 速度梯度。 + +### 9.2 本构更新入口 + +0.5.1 应让材料点更新不再只依赖人工构造增量,而能从 Solid 显式步提供的应变增量进入: + +```text +velocity gradient + -> strain-rate / strain increment + -> elastic trial stress + -> Johnson-Cook flow correction + -> Johnson-Cook damage update + -> progressive softening + -> stress used by internal force +``` + +等温退化仍可作为 gate 默认路径,但温度和等效温升状态必须继续保存。 + +### 9.3 失效不可逆 + +0.5.1 应继续确认: + +- damage 单调不减。 +- softening 单调不增。 +- `PHASE_SOLID_FAILED` 不可逆。 +- 失效不删除粒子,不改变质量。 +- restart 后失效和 softening 状态不被重置。 + +## 10. Solid 内力和能量诊断 + +### 10.1 最小内力路径 + +0.5.1 建议实现最小 Solid 内力贡献路径。第一版目标不是工程级断裂,而是形成可测的应力到加速度链路: + +- 零应力时 Solid 内力为零。 +- 均匀平动不产生内力。 +- 简单双粒子或对称粒子布置下内力成对平衡。 +- softening 可降低失效粒子的内力贡献。 +- 无 active Solid 粒子时跳过 Solid 内力路径。 + +### 10.2 动量和能量诊断 + +0.5.1 应加固 Solid 诊断: + +- Solid 总质量。 +- Solid 总动量。 +- Solid 动能。 +- Solid 内能。 +- 塑性功或等价内能增量。 +- 最大 von Mises 应力。 +- 最大应变率。 +- 最大 Solid 加速度。 +- damage 和 softening 范围。 +- 内力动量残差或等价平衡诊断。 + +### 10.3 与 Water/Gas/Explosive 的隔离 + +Solid 内力和诊断增强不得改变 Water-only、Gas-only、Explosive-Gas-Water 既有算例结果。0.5.1 必须保留 0.5.0 完整回归。 + +## 11. 稳定时间步 + +0.5.1 继续使用 Velocity-Verlet 显式推进。Solid dt 约束建议包括: + +```text +dt_solid_wave = cfl * h / (c_solid + |v|) +dt_solid_acc = cfl_acc * sqrt(h / (|a_solid| + eps)) +dt_solid = min(dt_solid_wave, dt_solid_acc) +``` + +其中加速度约束可作为 0.5.1 的新增诊断或受控选项。默认 gate 应验证: + +- 无 active Solid 时不影响全局 dt。 +- 有 active Solid 时 dt 有限且为正。 +- 内力或体力增大时加速度约束可收紧。 +- restart 后 dt 诊断一致。 + +## 12. 输出和 Restart + +### 12.1 CSV 输出 + +0.5.1 建议在 summary CSV 中追加或确认以下字段: + +- `solid_max_strain_rate` +- `solid_max_acceleration` +- `solid_internal_force_residual` +- `solid_reference_neighbor_min` +- `solid_correction_det_min` +- `solid_correction_status` + +粒子 CSV 可追加: + +- `solid_strain_rate_eq` +- `solid_acceleration_norm` +- `solid_reference_neighbor_count` +- `solid_correction_status` + +如果字段过多,0.5.1 可优先将完整粒子级调试状态放入 API 和 module tests,CSV 只保留 release gate 最有价值的字段。 + +### 12.2 Restart + +0.5.1 建议写入 `STATE_0_5_1`。必须保存或可恢复: + +- 0.5.0 已有粒子通用状态。 +- Velocity-Verlet 所需 `v`、`a` 和 `vhalf`。 +- Water、Gas、Explosive 既有模块状态。 +- Solid material 表。 +- Solid per-particle 应力、应变、塑性、温度、damage、softening、内能、失效状态。 +- Solid 参考构型、修正矩阵、变形梯度和新增诊断状态。 +- 时间步诊断和输出计数。 + +兼容读入: + +- `STATE_0_5_1`:完整读回。 +- `STATE_0_5`:读回 0.5.0 Solid 状态,并初始化 0.5.1 新状态。 +- `STATE_0_4_1` 及更早可支持状态:初始化空 Solid 状态。 + +restart 后继续显式步不得重复初始化 Solid 应力、塑性应变、damage、softening、变形梯度或失效状态。 + +## 13. API、C ABI、C++、Python 和 CLI + +### 13.1 Fortran API + +0.5.1 建议新增或补强: + +- `sph_get_solid_state` +- `sph_get_solid_diagnostics` +- `sph_get_solid_reference_quality` + +若粒子级 state 查询过大,Fortran API 可拆分为计数查询、summary 查询和 caller-allocated buffer 查询。 + +### 13.2 C ABI + +C ABI 应保持追加式扩展。建议新增: + +```c +int sphlite_get_solid_particle_state(int max_particles, + int *particle_id_ext, + int *phase, + int *failure_status, + double *stress, + double *strain, + double *plastic_strain, + double *damage, + double *softening, + double *strain_rate, + int *count); +``` + +数组展开顺序建议: + +- `stress[component + 6 * particle]` +- `strain[component + 6 * particle]` +- `strain_rate[component + 6 * particle]` + +空指针、非正容量、未初始化状态和小容量必须走既有错误路径。 + +### 13.3 C++ wrapper 和 Python ctypes + +C++ 和 Python 继续做 C ABI 薄包装,不重新定义 Solid 物理语义。Python checker 应覆盖: + +- Solid state 查询。 +- Solid 小模型 run 后应力、damage、softening 和 strain-rate 字段。 +- 0.5.1 restart 读回后的 Solid state 一致性。 +- 0.5.0 restart 兼容读入后的安全默认值。 + +### 13.4 CLI + +CLI inspect/run 可追加: + +- `solid_max_strain_rate` +- `solid_max_acceleration` +- `solid_internal_force_residual` +- `solid_correction_status` +- `solid_reference_neighbor_min` + +CLI 测试应覆盖: + +- Solid 0.5.1 输入 inspect。 +- Solid-only 小模型 run。 +- Solid restart 读回 inspect 或 run。 +- Solid 错误输入。 + +## 14. 测试计划 + +### 14.1 新增 0.5.1 测试 + +建议新增以下测试: + +- `solid_051_input_validation`:Solid material/section 校验、warning/error 路径。 +- `solid_reference_neighbor`:参考邻域计数、退化邻域和非 Solid 过滤。 +- `solid_correction_matrix`:修正矩阵有限性、退化检测和安全 fallback。 +- `solid_velocity_gradient`:均匀平动、单轴拉伸速度场和非 Solid 过滤。 +- `solid_strain_increment`:应变率到应变增量的受控更新。 +- `solid_internal_force_pair`:成对粒子内力方向和动量平衡。 +- `solid_uniform_stress_balance`:对称布置下均匀应力残差受控。 +- `solid_softening_force`:softening 对内力或应力贡献的折减。 +- `solid_energy_diagnostics`:动能、内能、塑性功或等价能量诊断。 +- `solid_dt_acceleration`:Solid 加速度约束和全局 dt 贡献。 +- `solid_restart_051`:`STATE_0_5_1` 写入读回并继续显式步。 +- `solid_restart_050_compat`:`STATE_0_5` 兼容读入并初始化 0.5.1 新状态。 +- `solid_state_api`:Fortran API 和 C ABI 的 Solid 粒子级状态查询。 +- `solid_python_051`:Python ctypes 的 Solid 0.5.1 诊断。 +- `solid_cli_051`:CLI 的 Solid 0.5.1 inspect/run/restart 字段。 +- `solid_051_source_size`:Solid 0.5.1 source size 和 stale exception 检查。 + +### 14.2 既有回归测试 + +0.5.1 必须继续通过 0.5.0 完整 gate,包括: + +- Water gate。 +- Gas gate。 +- Explosive 0.4.0 gate。 +- Explosive 0.4.1 gate。 +- Solid 0.5.0 gate。 +- output/restart gate。 +- C API/C++/Python/CLI gate。 +- source size gate。 + +### 14.3 建议 0.5.1 Release Gate + +建议 0.5.1 默认 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 "^source_size$" --output-on-failure +git diff --check +``` + +## 15. 建议开发阶段 + +若后续根据本计划生成 `todo.md`,建议按以下阶段拆分: + +1. 0.5.1 版本号、0.5.0 发布基线和文档范围确认。 +2. Solid 0.5.1 输入样例、错误输入样例和小型结构 smoke 样例准备。 +3. Solid material/section 校验加固。 +4. 参考邻域计数、过滤和退化诊断。 +5. 修正矩阵构建、有限性检查和 fallback。 +6. 变形梯度初始化、更新和 restart 默认值。 +7. 速度梯度和应变率计算。 +8. 应变增量驱动的弹性材料点更新。 +9. 应变增量驱动的 Johnson-Cook flow/failure 更新。 +10. softening 对应力或内力贡献的作用路径。 +11. 最小 Solid 内力贡献和成对平衡测试。 +12. Solid 能量、动量、应变率、加速度和内力残差诊断。 +13. Solid dt 加速度约束或新增 dt 诊断。 +14. summary CSV 和粒子 CSV 字段扩展。 +15. `STATE_0_5_1` restart 写入。 +16. `STATE_0_5_1` restart 读回。 +17. `STATE_0_5` 和更早 restart 兼容读入。 +18. Fortran API 和 C ABI 的 Solid 粒子级状态查询。 +19. C++ wrapper、Python ctypes 和 CLI 扩展。 +20. source size 复核和必要拆分。 +21. 0.5.0 全量回归和 0.5.1 新增 gate。 +22. README、06、09 和 11 号文档同步。 + +## 16. 验收标准 + +0.5.1 应满足以下验收标准: + +1. 软件版本为 `0.5.1`。 +2. 0.5.0 release gate 继续通过。 +3. Solid material 和 Solid section 校验路径清晰。 +4. 参考邻域和修正矩阵诊断可用。 +5. 速度梯度和应变率在受控小算例中与预期一致。 +6. Solid 应力更新可由显式步运动学增量驱动。 +7. 最小 Solid 内力路径可运行,并通过零应力、均匀平动和成对平衡测试。 +8. softening 可影响应力或内力贡献,失效仍不可逆且不删除粒子。 +9. Solid 能量、动量、最大应变率、最大加速度和 damage/softening 诊断可用。 +10. Solid dt 约束有限为正,并可进入全局 dt 估计。 +11. `STATE_0_5_1` restart 可恢复 Solid 0.5.1 状态并继续显式步。 +12. `STATE_0_5` restart 可兼容读入,并初始化新增状态。 +13. Solid 粒子级状态 Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 字段可用。 +14. 默认 gate、0.5.0 Solid gate、0.5.1 Solid gate、source size 和 `git diff --check` 通过。 +15. 文档不宣称 0.5.1 已实现 Shell、真实水-气-结构爆炸响应、真实 FEM-SPH 耦合或工程级结构破坏 benchmark。 +16. 不新增 FEMLite 直接依赖。 +17. 不修改 SPHLite 文件夹之外的内容。 + +## 17. 风险与控制 + +| 风险 | 表现 | 控制方式 | +| --- | --- | --- | +| 0.5.1 范围膨胀 | 试图进入 Shell、水-气-结构工程爆炸或 FEM-SPH 耦合 | 限定为 Solid 结构算法小型闭环 | +| TL-SPH 内力实现不稳 | 小模型中出现非物理加速度或动量漂移 | 先做零应力、均匀平动、成对平衡和对称布置测试 | +| 修正矩阵退化 | 粒子布局不良导致奇异矩阵和非有限结果 | 明确退化检测、warning/error 和 fallback | +| 本构和运动学耦合错误 | 应变率方向或量级错误,导致应力更新失真 | 使用解析速度场和材料点退化测试锁定语义 | +| 失效处理破坏质量守恒 | 删除粒子或改变质量导致诊断跳变 | 失效只改变 phase/status/softening,不删除粒子 | +| Solid 更新影响既有算例 | 无 Solid 输入时仍进入 Solid 内力路径 | 无 active Solid 时直接跳过,并保持 0.5.0 全量回归 | +| API 兼容破坏 | 修改已有 Solid summary 字段或数组约定 | 新增粒子级状态 API,不改变 0.5.0 接口含义 | +| restart 不完整 | 读回后修正矩阵、变形梯度或失效状态丢失 | `STATE_0_5_1` 保存完整 Solid 0.5.1 持久状态 | +| source size 债务扩大 | Solid 内力、梯度和 restart 堆入单个大文件 | 按 reference、kinematics、force、restart、api 拆分 | + +## 18. 0.6.0 启动条件 + +满足以下条件后,可以启动 0.6.0 `Shell`: + +1. 0.5.1 Solid 参考构型、速度梯度、应变率和最小内力 gate 稳定。 +2. Solid failure/softening 对动力学贡献路径可重复通过。 +3. Solid output、restart、API、CLI 和 Python 诊断稳定。 +4. 0.5.0 Water/Gas/Explosive/Solid gate 仍可重复通过。 +5. 0.5.1 文档明确尚未实现 Shell、真实 FEM-SPH 耦合和工程级水下爆炸结构破坏 benchmark。 + diff --git a/src/core/sph_precision.f90 b/src/core/sph_precision.f90 index 328b807..61fd422 100644 --- a/src/core/sph_precision.f90 +++ b/src/core/sph_precision.f90 @@ -4,7 +4,7 @@ module sph_precision integer, parameter :: rk = selected_real_kind(12, 100) integer, parameter :: SPH_VERSION_MAJOR = 0 integer, parameter :: SPH_VERSION_MINOR = 5 - integer, parameter :: SPH_VERSION_PATCH = 0 + integer, parameter :: SPH_VERSION_PATCH = 1 integer, parameter :: SPH_NDIM = 3 integer, parameter :: SPH_ERROR_MESSAGE_LEN = 256 integer, parameter :: SPH_PATH_LEN = 1024 diff --git a/tests/data/solid_bad_johnson_cook_nan_051.inp b/tests/data/solid_bad_johnson_cook_nan_051.inp new file mode 100644 index 0000000..96cac4c --- /dev/null +++ b/tests/data/solid_bad_johnson_cook_nan_051.inp @@ -0,0 +1,16 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=SOLID_PARTICLES +1 +*MATERIAL, NAME=STEEL_BAD_JC_NAN, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*PLASTIC, HARDENING=JOHNSON COOK +NaN, 510.0E6, 0.26, 0.014, 1.03, 1.0, 293.0, 1793.0 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_BAD_JC_NAN +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/solid_bad_poisson_051.inp b/tests/data/solid_bad_poisson_051.inp new file mode 100644 index 0000000..053a37c --- /dev/null +++ b/tests/data/solid_bad_poisson_051.inp @@ -0,0 +1,14 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=SOLID_PARTICLES +1 +*MATERIAL, NAME=STEEL_BAD_POISSON, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.60 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_BAD_POISSON +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/solid_bad_softening_051.inp b/tests/data/solid_bad_softening_051.inp new file mode 100644 index 0000000..a20eea5 --- /dev/null +++ b/tests/data/solid_bad_softening_051.inp @@ -0,0 +1,15 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=SOLID_PARTICLES +1 +*MATERIAL, NAME=STEEL_BAD_SOFTENING, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SPHLITE SOLID CONTROL, MATERIAL=STEEL_BAD_SOFTENING, SOFTENING=EXPONENTIAL, WIDTH=0.25 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_BAD_SOFTENING +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/solid_explicit_smoke_051.inp b/tests/data/solid_explicit_smoke_051.inp new file mode 100644 index 0000000..5e03ba5 --- /dev/null +++ b/tests/data/solid_explicit_smoke_051.inp @@ -0,0 +1,21 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +4, 0.0, 0.0, 0.1 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=SOLID_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=STEEL_SMOKE_051, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_SMOKE_051 +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE BODY FORCE, X=0.0, Y=0.0, Z=-9.81 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=2.0E-7, STEPS=2, SAFETY=0.5 diff --git a/tests/data/solid_force_pair_051.inp b/tests/data/solid_force_pair_051.inp new file mode 100644 index 0000000..7ecc433 --- /dev/null +++ b/tests/data/solid_force_pair_051.inp @@ -0,0 +1,16 @@ +*NODE +1, -0.05, 0.0, 0.0 +2, 0.05, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +*ELSET, ELSET=SOLID_PARTICLES +1, 2 +*MATERIAL, NAME=STEEL_PAIR, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_PAIR +*SPHLITE PARTICLE CONTROL, H=0.12, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/solid_missing_section_051.inp b/tests/data/solid_missing_section_051.inp new file mode 100644 index 0000000..9cd47ca --- /dev/null +++ b/tests/data/solid_missing_section_051.inp @@ -0,0 +1,13 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=SOLID_PARTICLES +1 +*MATERIAL, NAME=STEEL_MISSING_SECTION, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/solid_reference_degenerate_051.inp b/tests/data/solid_reference_degenerate_051.inp new file mode 100644 index 0000000..2e5a0a4 --- /dev/null +++ b/tests/data/solid_reference_degenerate_051.inp @@ -0,0 +1,18 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.2, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +*ELSET, ELSET=SOLID_PARTICLES +1, 2, 3 +*MATERIAL, NAME=STEEL_DEGENERATE, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_DEGENERATE +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/solid_reference_normal_051.inp b/tests/data/solid_reference_normal_051.inp new file mode 100644 index 0000000..9355a9d --- /dev/null +++ b/tests/data/solid_reference_normal_051.inp @@ -0,0 +1,22 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +4, 0.0, 0.0, 0.1 +5, 0.1, 0.1, 0.1 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +5, 5 +*ELSET, ELSET=SOLID_PARTICLES +1, 2, 3, 4, 5 +*MATERIAL, NAME=STEEL_REF, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_REF +*SPHLITE PARTICLE CONTROL, H=0.18, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=2.0E-7, STEPS=2, SAFETY=0.5 diff --git a/tests/data/solid_restart_050_compat_051.inp b/tests/data/solid_restart_050_compat_051.inp new file mode 100644 index 0000000..61d30b2 --- /dev/null +++ b/tests/data/solid_restart_050_compat_051.inp @@ -0,0 +1,20 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +4, 0.0, 0.0, 0.1 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=SOLID_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=STEEL_RESTART_050_COMPAT, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_RESTART_050_COMPAT +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=2.0E-7, STEPS=2, SAFETY=0.5 diff --git a/tests/data/solid_restart_051.inp b/tests/data/solid_restart_051.inp new file mode 100644 index 0000000..946c8eb --- /dev/null +++ b/tests/data/solid_restart_051.inp @@ -0,0 +1,25 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +4, 0.0, 0.0, 0.1 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=SOLID_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=STEEL_RESTART_051, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*PLASTIC, HARDENING=JOHNSON COOK +792.0E6, 510.0E6, 0.26, 0.014, 1.03, 1.0, 293.0, 1793.0 +*DAMAGE INITIATION, CRITERION=JOHNSON COOK +0.05, 3.44, -2.12, 0.002, 0.61 +*SPHLITE SOLID CONTROL, MATERIAL=STEEL_RESTART_051, SOFTENING=LINEAR, WIDTH=0.25 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_RESTART_051 +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=2.0E-7, STEPS=2, SAFETY=0.5 diff --git a/tests/data/solid_section_non_solid_051.inp b/tests/data/solid_section_non_solid_051.inp new file mode 100644 index 0000000..5f576cf --- /dev/null +++ b/tests/data/solid_section_non_solid_051.inp @@ -0,0 +1,13 @@ +*NODE +1, 0.0, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +*ELSET, ELSET=SOLID_PARTICLES +1 +*MATERIAL, NAME=WATER_MAT, TYPE=WATER +*DENSITY +1000.0 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=WATER_MAT +*SPHLITE EOS, TYPE=TAIT, MATERIAL=WATER_MAT, RHO0=1000.0, C0=1480.0, GAMMA=7.0, P0=0.0 +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=1.0, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/solid_softening_force_051.inp b/tests/data/solid_softening_force_051.inp new file mode 100644 index 0000000..901d037 --- /dev/null +++ b/tests/data/solid_softening_force_051.inp @@ -0,0 +1,21 @@ +*NODE +1, -0.05, 0.0, 0.0 +2, 0.05, 0.0, 0.0 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +*ELSET, ELSET=SOLID_PARTICLES +1, 2 +*MATERIAL, NAME=STEEL_SOFTENING, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*PLASTIC, HARDENING=JOHNSON COOK +792.0E6, 510.0E6, 0.26, 0.014, 1.03, 1.0, 293.0, 1793.0 +*DAMAGE INITIATION, CRITERION=JOHNSON COOK +0.05, 3.44, -2.12, 0.002, 0.61 +*SPHLITE SOLID CONTROL, MATERIAL=STEEL_SOFTENING, SOFTENING=LINEAR, WIDTH=0.25 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_SOFTENING +*SPHLITE PARTICLE CONTROL, H=0.12, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/solid_uniaxial_velocity_051.inp b/tests/data/solid_uniaxial_velocity_051.inp new file mode 100644 index 0000000..70258ee --- /dev/null +++ b/tests/data/solid_uniaxial_velocity_051.inp @@ -0,0 +1,20 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +4, 0.0, 0.0, 0.1 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=SOLID_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=STEEL_STRAIN_RATE, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_STRAIN_RATE +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/solid_uniform_stress_051.inp b/tests/data/solid_uniform_stress_051.inp new file mode 100644 index 0000000..ee12519 --- /dev/null +++ b/tests/data/solid_uniform_stress_051.inp @@ -0,0 +1,24 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +4, 0.0, 0.0, 0.1 +5, 0.1, 0.1, 0.0 +6, 0.1, 0.0, 0.1 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +5, 5 +6, 6 +*ELSET, ELSET=SOLID_PARTICLES +1, 2, 3, 4, 5, 6 +*MATERIAL, NAME=STEEL_UNIFORM_STRESS, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_UNIFORM_STRESS +*SPHLITE PARTICLE CONTROL, H=0.18, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/data/solid_uniform_translation_051.inp b/tests/data/solid_uniform_translation_051.inp new file mode 100644 index 0000000..20bab36 --- /dev/null +++ b/tests/data/solid_uniform_translation_051.inp @@ -0,0 +1,20 @@ +*NODE +1, 0.0, 0.0, 0.0 +2, 0.1, 0.0, 0.0 +3, 0.0, 0.1, 0.0 +4, 0.0, 0.0, 0.1 +*ELEMENT, TYPE=SPH3D +1, 1 +2, 2 +3, 3 +4, 4 +*ELSET, ELSET=SOLID_PARTICLES +1, 2, 3, 4 +*MATERIAL, NAME=STEEL_TRANSLATION, TYPE=SOLID +*DENSITY +7850.0 +*ELASTIC +210.0E9, 0.30 +*SOLID SECTION, ELSET=SOLID_PARTICLES, MATERIAL=STEEL_TRANSLATION +*SPHLITE PARTICLE CONTROL, H=0.15, MASS=7.85, VOLUME=0.001 +*SPHLITE TIME CONTROL, DT=1.0E-7, TIME=1.0E-7, STEPS=1, SAFETY=0.5 diff --git a/tests/interface/test_c_api.c b/tests/interface/test_c_api.c index cff0028..083a966 100644 --- a/tests/interface/test_c_api.c +++ b/tests/interface/test_c_api.c @@ -179,7 +179,7 @@ int main(void) ierr = sphlite_get_version(&major, &minor, &patch); if (ierr != 0) return fail("get_version failed"); - if (major != 0 || minor != 5 || patch != 0) return fail("unexpected version"); + if (major != 0 || minor != 5 || patch != 1) return fail("unexpected version"); snprintf(path, sizeof(path), "%s/minimal_particles_011.inp", SPHLITE_TEST_DATA_DIR); ierr = sphlite_read_inp(path); diff --git a/tests/interface/test_cpp_api.cpp b/tests/interface/test_cpp_api.cpp index aa0c30b..1ccf319 100644 --- a/tests/interface/test_cpp_api.cpp +++ b/tests/interface/test_cpp_api.cpp @@ -14,7 +14,7 @@ int main() { sphlite::Session session; sphlite::Version version = sphlite::version(); - if (version.major != 0 || version.minor != 5 || version.patch != 0) { + if (version.major != 0 || version.minor != 5 || version.patch != 1) { return 1; } diff --git a/tests/unit/test_smoke.f90 b/tests/unit/test_smoke.f90 index 310ec1a..f9b75be 100644 --- a/tests/unit/test_smoke.f90 +++ b/tests/unit/test_smoke.f90 @@ -37,7 +37,7 @@ program test_smoke call sph_get_version(major, minor, patch, ierr) call assert_ok(ierr, 'version failed') - if (major /= 0 .or. minor /= 5 .or. patch /= 0) call fail('unexpected version') + if (major /= 0 .or. minor /= 5 .or. patch /= 1) call fail('unexpected version') call sph_db_allocate(2, ierr) call assert_ok(ierr, 'database allocation failed') diff --git a/todo.md b/todo.md index d8b60b2..991f36c 100644 --- a/todo.md +++ b/todo.md @@ -1,224 +1,278 @@ # SPHLite TODO -当前目标版本:0.5.0 +当前目标版本:0.5.1 -本文档依据 `docs/v5.0_development_plan.md` 拆分。0.5.0 定位为 `Solid` 版本线的起步版本,目标是在 0.4.1 已完成 `Water`、`Gas`、`Explosive` 稳定闭环的基础上,建立 3D 实体结构 SPH 粒子的输入、状态、本构、失效、显式推进、restart、接口和测试 gate。 +本文档依据 `docs/v5.1_development_plan.md` 拆分。0.5.1 定位为 `Solid` 版本线的稳定化和结构算法加固版本,目标是在 0.5.0 已完成 Solid 输入、状态、本构、失效、显式推进、restart、接口和 gate 最小闭环的基础上,补强参考构型、速度梯度、应变率、最小内力、能量诊断、`STATE_0_5_1` restart、`STATE_0_5` 兼容读入和接口可观测性。 -所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.5.0 不实现 `Shell`、真实水-气-结构工程爆炸响应、真实 FEM-SPH 耦合、复杂断裂面追踪、碎片云、焊缝失效库、大规模并行或 GPU 后端。 +所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.5.1 不实现 `Shell`、真实水-气-结构工程爆炸响应、真实 FEM-SPH 耦合、工程级结构破坏 benchmark、复杂断裂面追踪、碎片云、焊缝失效库、大规模并行或 GPU 后端。 执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端。 -## 阶段 A:版本基线、范围声明与输入样例 +## 阶段 A:版本基线、范围声明与 0.5.1 样例 -- [x] 确认当前 git 状态并记录 0.5.0 开发起点。 -- [x] 确认 `v0.4.1` 标签和发布提交可作为 0.5.0 开发基线。 -- [x] 将核心软件版本更新为 `0.5.0`。 -- [x] 将 CMake 项目版本更新为 `0.5.0`。 +- [x] 确认当前 git 状态干净或记录已有未提交内容。 +- [x] 确认 `v0.5.0` 标签和远端发布提交可作为 0.5.1 开发基线。 +- [x] 将核心软件版本更新为 `0.5.1`。 +- [x] 将 CMake 项目版本更新为 `0.5.1`。 - [x] 更新 Fortran smoke 测试中的版本期望。 - [x] 更新 C API 测试中的版本期望。 - [x] 更新 C++ API 测试中的版本期望。 - [x] 更新 Python debug 测试中的版本期望。 - [x] 更新 CLI `--version` 和 inspect 版本期望。 -- [x] 在 README 中记录 0.5.0 `Solid` 起步版本定位。 -- [x] 创建最小 Solid 弹性材料输入样例。 -- [x] 创建 Johnson-Cook Solid material 输入样例。 -- [x] 创建 Johnson-Cook failure 输入样例。 -- [x] 创建 Solid section 输入样例。 -- [x] 创建 Solid-only 显式推进 smoke 输入样例。 -- [x] 创建 Solid 初始速度或体力驱动输入样例。 -- [x] 创建 Solid restart 0.5.0 测试输入样例。 -- [x] 创建 `STATE_0_4_1` restart 兼容测试所需输入或夹具。 -- [x] 创建缺失密度的 Solid 错误输入样例。 -- [x] 创建缺失弹性参数的 Solid 错误输入样例。 -- [x] 创建非法 Johnson-Cook 参数错误输入样例。 -- [x] 创建非法 Solid section 错误输入样例。 +- [x] 在 README 中记录 0.5.1 Solid 稳定化开发定位。 +- [x] 创建 Solid 0.5.1 正常参考邻域输入样例。 +- [x] 创建 Solid 0.5.1 退化参考邻域输入样例。 +- [x] 创建 Solid 均匀平动速度场输入样例。 +- [x] 创建 Solid 单轴拉伸速度场输入样例。 +- [x] 创建 Solid 成对内力平衡输入样例。 +- [x] 创建 Solid 对称均匀应力输入样例。 +- [x] 创建 Solid softening 内力折减输入样例。 +- [x] 创建 Solid 0.5.1 显式推进 smoke 输入样例。 +- [x] 创建 `STATE_0_5_1` restart 测试输入样例。 +- [x] 准备 `STATE_0_5` restart 兼容读入测试夹具。 +- [x] 创建 Solid material 非法泊松比错误输入样例。 +- [x] 创建 Solid material 非有限 Johnson-Cook 参数错误输入样例。 +- [x] 创建 Solid 非法 softening 类型错误输入样例。 +- [x] 创建 Solid section 指向非 Solid material 错误输入样例。 +- [x] 创建 active Solid 粒子缺失 Solid section 错误输入样例。 -## 阶段 B:Solid 输入解析、material 表与 section 识别 +## 阶段 B:Solid 输入校验、section 校验与 warning/error 路径 -- [x] 复核现有 material 类型枚举是否包含 `Solid`。 -- [x] 复核 phase 常量是否包含 `PHASE_SOLID` 和 `PHASE_SOLID_FAILED`。 -- [x] 复核 C 头文件和 Python 常量中的 Solid phase/status 命名。 -- [x] 新增或加固 `TYPE=SOLID` material 识别。 -- [x] 支持 Solid material 的 `*DENSITY` 读取。 -- [x] 支持 Solid material 的 `*ELASTIC` 读取。 -- [x] 支持 Johnson-Cook flow 参数读取。 -- [x] 支持 Johnson-Cook failure 参数读取。 -- [x] 支持 Solid control 中的 softening 类型读取。 -- [x] 支持 Solid control 中的 softening 参数读取。 -- [x] 支持 `*SOLID SECTION` 或既有等价 section 关键词。 -- [x] 将 Solid section 与 material 映射到内部 section/material id。 -- [x] 确认 set 仍只表示集合,不参与 Solid 类型判断。 -- [x] 对缺失密度的 Solid material 报 error。 -- [x] 对缺失弹性参数的 Solid material 报 error。 -- [x] 对非法弹性参数报 error。 -- [x] 对非法 Johnson-Cook flow 参数报 error。 -- [x] 对非法 Johnson-Cook failure 参数报 error。 -- [x] 对非法 Solid section 或缺失 material 的 section 报 error。 -- [x] 对无 active Solid 粒子的 Solid material 报 warning 而不阻止其他路径运行。 -- [x] 新增 `input_solid_material` 测试并接入 CTest。 -- [x] 新增 `input_solid_errors` 测试并接入 CTest。 +- [ ] 复核 0.5.0 Solid material 解析路径并保持语法兼容。 +- [ ] 对 Solid material 缺失密度路径保持 error。 +- [ ] 对 Solid material 非正密度路径保持 error。 +- [ ] 对 Solid material 缺失弹性参数路径保持 error。 +- [ ] 对 Solid material 非正弹性模量路径保持 error。 +- [ ] 对 Solid material 非法泊松比路径新增或加固 error。 +- [ ] 对 Johnson-Cook flow 参数非有限路径新增或加固 error。 +- [ ] 对 Johnson-Cook failure 参数非完整路径保持 error。 +- [ ] 对 Johnson-Cook failure 参数非有限路径新增或加固 error。 +- [ ] 对 unsupported softening 类型新增或加固 error。 +- [ ] 对未被 active Solid 粒子使用的 Solid material 保持 warning。 +- [ ] 对 `*SOLID SECTION` 缺失 material 参数路径保持 error。 +- [ ] 对 `*SOLID SECTION` 指向不存在 material 路径保持 error。 +- [ ] 对 `*SOLID SECTION` 指向非 Solid material 路径新增或加固 error。 +- [ ] 对存在 active Solid 粒子但缺失 Solid section 的模型给出 error。 +- [ ] 确认 set 仍只表示集合,不参与 Solid 类型判断。 +- [ ] 确认 phase/status 默认值不改变 Water/Gas/Explosive 路径。 +- [ ] 新增 `solid_051_input_validation` Fortran 输入测试。 +- [ ] 将 `solid_051_input_validation` 接入 CTest。 +- [ ] 确认 0.5.0 `input_solid_material` 和 `input_solid_errors` 仍通过。 -## 阶段 C:Solid 状态、生命周期与数据库集成 +## 阶段 C:参考邻域、修正矩阵与变形梯度状态 -- [x] 新增 Solid material 表的模块级存储。 -- [x] 存储 Solid 密度、弹性模量和泊松比。 -- [x] 派生并存储剪切模量、体积模量和结构波速。 -- [x] 存储 Johnson-Cook `A`、`B`、`n`、`C`、`m` 参数。 -- [x] 存储 Johnson-Cook 参考应变率、室温和熔化温度。 -- [x] 存储温升或等效塑性功转温升参数。 -- [x] 存储 Johnson-Cook failure `D1` 到 `D5` 参数。 -- [x] 存储 softening 类型和 softening 参数。 -- [x] 新增 Solid 状态 reset 过程。 -- [x] 新增 Solid 状态 allocate/build 过程。 -- [x] 新增 Solid 状态 clear/finalize 过程。 -- [x] 分配 `solid_stress(6,npart)` 状态。 -- [x] 分配 `solid_strain(6,npart)` 状态。 -- [x] 分配 `solid_plastic_strain(npart)` 状态。 -- [x] 分配 `solid_plastic_strain_rate(npart)` 状态。 -- [x] 分配 `solid_temperature(npart)` 状态。 -- [x] 分配 `solid_damage(npart)` 状态。 -- [x] 分配 `solid_softening(npart)` 状态。 -- [x] 分配 `solid_internal_energy(npart)` 状态。 -- [x] 分配 Solid 变形梯度或等价状态。 -- [x] 分配 Solid 梯度修正矩阵或等价占位状态。 -- [x] 分配 `solid_failure_status(npart)` 状态。 -- [x] 初始化 active Solid 粒子的 Solid 状态默认值。 -- [x] 初始化非 Solid 粒子的 Solid 状态为安全默认值。 -- [x] 新增 `solid_state_build` 测试并接入 CTest。 +- [ ] 复核 Solid 参考坐标、参考体积和参考邻域现有状态。 +- [ ] 新增或补齐 Solid 每粒子参考邻居数状态。 +- [ ] 新增或补齐 Solid 参考邻域退化状态。 +- [ ] 新增或补齐 Solid 修正矩阵状态码。 +- [ ] 新增或补齐 Solid 修正矩阵行列式诊断。 +- [ ] 在 Solid reset 路径初始化参考邻域诊断状态。 +- [ ] 在 Solid allocate/build 路径分配参考邻域诊断状态。 +- [ ] 在 Solid clear/finalize 路径释放参考邻域诊断状态。 +- [ ] 构建 active Solid 粒子的参考邻域计数。 +- [ ] 在参考邻域计数中排除非 Solid 粒子污染。 +- [ ] 计算 active Solid 粒子的最小参考邻居数诊断。 +- [ ] 识别参考邻域不足的退化 Solid 粒子。 +- [ ] 对退化参考邻域给出受控 warning 或 error。 +- [ ] 构建 Solid 参考梯度矩阵或等价矩阵。 +- [ ] 计算 Solid 修正矩阵行列式。 +- [ ] 检查 Solid 修正矩阵有限性。 +- [ ] 检查 Solid 修正矩阵近奇异状态。 +- [ ] 为不可逆修正矩阵提供受控 fallback。 +- [ ] 将修正矩阵质量诊断写入 Solid summary。 +- [ ] 将变形梯度初始值设置为单位阵。 +- [ ] 对非 active Solid 粒子设置安全变形梯度默认值。 +- [ ] 新增 `solid_reference_neighbor` 测试。 +- [ ] 新增 `solid_correction_matrix` 测试。 +- [ ] 将 `solid_reference_neighbor` 接入 CTest。 +- [ ] 将 `solid_correction_matrix` 接入 CTest。 -## 阶段 D:弹性、Johnson-Cook 本构与失效材料点 +## 阶段 D:速度梯度、应变率和运动学驱动本构 -- [x] 新增 Solid 弹性常数计算 helper。 -- [x] 新增 Voigt 应力应变工具函数。 -- [x] 新增 von Mises 等效应力计算。 -- [x] 新增等效塑性应变率安全计算。 -- [x] 实现弹性材料点试应力更新。 -- [x] 实现弹性材料点内能更新。 -- [x] 新增弹性区材料点单测。 -- [x] 实现 Johnson-Cook 热软化温度归一化。 -- [x] 实现 Johnson-Cook 应变率项计算。 -- [x] 实现 Johnson-Cook 硬化项计算。 -- [x] 实现 Johnson-Cook 流动应力计算。 -- [x] 对非正参考应变率或非法温度参数报 error。 -- [x] 实现塑性屈服判断。 -- [x] 实现简化显式返回映射或等价塑性修正。 -- [x] 更新等效塑性应变和等效塑性应变率。 -- [x] 更新塑性功和等效温升状态。 -- [x] 新增 Johnson-Cook flow 单测。 -- [x] 实现 Johnson-Cook failure 应变计算。 -- [x] 实现 Johnson-Cook damage 单调累积。 -- [x] 对非法 failure 应变进行受控 error 或保护。 -- [x] 实现 damage 达到阈值后的失效状态切换。 -- [x] 实现线性渐进软化因子更新。 -- [x] 限制 damage 和 softening 在合法范围。 -- [x] 确认失效后不删除粒子、不改变质量。 -- [x] 新增 `solid_elastic_material` 测试并接入 CTest。 -- [x] 新增 `solid_johnson_cook_flow` 测试并接入 CTest。 -- [x] 新增 `solid_johnson_cook_failure` 测试并接入 CTest。 -- [x] 新增 `solid_progressive_softening` 测试并接入 CTest。 +- [ ] 新增或补齐 Solid 速度梯度工作数组。 +- [ ] 新增或补齐 Solid 应变率状态数组。 +- [ ] 新增或补齐 Solid 等效应变率状态数组。 +- [ ] 在 Solid reset 路径初始化速度梯度和应变率状态。 +- [ ] 在 Solid allocate/build 路径分配速度梯度和应变率状态。 +- [ ] 在 Solid clear/finalize 路径释放速度梯度和应变率状态。 +- [ ] 实现 active Solid 粒子的速度梯度计算入口。 +- [ ] 确认无 active Solid 粒子时跳过速度梯度计算。 +- [ ] 确认非 Solid 粒子不污染 Solid 速度梯度。 +- [ ] 实现均匀平动下速度梯度为零的路径。 +- [ ] 实现单轴拉伸速度场下速度梯度计算。 +- [ ] 由速度梯度计算对称应变率。 +- [ ] 将应变率转换为 Voigt 顺序。 +- [ ] 由应变率和 dt 更新 Solid 应变增量。 +- [ ] 更新 Solid 总应变状态。 +- [ ] 由应变率计算等效塑性应变率的安全默认值。 +- [ ] 将变形梯度更新挂接到速度梯度路径。 +- [ ] 让弹性材料点更新接受运动学应变增量。 +- [ ] 让 Johnson-Cook flow 更新接受运动学应变增量。 +- [ ] 让 Johnson-Cook failure 更新接受运动学应变增量。 +- [ ] 保持等温退化测试下温度状态可恢复。 +- [ ] 确认 damage 单调不减。 +- [ ] 确认 softening 单调不增。 +- [ ] 确认 `PHASE_SOLID_FAILED` 不可逆。 +- [ ] 新增 `solid_velocity_gradient` 测试。 +- [ ] 新增 `solid_strain_increment` 测试。 +- [ ] 将 `solid_velocity_gradient` 接入 CTest。 +- [ ] 将 `solid_strain_increment` 接入 CTest。 -## 阶段 E:Solid SPH 结构状态、显式推进与稳定时间步 +## 阶段 E:最小 Solid 内力、softening 作用与动力学诊断 -- [x] 建立 Solid active 粒子计数逻辑。 -- [x] 建立 Solid failed 粒子计数逻辑。 -- [x] 构建 Solid 参考构型邻域或参考邻域占位。 -- [x] 构建 Solid 参考体积或参考权重状态。 -- [x] 构建 Solid 梯度修正矩阵计算或稳定占位。 -- [x] 对退化梯度修正矩阵给出受控 warning 或 error。 -- [x] 新增 `solid_gradient_correction` 测试并接入 CTest。 -- [x] 将 Solid 更新挂接到显式求解器流程。 -- [x] 确保无 active Solid 粒子时跳过 Solid 更新。 -- [x] 实现 Solid 速度梯度或应变率计算入口。 -- [x] 实现 Solid 本构更新入口。 -- [x] 实现 Solid 内力或等价加速度贡献的最小路径。 -- [x] 实现 Solid 体力贡献路径。 -- [x] 确保 Solid 加速度贡献不污染 Water/Gas/Explosive-only 算例。 -- [x] 实现 Solid 动能诊断。 -- [x] 实现 Solid 内能诊断。 -- [x] 实现 Solid 总动量诊断。 -- [x] 实现 Solid 最大 von Mises 应力诊断。 -- [x] 实现 Solid 塑性应变范围诊断。 -- [x] 实现 Solid damage 和 softening 范围诊断。 -- [x] 实现 Solid 结构波速稳定时间步估计。 -- [x] 将 Solid dt 约束纳入全局 dt 估计。 -- [x] 确认无 Solid 粒子时全局 dt 与 0.4.1 路径一致。 -- [x] 新增 `solid_stable_dt` 测试并接入 CTest。 -- [x] 新增 `solid_explicit_smoke` 测试并接入 CTest。 +- [ ] 复核 Solid 加速度清零和累加顺序。 +- [ ] 新增或补齐 Solid 内力贡献工作数组。 +- [ ] 新增或补齐 Solid 内力动量残差诊断状态。 +- [ ] 新增或补齐 Solid 最大加速度诊断状态。 +- [ ] 实现零应力时 Solid 内力为零。 +- [ ] 实现均匀平动时 Solid 内力为零。 +- [ ] 实现成对 Solid 粒子的对称内力贡献。 +- [ ] 实现对称布置下均匀应力残差受控路径。 +- [ ] 将 Solid 应力散度或等价力贡献累加到加速度。 +- [ ] 确认 Solid 内力不污染 Water-only 算例。 +- [ ] 确认 Solid 内力不污染 Gas-only 算例。 +- [ ] 确认 Solid 内力不污染 Explosive-Gas-Water 算例。 +- [ ] 将 softening 因子作用到应力或内力贡献。 +- [ ] 确认 failed Solid 粒子不被删除。 +- [ ] 确认 failed Solid 粒子质量不改变。 +- [ ] 计算 Solid 总动量诊断。 +- [ ] 计算 Solid 动能诊断。 +- [ ] 计算 Solid 内能诊断。 +- [ ] 计算 Solid 塑性功或等价内能增量诊断。 +- [ ] 计算 Solid 最大 von Mises 应力诊断。 +- [ ] 计算 Solid 最大应变率诊断。 +- [ ] 计算 Solid 最大加速度诊断。 +- [ ] 计算 Solid damage 范围诊断。 +- [ ] 计算 Solid softening 范围诊断。 +- [ ] 计算 Solid 内力动量残差诊断。 +- [ ] 将 Solid 诊断更新挂接到显式推进流程。 +- [ ] 新增 `solid_internal_force_pair` 测试。 +- [ ] 新增 `solid_uniform_stress_balance` 测试。 +- [ ] 新增 `solid_softening_force` 测试。 +- [ ] 新增 `solid_energy_diagnostics` 测试。 +- [ ] 将 `solid_internal_force_pair` 接入 CTest。 +- [ ] 将 `solid_uniform_stress_balance` 接入 CTest。 +- [ ] 将 `solid_softening_force` 接入 CTest。 +- [ ] 将 `solid_energy_diagnostics` 接入 CTest。 -## 阶段 F:输出、restart 与模块级持久化 +## 阶段 F:Solid 稳定时间步、显式推进和 0.5.0 回归隔离 -- [x] 在 summary CSV 中追加 Solid active/failed 粒子数字段。 -- [x] 在 summary CSV 中追加 Solid 质量和动量字段。 -- [x] 在 summary CSV 中追加 Solid 动能和内能字段。 -- [x] 在 summary CSV 中追加 Solid 最大 von Mises 应力字段。 -- [x] 在 summary CSV 中追加 Solid 塑性应变范围字段。 -- [x] 在 summary CSV 中追加 Solid damage 范围字段。 -- [x] 在 summary CSV 中追加 Solid softening 和 dt 字段。 -- [x] 在粒子 CSV 中追加 Solid stress 关键字段。 -- [x] 在粒子 CSV 中追加 Solid plastic strain 字段。 -- [x] 在粒子 CSV 中追加 Solid damage 字段。 -- [x] 在粒子 CSV 中追加 Solid softening 字段。 -- [x] 在粒子 CSV 中追加 Solid failure status 字段。 -- [x] 更新 output 测试以锁定 0.5.0 CSV header。 -- [x] 新增 `solid_output` 测试并接入 CTest。 -- [x] 将 restart 状态版本更新为 `STATE_0_5`。 -- [x] 将 Solid material 表写入 0.5.0 restart。 -- [x] 将 Solid per-particle 状态写入 0.5.0 restart。 -- [x] 将 Solid summary 和 dt 诊断写入或可恢复于 0.5.0 restart。 -- [x] 从 0.5.0 restart 读回 Solid material 表。 -- [x] 从 0.5.0 restart 读回 Solid per-particle 状态。 -- [x] 从 0.5.0 restart 读回后继续显式步。 -- [x] 从 `STATE_0_4_1` restart 读回时初始化空 Solid 状态。 -- [x] 从 `STATE_0_4` restart 读回时初始化空 Solid 状态。 -- [x] 从 `STATE_0_3_1` 或更早兼容状态读回时初始化空 Solid 状态。 -- [x] 确认 restart 后不会重复初始化 Solid 应力、塑性应变、damage 或 softening。 -- [x] 新增 `solid_restart_050` 测试并接入 CTest。 -- [x] 新增 `solid_restart_041_compat` 测试并接入 CTest。 +- [ ] 复核 0.5.0 Solid 结构波速 dt 估计。 +- [ ] 新增或补齐 Solid 加速度 dt 约束诊断。 +- [ ] 实现 `dt_solid_acc` 的有限正值保护。 +- [ ] 将 Solid wave dt 和 acceleration dt 合并为 Solid dt。 +- [ ] 将 Solid dt 继续纳入全局 dt 估计。 +- [ ] 确认无 active Solid 粒子时全局 dt 与 0.5.0 路径一致。 +- [ ] 确认 active Solid 粒子存在时 Solid dt 有限且为正。 +- [ ] 确认体力增大时加速度 dt 约束可收紧。 +- [ ] 确认内力增大时加速度 dt 约束可收紧。 +- [ ] 确认 restart 后 Solid dt 诊断一致。 +- [ ] 将 Solid 速度梯度、本构、内力和诊断挂接到 Velocity-Verlet 步。 +- [ ] 确认 Solid-only 小模型可连续推进多步。 +- [ ] 确认 Water-only smoke 仍通过。 +- [ ] 确认 Gas-only smoke 仍通过。 +- [ ] 确认 Explosive-Gas-Water smoke 仍通过。 +- [ ] 新增 `solid_dt_acceleration` 测试。 +- [ ] 更新 `solid_explicit_smoke` 覆盖 0.5.1 诊断。 +- [ ] 将 `solid_dt_acceleration` 接入 CTest。 +- [ ] 确认 0.5.0 `solid_stable_dt` 仍通过。 +- [ ] 确认 0.5.0 `solid_explicit_smoke` 仍通过。 -## 阶段 G:Fortran API、C ABI、C++、Python 与 CLI +## 阶段 G:CSV 输出、`STATE_0_5_1` restart 与兼容读入 -- [x] 新增 `sph_get_solid_summary` Fortran API。 -- [x] 新增 Solid failure counts Fortran API。 -- [x] 新增 Solid material summary Fortran API 或确认暂不对外暴露。 -- [x] 为 Solid Fortran API 补齐未初始化错误路径。 -- [x] 新增 `sphlite_get_solid_summary` C ABI。 -- [x] 为 Solid C ABI 补齐空指针错误路径。 -- [x] 为 Solid C ABI 补齐小容量或非法参数错误路径。 -- [x] 在 C API 测试中覆盖 Solid summary 查询。 -- [x] 在 C API 测试中覆盖 Solid API 错误路径。 -- [x] 在 C++ wrapper 中增加 Solid summary 薄包装。 -- [x] 在 C++ API 测试中覆盖 Solid summary 薄包装。 -- [x] 在 Python ctypes 中增加 Solid summary 薄包装。 -- [x] 在 Python inspect 中追加 Solid 字段。 -- [x] 在 Python run/checker 中覆盖 Solid-only smoke。 -- [x] 在 Python checker 中覆盖 Solid restart 读回 summary。 -- [x] 在 CLI inspect 中追加 Solid 字段。 -- [x] 在 CLI run 中追加 Solid 字段。 -- [x] 在 CLI checker 中覆盖 Solid 输入、run 和 restart。 -- [x] 确认新增 API 不改变 0.4.1 既有接口语义。 -- [x] 新增 `solid_c_api` 测试并接入 CTest。 -- [x] 新增 `solid_python` 测试并接入 CTest。 -- [x] 新增 `solid_cli` 测试并接入 CTest。 +- [ ] 在 summary CSV 中追加 `solid_max_strain_rate` 字段。 +- [ ] 在 summary CSV 中追加 `solid_max_acceleration` 字段。 +- [ ] 在 summary CSV 中追加 `solid_internal_force_residual` 字段。 +- [ ] 在 summary CSV 中追加 `solid_reference_neighbor_min` 字段。 +- [ ] 在 summary CSV 中追加 `solid_correction_det_min` 字段。 +- [ ] 在 summary CSV 中追加 `solid_correction_status` 字段。 +- [ ] 在粒子 CSV 中追加 `solid_strain_rate_eq` 字段。 +- [ ] 在粒子 CSV 中追加 `solid_acceleration_norm` 字段。 +- [ ] 在粒子 CSV 中追加 `solid_reference_neighbor_count` 字段。 +- [ ] 在粒子 CSV 中追加 `solid_correction_status` 字段。 +- [ ] 更新 output 测试锁定 0.5.1 CSV header。 +- [ ] 将 restart 状态版本更新为 `STATE_0_5_1`。 +- [ ] 将 Solid 参考邻居数写入 0.5.1 restart。 +- [ ] 将 Solid 修正矩阵状态写入 0.5.1 restart。 +- [ ] 将 Solid 修正矩阵行列式诊断写入 0.5.1 restart。 +- [ ] 将 Solid 变形梯度写入 0.5.1 restart。 +- [ ] 将 Solid 应变率状态写入 0.5.1 restart。 +- [ ] 将 Solid 0.5.1 新增诊断写入 restart。 +- [ ] 从 `STATE_0_5_1` restart 读回新增 Solid 状态。 +- [ ] 从 `STATE_0_5_1` restart 读回后继续显式步。 +- [ ] 从 `STATE_0_5` restart 兼容读入 Solid 0.5.0 状态。 +- [ ] 从 `STATE_0_5` restart 读入时初始化 0.5.1 新状态。 +- [ ] 从 `STATE_0_4_1` restart 读入时初始化空 Solid 0.5.1 状态。 +- [ ] 确认 restart 后不重复初始化 Solid 应力。 +- [ ] 确认 restart 后不重复初始化 Solid 塑性应变。 +- [ ] 确认 restart 后不重复初始化 Solid damage。 +- [ ] 确认 restart 后不重复初始化 Solid softening。 +- [ ] 确认 restart 后不重复初始化 Solid 变形梯度。 +- [ ] 新增 `solid_restart_051` 测试。 +- [ ] 新增 `solid_restart_050_compat` 测试。 +- [ ] 将 `solid_restart_051` 接入 CTest。 +- [ ] 将 `solid_restart_050_compat` 接入 CTest。 -## 阶段 H:回归、门禁、文档同步与发布准备 +## 阶段 H:Fortran API、C ABI、C++、Python 与 CLI -- [x] 新增 `solid_source_size` 检查项并接入 CTest。 -- [x] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。 -- [x] 拆分过大的 Solid 源文件或过长过程。 -- [x] 保持 0.4.1 完整 gate 全部通过。 -- [x] 单独运行 0.5.0 新增 Solid gate。 -- [x] 运行 `source_size` 检查并确认无新增无理由例外。 -- [x] 运行 `git diff --check` 并清理空白问题。 -- [x] 更新 README 的 0.5.0 当前状态和不交付范围。 -- [x] 更新 06 号文档的 0.5.0 release gate。 -- [x] 更新 09 号文档的 0.5.0 验收记录占位。 -- [x] 更新 11 号文档的 0.5.0 benchmark/gate 矩阵。 -- [x] 确认文档不宣称已实现 `Shell`。 -- [x] 确认文档不宣称已实现真实水-气-结构工程爆炸响应。 -- [x] 确认文档不宣称已实现真实 FEM-SPH 耦合。 -- [x] 确认文档不宣称已实现工程级结构破坏 benchmark。 -- [x] 确认未新增 FEMLite 直接依赖。 -- [x] 确认未修改 SPHLite 文件夹之外的内容。 -- [x] 确认默认 gate、Solid 专项 gate、source size 和 `git diff --check` 全部通过。 -- [x] 汇总 0.5.0 已完成能力、未交付范围和已知限制。 -- [x] 准备 0.5.0 发布前本地提交记录。 +- [ ] 新增 `sph_get_solid_state` Fortran API。 +- [ ] 新增 `sph_get_solid_diagnostics` Fortran API。 +- [ ] 新增 `sph_get_solid_reference_quality` Fortran API。 +- [ ] 为 Solid 0.5.1 Fortran API 补齐未初始化错误路径。 +- [ ] 为 Solid 0.5.1 Fortran API 补齐小容量错误路径。 +- [ ] 在 C 头文件中声明 `sphlite_get_solid_particle_state`。 +- [ ] 在 C ABI 中实现 Solid 粒子级状态查询。 +- [ ] 在 C ABI 中校验空指针错误路径。 +- [ ] 在 C ABI 中校验非正容量错误路径。 +- [ ] 在 C ABI 中校验小容量错误路径。 +- [ ] 在 C ABI 中锁定 stress 展开顺序。 +- [ ] 在 C ABI 中锁定 strain 展开顺序。 +- [ ] 在 C ABI 中锁定 strain-rate 展开顺序。 +- [ ] 在 C API 测试中覆盖 Solid 粒子级状态查询。 +- [ ] 在 C API 测试中覆盖 Solid 0.5.1 错误路径。 +- [ ] 在 C++ wrapper 中新增 Solid particle state 薄包装。 +- [ ] 在 C++ API 测试中覆盖 Solid particle state 薄包装。 +- [ ] 在 Python ctypes 中新增 Solid particle state 薄包装。 +- [ ] 在 Python inspect 中追加 Solid 0.5.1 诊断字段。 +- [ ] 在 Python run/checker 中覆盖 Solid 0.5.1 小模型。 +- [ ] 在 Python checker 中覆盖 `STATE_0_5_1` restart 读回。 +- [ ] 在 Python checker 中覆盖 `STATE_0_5` restart 兼容读入。 +- [ ] 在 CLI inspect 中追加 `solid_max_strain_rate` 字段。 +- [ ] 在 CLI inspect 中追加 `solid_max_acceleration` 字段。 +- [ ] 在 CLI inspect 中追加 `solid_internal_force_residual` 字段。 +- [ ] 在 CLI inspect 中追加 `solid_correction_status` 字段。 +- [ ] 在 CLI inspect 中追加 `solid_reference_neighbor_min` 字段。 +- [ ] 在 CLI run 中追加 Solid 0.5.1 诊断字段。 +- [ ] 在 CLI checker 中覆盖 Solid 0.5.1 输入、run 和 restart。 +- [ ] 确认新增 API 不改变 0.5.0 已有接口语义。 +- [ ] 新增 `solid_state_api` 测试并接入 CTest。 +- [ ] 新增 `solid_python_051` 测试并接入 CTest。 +- [ ] 新增 `solid_cli_051` 测试并接入 CTest。 + +## 阶段 I:源码尺寸、回归门禁、文档同步与发布准备 + +- [ ] 新增 `solid_051_source_size` 检查项并接入 CTest。 +- [ ] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。 +- [ ] 拆分过大的 Solid reference 源文件或过长过程。 +- [ ] 拆分过大的 Solid kinematics 源文件或过长过程。 +- [ ] 拆分过大的 Solid force 源文件或过长过程。 +- [ ] 拆分过大的 Solid restart 源文件或过长过程。 +- [ ] 保持 0.5.0 完整 gate 全部通过。 +- [ ] 单独运行 0.5.0 Solid 专项 gate。 +- [ ] 单独运行 0.5.1 Solid 专项 gate。 +- [ ] 运行 `source_size` 检查并确认无新增无理由例外。 +- [ ] 运行 `git diff --check` 并清理空白问题。 +- [ ] 更新 README 的 0.5.1 当前状态和不交付范围。 +- [ ] 更新 06 号文档的 0.5.1 release gate。 +- [ ] 更新 09 号文档的 0.5.1 验收记录占位。 +- [ ] 更新 11 号文档的 0.5.1 benchmark/gate 矩阵。 +- [ ] 确认文档不宣称已实现 `Shell`。 +- [ ] 确认文档不宣称已实现真实水-气-结构工程爆炸响应。 +- [ ] 确认文档不宣称已实现真实 FEM-SPH 耦合。 +- [ ] 确认文档不宣称已实现工程级结构破坏 benchmark。 +- [ ] 确认未新增几何、网格或粒子生成能力。 +- [ ] 确认未新增 FEMLite 直接依赖。 +- [ ] 确认未修改 SPHLite 文件夹之外的内容。 +- [ ] 确认默认 gate、0.5.0 Solid gate、0.5.1 Solid gate、source size 和 `git diff --check` 全部通过。 +- [ ] 汇总 0.5.1 已完成能力、未交付范围和已知限制。 +- [ ] 准备 0.5.1 发布前本地提交记录。 diff --git a/tools/testing/test_cli.py b/tools/testing/test_cli.py index 4a3c6b6..eca2c73 100644 --- a/tools/testing/test_cli.py +++ b/tools/testing/test_cli.py @@ -52,7 +52,7 @@ def main() -> int: version = run_command([exe, "--version"]) require_field(version.stdout, "version") - if "0.5.0" not in version.stdout: + if "0.5.1" not in version.stdout: raise AssertionError("CLI version mismatch") inspect = run_command([exe, model]) @@ -121,7 +121,7 @@ def main() -> int: ): require_field(inspect.stdout, field) inspect_fields = read_fields(inspect.stdout) - if inspect_fields["version"] != "0.5.0": + if inspect_fields["version"] != "0.5.1": raise AssertionError("inspect version field mismatch") if Path(inspect_fields["input"]) != Path(model): raise AssertionError("inspect input field mismatch") diff --git a/tools/testing/test_python_debug.py b/tools/testing/test_python_debug.py index 6fa3852..943a111 100644 --- a/tools/testing/test_python_debug.py +++ b/tools/testing/test_python_debug.py @@ -39,7 +39,7 @@ def main() -> int: raise AssertionError("Python wrapper is missing Explosive ignition C ABI") if not hasattr(solver.lib, "sphlite_get_solid_summary"): raise AssertionError("Python wrapper is missing Solid C ABI diagnostics") - if solver.version() != (0, 5, 0): + if solver.version() != (0, 5, 1): raise AssertionError("Python version mismatch") solver.initialize()