Prepare Solid 0.5.1 release gate

This commit is contained in:
Codex
2026-07-03 18:46:18 +08:00
parent 348f244693
commit f06846dddb
14 changed files with 512 additions and 329 deletions
+38 -1
View File
@@ -1,6 +1,6 @@
# 06 测试与验证计划
文档状态:0.5.0 gate 记录
文档状态:0.5.1 gate 记录
## 1. 测试原则
@@ -238,6 +238,41 @@ git diff --check
0.5.0 不验收 `Shell` 生产路径,不验收真实水-气-结构工程爆炸响应,不验收真实 FEM-SPH 联合运行,也不验收工程级结构破坏 benchmark。
## 7.5 0.5.1 Release Gate
0.5.1 在 0.5.0 `Solid` 起步闭环 gate 基础上新增 `Solid` 稳定化和结构算法加固测试。默认 gate 继续覆盖既有 Water/Gas/Explosive/Solid/接口/restart/output/source-size 路径,并新增以下 Solid 0.5.1 专项 gate:
- `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`
0.5.1 本地 release 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|solid_source_size|solid_051_source_size)$" --output-on-failure
git diff --check
```
2026-07-03 本地结果:完整 CTest 99/99 通过,0.5.0 Solid 回归 gate 17/17 通过,0.5.1 Solid 专项 gate 16/16 通过,`source_size`/`solid_source_size`/`solid_051_source_size` 3/3 通过,`git diff --check` 通过。
0.5.1 不验收 `Shell` 生产路径,不验收真实水-气-结构工程爆炸响应,不验收真实 FEM-SPH 联合运行,也不验收工程级结构破坏 benchmark。0.5.1 的 Solid gate 只证明参考构型、速度梯度、应变率、最小内力、诊断、restart 和接口可观测性在小型模型内闭合。
## 8. Source Size 门禁
从第一版开始设置 source size 门禁。建议沿用 FEMLite 风格:
@@ -247,6 +282,8 @@ git diff --check
- 必要例外登记到例外清单。
- stale exception 应被检查。
0.5.1 为控制新增接口膨胀,已拆分 Solid C ABI、Python Solid 调试包装和 Solid API 查询模块。`src/solid/sph_solid.f90` 继续作为 Solid 输入/material 表 owner,并在例外清单中登记说明,后续若拆分 Solid material ownership 应同步移除此例外。
具体阈值可在实现阶段与 FEMLite 保持一致或按 SPHLite 文件结构微调。
## 9. 非默认长跑和研究项
+45 -2
View File
@@ -1,10 +1,10 @@
# 09 版本历史与验收记录
文档状态:0.5.0 本地验收记录
文档状态:0.5.1 本地验收记录
## 1. 当前状态
SPHLite 当前进入 0.5.0 `Solid` 起步闭环版本。本版本在 0.4.1 已建立的 Water/Gas/Explosive 稳定 gate 基础上,新增 3D 实体结构粒子的 material/section 输入、状态数组、弹性与 Johnson-Cook 材料点、失效与渐进软化、显式推进最小路径、CSV、`STATE_0_5` restart、接口诊断和 Solid 专项 gate;`Shell` 生产路径、真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行和工程级结构破坏 benchmark 仍不在本版本交付范围内。
SPHLite 当前进入 0.5.1 `Solid` 稳定化和结构算法加固版本。本版本在 0.5.0 已建立的 Solid 起步闭环基础上,补强参考构型、修正矩阵、速度梯度、应变率、最小内力、softening 力学作用、能量诊断、`STATE_0_5_1` restart、`STATE_0_5` 兼容读入、粒子级状态接口和 Solid 0.5.1 专项 gate;`Shell` 生产路径、真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行和工程级结构破坏 benchmark 仍不在本版本交付范围内。
## 2. 规划版本线
@@ -341,6 +341,49 @@ cmake --build build-codex-unix
- 0.5.0 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.5.0`。
### 0.5.1 本地验收记录
记录日期:2026-07-03
本地构建目录:`build-codex-unix`
版本定位:
- 0.5.1 是 0.5 `Solid` 版本线的稳定化和结构算法加固版本。
- 0.5.1 补强 Solid 参考邻域计数、退化状态、修正矩阵状态、修正矩阵行列式诊断和变形梯度状态。
- 0.5.1 新增 Solid 速度梯度、应变率、等效应变率、最小内力、softening 内力折减、最大加速度、最大应变率和内力动量残差诊断。
- 0.5.1 将 Solid 新状态写入 `STATE_0_5_1` restart,并兼容 `STATE_0_5` 读入时初始化新增状态。
- 0.5.1 追加 Solid 粒子级状态、诊断和参考质量的 Fortran API、C ABI、C++ wrapper、Python `ctypes`、CLI 字段和专项 CTest gate。
- 0.5.1 为 source size 门禁拆分 Solid C ABI、Python Solid 调试包装和 Solid API 查询模块;`src/solid/sph_solid.f90` 作为 Solid 输入/material 表 owner 登记说明性例外。
验收结果:
- `cmake --build build-codex-unix` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:99/99。
- 0.5.0 Solid 回归 gate 通过:17/17。
- 0.5.1 Solid 专项 gate 通过:16/16。
- `ctest --test-dir build-codex-unix -R "^(source_size|solid_source_size|solid_051_source_size)$" --output-on-failure` 通过:3/3。
- `git diff --check` 通过。
- 代码、构建脚本、测试和工具目录中未新增 FEMLite 直接依赖。
不交付范围:
- 0.5.1 不交付 `Shell` 生产路径。
- 0.5.1 不交付真实水-气-结构工程爆炸响应。
- 0.5.1 不交付真实 FEM-SPH 接触耦合或连续体耦合。
- 0.5.1 不交付工程级结构破坏 benchmark、复杂断裂面追踪、碎片云、焊缝失效库、大规模并行或 GPU 后端。
已知限制:
- 0.5.1 Solid 内力仍是小型可测最小路径,不代表工程级结构破裂预测能力。
- 参考修正矩阵提供质量诊断和 fallback,但尚未交付复杂断裂面追踪或碎片云模型。
- `Shell` phase/status 与文档路线仍保留,但板壳生产计算路径尚未实现。
发布建议:
- 建议将 0.5.1 作为 Solid 稳定化版本发布。
- 0.5.1 发布后,后续主线可继续加固 Solid 断裂/接触前置能力,或进入 `Shell` 0.6.0 前置设计。
后续每个版本应记录:
- 完成能力。
+33 -2
View File
@@ -1,10 +1,10 @@
# 11 Benchmark 与验收矩阵
文档状态:0.5.0 gate 记录
文档状态:0.5.1 gate 记录
## 1. 当前状态
0.5.0 在 0.4.1 Water/Gas/Explosive 稳定 gate 基础上新增 `Solid` 起步闭环 gate,并继续保留工程 benchmark 矩阵作为长期规划。本版本的 Solid material point、damage、softening、显式 smoke、pressure wave smoke、Explosive programmed burn、Gas 源项注入和 Gas bubble metrics 只用于小规模数值链路检查,不作为工程精度 benchmark。
0.5.1 在 0.5.0 `Solid` 起步闭环 gate 基础上新增 Solid 稳定化和结构算法加固 gate,并继续保留工程 benchmark 矩阵作为长期规划。本版本的 Solid 参考邻域、修正矩阵、速度梯度、应变率、最小内力、damage、softening、显式 smoke、pressure wave smoke、Explosive programmed burn、Gas 源项注入和 Gas bubble metrics 只用于小规模数值链路检查,不作为工程精度 benchmark。
## 2. 0.1.0 Release Gate
@@ -297,6 +297,37 @@
|---|---|---|
| 2026-07-03 | `build-codex-unix` | 完整 CTest 83/83 通过,0.4.1 Explosive gate 14/14 通过,0.5.0 Solid gate 17/17 通过,`source_size` 1/1 通过,`git diff --check` 通过 |
## 2.10 0.5.1 Release Gate
0.5.1 默认 gate 在 0.5.0 Solid gate 基础上新增参考构型、速度梯度、应变率、最小内力、能量诊断、restart 兼容和接口可观测性验收。
| 测试名 | 类型 | 验收点 |
|---|---|---|
| `solid_051_input_validation` | Fortran input | 泊松比、Johnson-Cook 非有限参数、softening 类型、section/material 映射和缺失 Solid section 错误路径 |
| `solid_reference_neighbor` | Fortran module | active Solid 参考邻域计数、非 Solid 跳过和退化邻域诊断 |
| `solid_correction_matrix` | Fortran module | 修正矩阵行列式、状态码、近奇异 fallback 和 summary 质量诊断 |
| `solid_velocity_gradient` | Fortran module | 均匀平动零梯度和单轴拉伸速度梯度 |
| `solid_strain_increment` | Fortran module | 由应变率更新 Voigt 应变增量、总应变和材料点路径 |
| `solid_internal_force_pair` | Fortran module | 成对 Solid 粒子内力对称性和动量残差 |
| `solid_uniform_stress_balance` | Fortran module | 对称均匀应力下内力残差受控 |
| `solid_softening_force` | Fortran module | softening 因子作用到 Solid 内力贡献 |
| `solid_energy_diagnostics` | Fortran module | 动能、内能、塑性功等效量、最大应变率和最大加速度诊断 |
| `solid_dt_acceleration` | Fortran module | Solid wave dt 与 acceleration dt 合并并进入全局稳定时间步 |
| `solid_restart_051` | Fortran restart | `STATE_0_5_1` 写入读回新增 Solid 状态并继续显式步 |
| `solid_restart_050_compat` | Fortran restart | `STATE_0_5` 兼容读入并初始化 0.5.1 新状态 |
| `solid_state_api` | Fortran API | Solid 粒子级状态、诊断和参考质量 API 容量/错误路径 |
| `solid_python_051` | Python `ctypes` | Solid 0.5.1 诊断、粒子级状态、restart 读回和兼容读入 |
| `solid_cli_051` | CLI | Solid 0.5.1 inspect/run/restart 字段检查 |
| `solid_051_source_size` | 工具门禁 | 0.5.1 Solid source size、拆分结果和 stale exception 检查 |
0.5.1 不验收 `Shell` 生产路径,不验收真实水-气-结构工程爆炸响应,不验收真实 FEM-SPH 联合运行,也不验收工程级结构破坏 benchmark。Solid 0.5.1 gate 只证明小型结构算法闭环和接口可观测性,不代表工程级断裂路径预测。
本地验收记录:
| 日期 | 构建目录 | 结果 |
|---|---|---|
| 2026-07-03 | `build-codex-unix` | 完整 CTest 99/99 通过,0.5.0 Solid gate 17/17 通过,0.5.1 Solid gate 16/16 通过,`source_size`/`solid_source_size`/`solid_051_source_size` 3/3 通过,`git diff --check` 通过 |
## 3. 基础数值矩阵
| 领域 | 测试或 benchmark | 验收点 |