Finalize 0.5.0 gate records

This commit is contained in:
Codex
2026-07-03 16:32:27 +08:00
parent 708016c9af
commit dfeb452b41
6 changed files with 158 additions and 30 deletions
+9
View File
@@ -652,3 +652,12 @@ add_test(
--exceptions "${CMAKE_CURRENT_SOURCE_DIR}/tests/source_size_exceptions.txt"
)
set_tests_properties(gas_source_size_cleanup PROPERTIES WORKING_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}")
add_test(
NAME solid_source_size
COMMAND "${Python3_EXECUTABLE}"
"${CMAKE_CURRENT_SOURCE_DIR}/tools/testing/check_source_size.py"
--root "${CMAKE_CURRENT_SOURCE_DIR}"
--exceptions "${CMAKE_CURRENT_SOURCE_DIR}/tests/source_size_exceptions.txt"
)
set_tests_properties(solid_source_size PROPERTIES WORKING_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}")
+7 -5
View File
@@ -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.0。该版本定位为 `Solid` 3D 实体结构粒子起步版本,在 0.4.1 已建立 Water/Gas/Explosive 稳定闭环的基础上,完成 Solid 输入、状态、本构、失效、显式推进、restart、接口和测试 gate 的最小闭环。不交付 `Shell` 的生产路径,也不交付真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行或工程级结构破坏 benchmark。
代码仓库地址:
@@ -63,7 +63,7 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格:
## 当前状态
0.5.0 当前在 0.4.1 `Explosive` 稳定化基线之上启动 `Solid` 起步开发。0.4.1 已完成内容主要包括:
0.5.0 当前已在 0.4.1 `Explosive` 稳定化基线之上完成 `Solid` 起步闭环。0.4.1 已完成内容主要包括:
- CMake/CTest 工程骨架和 Fortran 95 核心库。
- C ABI、C++ 头文件薄包装和 Python `ctypes` 调试入口。
@@ -75,7 +75,9 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格:
- `Explosive` summary、CSV 输出字段、`STATE_0_4` restart、0.3.1 restart 兼容读入、Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 字段。
- 0.4.1 在 0.4.0 基础上加固多点点火、多炸药材料、冻结反应质量、release balance、SOURCE/PHASE 诊断、Water/Gas/Explosive 混合 smoke、`STATE_0_4_1` restart 和 `STATE_0_4` 兼容读入。
- 0.4.1 追加 release balance 的 Fortran API、C ABI、C++ wrapper、Python ctypes、CLI 和专项 CTest gate。
- 0.5.0 将围绕 `Solid` 3D 实体结构粒子的 material/section 输入、Johnson-Cook 材料与失效、渐进软化、Solid-only 显式 smoke、`STATE_0_5` restart 和接口诊断开展。
- CouplingInterface 的中立数据导出、外部粒子力导入和诊断占位;0.2.2 不暴露 CouplingInterface C ABI,真实 FEM-SPH 联合运行仍由外部 CouplingModule 后续实现。
- 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。
- CouplingInterface 的中立数据导出、外部粒子力导入和诊断占位保持可用;真实 FEM-SPH 联合运行仍由外部 CouplingModule 后续实现。
- `Shell` 仍为后续阶段,不在 0.5.0 交付生产计算路径。
- 0.4.1 本地 gate 已通过:完整 CTest 66/66,Explosive 专项 gate 14/14,`source_size` 通过。
- 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` 通过。
+37 -1
View File
@@ -1,6 +1,6 @@
# 06 测试与验证计划
文档状态:规划确认稿
文档状态:0.5.0 gate 记录
## 1. 测试原则
@@ -202,6 +202,42 @@ git diff --check
2026-07-03 本地结果:完整 CTest 66/66 通过,0.4.1 Explosive 专项 gate 14/14 通过,`source_size` 1/1 通过,`git diff --check` 通过。
## 7.4 0.5.0 Release Gate
0.5.0 在 0.4.1 `Explosive` 稳定化 gate 基础上新增 `Solid` 起步闭环测试。默认 gate 继续覆盖既有 Water/Gas/Explosive/接口/restart/output/source-size 路径,并新增以下 Solid 专项 gate:
- `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`
0.5.0 本地 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_explosive_multi_ignition|input_explosive_multimaterial|explosive_initial_mass_release|explosive_release_balance|explosive_source_targeting|explosive_phase_refresh|explosive_restart_041|explosive_restart_040_compat|explosive_restart_no_double_release|explosive_water_gas_smoke|explosive_release_c_api|explosive_release_python|explosive_release_cli|explosive_041_source_size)$" --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
```
2026-07-03 本地结果:完整 CTest 83/83 通过,0.4.1 Explosive 回归 gate 14/14 通过,0.5.0 Solid 专项 gate 17/17 通过,`source_size` 1/1 通过,`git diff --check` 通过。
0.5.0 不验收 `Shell` 生产路径,不验收真实水-气-结构工程爆炸响应,不验收真实 FEM-SPH 联合运行,也不验收工程级结构破坏 benchmark。
## 8. Source Size 门禁
从第一版开始设置 source size 门禁。建议沿用 FEMLite 风格:
+51 -2
View File
@@ -1,10 +1,10 @@
# 09 版本历史与验收记录
文档状态:0.4.1 已发布记录
文档状态:0.5.0 本地验收记录
## 1. 当前状态
SPHLite 当前进入 0.4.1 `Explosive` 稳定化版本。本版本在 0.4.0 已建立的解析点火、爆轰到达时间、programmed burn、Gas 源项注入、phase 转化、restart 和接口 gate 基础上,加固多点点火、多炸药材料、冻结反应质量、release balance、Water/Gas/Explosive 混合 smoke 和 restart 兼容;`Solid`、`Shell` 生产路径和真实 FEM-SPH 联合运行仍不在本版本交付范围内。
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 仍不在本版本交付范围内。
## 2. 规划版本线
@@ -292,6 +292,55 @@ cmake --build build-codex-unix
- 0.4.1 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.4.1`。
### 0.5.0 本地验收记录
记录日期:2026-07-03
本地构建目录:`build-codex-unix`
版本定位:
- 0.5.0 是 `Solid` 3D 实体结构粒子的起步闭环版本。
- 0.5.0 支持 `TYPE=SOLID` material、`*DENSITY`、`*ELASTIC`、Johnson-Cook flow/failure 参数、Solid control softening 参数和 `*SOLID SECTION` 映射。
- 0.5.0 新增 Solid 应力、应变、塑性应变、塑性应变率、温度、damage、softening、内能、失效状态、参考体积和梯度修正占位状态。
- 0.5.0 支持弹性材料点、Johnson-Cook flow、Johnson-Cook failure damage 累积、线性渐进软化和失效状态切换。
- 0.5.0 将 Solid 接入 Velocity-Verlet 显式推进,提供体力驱动 smoke、结构波速稳定时间步、Solid 动能/内能/动量/max von Mises/damage/softening/dt 诊断。
- 0.5.0 restart 写入 `STATE_0_5`,保存 Solid material 表和 per-particle 状态,并兼容 `STATE_0_4_1` 及更早状态读入时初始化空 Solid 状态。
- 0.5.0 追加 Solid summary 和 failure counts 的 Fortran API、C ABI、C++ wrapper、Python `ctypes`、CLI 字段和专项 CTest gate。
验收结果:
- `cmake --build build-codex-unix --parallel` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:83/83。
- 0.4.1 Explosive 回归 gate 通过:14/14。
- 0.5.0 Solid 专项 gate 通过:17/17。
- `ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure` 通过:1/1。
- `git diff --check` 通过。
- `tests/source_size_exceptions.txt` 未新增 Solid 例外,stale exception 检查通过。
- 代码、构建脚本、测试和工具目录中未新增 FEMLite 直接依赖。
不交付范围:
- 0.5.0 不交付 `Shell` 生产路径。
- 0.5.0 不交付真实水-气-结构工程爆炸响应。
- 0.5.0 不交付真实 FEM-SPH 接触耦合或连续体耦合。
- 0.5.0 不交付工程级结构破坏 benchmark、复杂断裂面追踪、碎片云或焊缝失效库。
已知限制:
- 0.5.0 Solid 显式推进以最小体力驱动、状态闭环和诊断闭环为主,不代表已经具备工程级结构破裂预测能力。
- 梯度修正和参考构型状态已经建表和验收占位,后续版本仍需继续完善真实结构内力、应变率和断裂传播算法。
- Solid material summary 暂不对外暴露,当前接口只暴露 Solid 计数、能量、动量、damage、softening、dt 和失效统计。
发布建议:
- 建议将 0.5.0 作为 Solid 起步闭环版本发布。
- 0.5.0 发布后,后续主线可继续进入 Solid 内力/断裂加固,或进入 `Shell` 0.6.0 前置设计。
发布记录:
- 0.5.0 已完成本地发布前验收记录,待后续发布命令创建标签并按需推送远端。
后续每个版本应记录:
- 完成能力。
+34 -2
View File
@@ -1,10 +1,10 @@
# 11 Benchmark 与验收矩阵
文档状态:0.4.1 gate 记录
文档状态:0.5.0 gate 记录
## 1. 当前状态
0.4.1 在 0.4.0 `Explosive` 起步闭环基础上新增稳定化 gate,并继续保留工程 benchmark 矩阵作为长期规划。本版本的 Explosive programmed burn、Gas 源项注入、phase 转化、release balance、pressure wave smoke 和 Gas bubble metrics 只用于小规模数值链路检查,不作为工程精度 benchmark。
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。
## 2. 0.1.0 Release Gate
@@ -265,6 +265,38 @@
|---|---|---|
| 2026-07-03 | `build-codex-unix` | 完整 CTest 66/66 通过,0.4.1 Explosive gate 14/14 通过,`source_size` 1/1 通过,`git diff --check` 通过 |
## 2.9 0.5.0 Release Gate
0.5.0 默认 gate 在 0.4.1 Explosive 稳定化 gate 基础上新增 Solid 输入、状态、本构、失效、显式推进、output、restart、接口和 source size 验收。
| 测试名 | 类型 | 验收点 |
|---|---|---|
| `input_solid_material` | Fortran input | Solid material、密度、弹性、Johnson-Cook flow/failure、softening 和 section 映射 |
| `input_solid_errors` | Fortran input | 缺密度、缺弹性、非法 Johnson-Cook 参数和非法 Solid section error 路径 |
| `solid_state_build` | Fortran module | Solid 状态数组分配、默认值、active/failed 计数和非 Solid 安全默认值 |
| `solid_elastic_material` | Fortran unit | 弹性材料点应力、内能和等效应力更新 |
| `solid_johnson_cook_flow` | Fortran unit | Johnson-Cook 热软化、应变率项、硬化项和屈服应力 |
| `solid_johnson_cook_failure` | Fortran unit | failure strain、damage 单调累积、失效状态切换 |
| `solid_progressive_softening` | Fortran unit | damage/softening 范围限制和线性渐进软化 |
| `solid_gradient_correction` | Fortran module | 参考体积、参考构型邻域和梯度修正占位状态 |
| `solid_stable_dt` | Fortran module | 结构波速稳定时间步和全局 dt 约束 |
| `solid_explicit_smoke` | Fortran smoke | Solid-only 体力驱动显式推进、能量和动量诊断 |
| `solid_output` | Fortran output | summary CSV 和粒子 CSV 的 Solid 字段 |
| `solid_restart_050` | Fortran restart | `STATE_0_5` 写入读回 Solid material 和 per-particle 状态 |
| `solid_restart_041_compat` | Fortran restart | `STATE_0_4_1` 兼容读入并初始化空 Solid 状态 |
| `solid_c_api` | C ABI | Solid summary、failure counts 和错误路径 |
| `solid_python` | Python `ctypes` | Solid summary 薄包装和 inspect/run 字段 |
| `solid_cli` | CLI | Solid inspect/run/restart 字段检查 |
| `solid_source_size` | 工具门禁 | Solid source size 和 stale exception 检查 |
0.5.0 不验收 `Shell` 生产路径,不验收真实水-气-结构工程爆炸响应,不验收真实 FEM-SPH 联合运行,也不验收工程级结构破坏 benchmark。Solid 显式 smoke 仅证明 0.5.0 状态、推进、输出、restart 和接口链路闭合。
本地验收记录:
| 日期 | 构建目录 | 结果 |
|---|---|---|
| 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` 通过 |
## 3. 基础数值矩阵
| 领域 | 测试或 benchmark | 验收点 |
+20 -20
View File
@@ -202,23 +202,23 @@
## 阶段 H:回归、门禁、文档同步与发布准备
- [ ] 新增 `solid_source_size` 检查项并接入 CTest。
- [ ] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。
- [ ] 拆分过大的 Solid 源文件或过长过程。
- [ ] 保持 0.4.1 完整 gate 全部通过。
- [ ] 单独运行 0.5.0 新增 Solid gate。
- [ ] 运行 `source_size` 检查并确认无新增无理由例外。
- [ ] 运行 `git diff --check` 并清理空白问题。
- [ ] 更新 README 的 0.5.0 当前状态和不交付范围。
- [ ] 更新 06 号文档的 0.5.0 release gate。
- [ ] 更新 09 号文档的 0.5.0 验收记录占位。
- [ ] 更新 11 号文档的 0.5.0 benchmark/gate 矩阵。
- [ ] 确认文档不宣称已实现 `Shell`。
- [ ] 确认文档不宣称已实现真实水-气-结构工程爆炸响应。
- [ ] 确认文档不宣称已实现真实 FEM-SPH 耦合。
- [ ] 确认文档不宣称已实现工程级结构破坏 benchmark。
- [ ] 确认未新增 FEMLite 直接依赖。
- [ ] 确认未修改 SPHLite 文件夹之外的内容。
- [ ] 确认默认 gate、Solid 专项 gate、source size 和 `git diff --check` 全部通过。
- [ ] 汇总 0.5.0 已完成能力、未交付范围和已知限制。
- [ ] 准备 0.5.0 发布前本地提交记录。
- [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 发布前本地提交记录。