diff --git a/CMakeLists.txt b/CMakeLists.txt index 61980b5..002bcdd 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -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}") diff --git a/README.md b/README.md index b1647f1..cfde3b2 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.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` 通过。 diff --git a/docs/06_test_and_verification_plan.md b/docs/06_test_and_verification_plan.md index 59d85f9..7293c68 100644 --- a/docs/06_test_and_verification_plan.md +++ b/docs/06_test_and_verification_plan.md @@ -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 风格: diff --git a/docs/09_release_history.md b/docs/09_release_history.md index 7468124..587d7fd 100644 --- a/docs/09_release_history.md +++ b/docs/09_release_history.md @@ -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 已完成本地发布前验收记录,待后续发布命令创建标签并按需推送远端。 + 后续每个版本应记录: - 完成能力。 diff --git a/docs/11_benchmark_matrix.md b/docs/11_benchmark_matrix.md index 749e7fb..6a7f571 100644 --- a/docs/11_benchmark_matrix.md +++ b/docs/11_benchmark_matrix.md @@ -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 | 验收点 | diff --git a/todo.md b/todo.md index 497c681..d8b60b2 100644 --- a/todo.md +++ b/todo.md @@ -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 发布前本地提交记录。