diff --git a/CMakeLists.txt b/CMakeLists.txt index 1cbfab5..1b3e580 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -529,6 +529,15 @@ add_test( ) set_tests_properties(explosive_source_size PROPERTIES WORKING_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}") +add_test( + NAME explosive_041_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(explosive_041_source_size PROPERTIES WORKING_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}") + add_test( NAME gas_source_size_cleanup COMMAND "${Python3_EXECUTABLE}" diff --git a/README.md b/README.md index edff4eb..b87ed4a 100644 --- a/README.md +++ b/README.md @@ -63,7 +63,7 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: ## 当前状态 -0.4.1 当前在 `Explosive` 起步闭环基础上开展稳定化,0.4.0 已完成内容主要包括: +0.4.1 当前已完成 `Explosive` 起步闭环后的稳定化加固。0.4.0 已完成内容主要包括: - CMake/CTest 工程骨架和 Fortran 95 核心库。 - C ABI、C++ 头文件薄包装和 Python `ctypes` 调试入口。 @@ -73,6 +73,8 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: - Gas material、三类 Gas EOS、Gas 状态初始化、单相显式推进、气体 summary、bubble metrics、Gas CSV/restart、Gas 源项缓存和公开诊断接口。 - `Explosive` 的解析点火、爆轰到达时间、programmed burn 反应进度、释放量统计、Gas 源项注入和 phase 转化最小闭环。 - `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。 - CouplingInterface 的中立数据导出、外部粒子力导入和诊断占位;0.2.2 不暴露 CouplingInterface C ABI,真实 FEM-SPH 联合运行仍由外部 CouplingModule 后续实现。 -- `Solid`、`Shell` 仍为后续阶段,不在 0.4.0 交付生产计算路径。 -- 0.4.0 本地 gate 已通过:完整 CTest 51/51,Explosive 专项 gate 14/14,`source_size` 通过。 +- `Solid`、`Shell` 仍为后续阶段,不在 0.4.1 交付生产计算路径。 +- 0.4.1 本地 gate 已通过:完整 CTest 66/66,Explosive 专项 gate 14/14,`source_size` 通过。 diff --git a/docs/06_test_and_verification_plan.md b/docs/06_test_and_verification_plan.md index 23ca692..59d85f9 100644 --- a/docs/06_test_and_verification_plan.md +++ b/docs/06_test_and_verification_plan.md @@ -172,6 +172,36 @@ git diff --check 2026-07-03 本地结果:完整 CTest 51/51 通过,Explosive 专项 gate 14/14 通过,`source_size` 1/1 通过,`git diff --check` 通过。 +## 7.3 0.4.1 Release Gate + +0.4.1 在 0.4.0 `Explosive` 起步闭环 gate 基础上新增稳定化和兼容性测试。默认 gate 继续覆盖既有 Water/Gas/Explosive/接口/restart/output/source-size 路径,并新增以下 Explosive 专项 gate: + +- `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` + +0.4.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_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 "^source_size$" --output-on-failure +git diff --check +``` + +2026-07-03 本地结果:完整 CTest 66/66 通过,0.4.1 Explosive 专项 gate 14/14 通过,`source_size` 1/1 通过,`git diff --check` 通过。 + ## 8. Source Size 门禁 从第一版开始设置 source size 门禁。建议沿用 FEMLite 风格: diff --git a/docs/09_release_history.md b/docs/09_release_history.md index e1e576c..05e9006 100644 --- a/docs/09_release_history.md +++ b/docs/09_release_history.md @@ -1,10 +1,10 @@ # 09 版本历史与验收记录 -文档状态:0.4.0 已发布记录 +文档状态:0.4.1 本地验收记录 ## 1. 当前状态 -SPHLite 当前进入 0.4.0 `Explosive` 起步版本。本版本在 0.3.1 `Gas` 稳定化基础上新增炸药解析点火、爆轰到达时间、programmed burn 反应进度、向 Gas 源项注入质量/动量/能量、完全反应后 phase 转化、summary/output/restart/API/CLI/Python 验收;`Solid`、`Shell` 生产路径和真实 FEM-SPH 联合运行仍不在本版本交付范围内。 +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 联合运行仍不在本版本交付范围内。 ## 2. 规划版本线 @@ -254,6 +254,40 @@ cmake --build build-codex-unix - 0.4.0 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.4.0`。 +### 0.4.1 本地验收记录 + +记录日期:2026-07-03 + +本地构建目录:`build-codex-unix` + +版本定位: + +- 0.4.1 是 0.4 `Explosive` 版本线的稳定化和回归加固版本。 +- 0.4.1 支持多点点火取最早到达、多炸药 material 独立 programmed burn 参数和多 product Gas material 映射。 +- 0.4.1 冻结每粒子初始反应质量,并用 `delta_lambda` 驱动 release mass、release energy 和 release momentum 一致性统计。 +- 0.4.1 新增 release balance、SOURCE target、PHASE 转化和 Water/Gas/Explosive 混合 smoke 诊断。 +- 0.4.1 restart 写入 `STATE_0_4_1`,保存反应质量基准、release balance 和 SOURCE/PHASE 诊断,并兼容 `STATE_0_4` 读入。 +- 0.4.1 追加 release balance 的 Fortran API、C ABI、C++ wrapper、Python ctypes、CLI、CSV output 和专项 CTest gate。 + +验收结果: + +- `cmake --build build-codex-unix --parallel` 通过。 +- `ctest --test-dir build-codex-unix --output-on-failure` 通过:66/66。 +- 0.4.1 Explosive 专项 gate 通过:14/14。 +- `ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure` 通过:1/1。 +- `git diff --check` 通过。 + +不交付范围: + +- 0.4.1 不交付 `Solid`、`Shell` 生产路径。 +- 0.4.1 不交付真实 FEM-SPH 接触耦合或连续体耦合。 +- 0.4.1 不交付工程级水下爆炸 benchmark、完整化学反应爆轰模型、球面经验载荷主模型或气泡长周期脉动模型。 + +发布建议: + +- 建议发布 0.4.1 作为 Explosive 稳定化版本。 +- 0.4.1 发布后,后续主线可进入 `Solid`/`Shell` 前置能力,或继续加固 Explosive-Gas-Water 的工程输入和 benchmark 链路。 + 后续每个版本应记录: - 完成能力。 diff --git a/docs/11_benchmark_matrix.md b/docs/11_benchmark_matrix.md index 416391f..749e7fb 100644 --- a/docs/11_benchmark_matrix.md +++ b/docs/11_benchmark_matrix.md @@ -1,10 +1,10 @@ # 11 Benchmark 与验收矩阵 -文档状态:0.4.0 gate 记录 +文档状态:0.4.1 gate 记录 ## 1. 当前状态 -0.4.0 在 0.3.1 `Gas` 稳定化基础上新增 `Explosive` 起步闭环 gate,并继续保留工程 benchmark 矩阵作为长期规划。本版本的 Explosive programmed burn、Gas 源项注入、phase 转化、pressure wave smoke 和 Gas bubble metrics 只用于小规模数值链路检查,不作为工程精度 benchmark。 +0.4.1 在 0.4.0 `Explosive` 起步闭环基础上新增稳定化 gate,并继续保留工程 benchmark 矩阵作为长期规划。本版本的 Explosive programmed burn、Gas 源项注入、phase 转化、release balance、pressure wave smoke 和 Gas bubble metrics 只用于小规模数值链路检查,不作为工程精度 benchmark。 ## 2. 0.1.0 Release Gate @@ -236,6 +236,35 @@ |---|---|---| | 2026-07-03 | `build-codex-unix` | 完整 CTest 51/51 通过,Explosive gate 14/14 通过,`source_size` 1/1 通过,`git diff --check` 通过 | +## 2.8 0.4.1 Release Gate + +0.4.1 默认 gate 在 0.4.0 Explosive gate 基础上新增多点点火、多炸药材料、冻结反应质量、release balance、SOURCE/PHASE 诊断、restart 兼容和接口层验收。 + +| 测试名 | 类型 | 验收点 | +|---|---|---| +| `input_explosive_multi_ignition` | Fortran input | 同一 material 多点点火、顺序无关和最早到达时间 | +| `input_explosive_multimaterial` | Fortran input | 多 Explosive material、多 product Gas material 和 warning/error 路径 | +| `explosive_initial_mass_release` | Fortran module | 冻结初始反应质量并保持释放量基准一致 | +| `explosive_release_balance` | Fortran module | 初始、已释放、剩余质量、能量和动量闭合诊断 | +| `explosive_source_targeting` | Fortran module | SOURCE 只注入匹配 product material 的 active Gas 粒子 | +| `explosive_phase_refresh` | Fortran module | PHASE 转化后 phase、material、密度、能量、压力和 Gas summary 刷新 | +| `explosive_restart_041` | Fortran restart | `STATE_0_4_1` 写入读回新增 Explosive 状态 | +| `explosive_restart_040_compat` | Fortran restart | `STATE_0_4` 兼容读入并初始化 0.4.1 新状态 | +| `explosive_restart_no_double_release` | Fortran restart | restart 后继续推进不重复释放 | +| `explosive_water_gas_smoke` | Fortran smoke | Water/Gas/Explosive 混合小算例显式推进 | +| `explosive_release_c_api` | C ABI | release balance 查询和错误路径 | +| `explosive_release_python` | Python `ctypes` | release balance 薄包装和 inspect/run 字段 | +| `explosive_release_cli` | CLI | inspect/run 输出 release balance 字段 | +| `explosive_041_source_size` | 工具门禁 | 0.4.1 Explosive source size 和 stale exception 检查 | + +0.4.1 不验收 `Solid`、`Shell` 的生产级物理结果,也不验收真实 FEM-SPH 联合运行。Explosive-Water-Gas 链路仍是小规模数值闭环,不代表工程级水下接触爆炸 benchmark。 + +本地验收记录: + +| 日期 | 构建目录 | 结果 | +|---|---|---| +| 2026-07-03 | `build-codex-unix` | 完整 CTest 66/66 通过,0.4.1 Explosive gate 14/14 通过,`source_size` 1/1 通过,`git diff --check` 通过 | + ## 3. 基础数值矩阵 | 领域 | 测试或 benchmark | 验收点 | diff --git a/tests/module/test_restart.f90 b/tests/module/test_restart.f90 index a90256c..e0fdced 100644 --- a/tests/module/test_restart.f90 +++ b/tests/module/test_restart.f90 @@ -168,7 +168,7 @@ contains call fail('restart version mismatch') end if if (patch /= SPH_VERSION_PATCH) call fail('restart patch mismatch') - if (trim(state_version) /= 'STATE_0_4') call fail('restart state version mismatch') + if (trim(state_version) /= 'STATE_0_4_1') call fail('restart state version mismatch') read(74, *, iostat=ios) file_time, file_step, count if (ios /= 0) call fail('restart time state read failed') if (abs(file_time - expected_time) > 1.0e-12_rk) call fail('restart time write mismatch') diff --git a/todo.md b/todo.md index f66a71a..47618b7 100644 --- a/todo.md +++ b/todo.md @@ -125,23 +125,23 @@ ## 阶段 F:回归、门禁、文档同步与发布准备 -- [ ] 新增 `input_explosive_multi_ignition` 测试并接入 CTest。 -- [ ] 新增 `input_explosive_multimaterial` 测试并接入 CTest。 -- [ ] 新增 `explosive_initial_mass_release` 测试并接入 CTest。 -- [ ] 新增 `explosive_release_balance` 测试并接入 CTest。 -- [ ] 新增 `explosive_source_targeting` 测试并接入 CTest。 -- [ ] 新增 `explosive_phase_refresh` 测试并接入 CTest。 -- [ ] 新增 `explosive_restart_041` 测试并接入 CTest。 -- [ ] 新增 `explosive_restart_040_compat` 测试并接入 CTest。 -- [ ] 新增 `explosive_restart_no_double_release` 测试并接入 CTest。 -- [ ] 新增 `explosive_water_gas_smoke` 测试并接入 CTest。 -- [ ] 新增 `explosive_release_c_api` 测试并接入 CTest。 -- [ ] 新增 `explosive_release_python` 测试并接入 CTest。 -- [ ] 新增 `explosive_release_cli` 测试并接入 CTest。 -- [ ] 新增 `explosive_041_source_size` 检查项并接入 CTest。 -- [ ] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。 -- [ ] 保持 0.4.0 完整 gate 全部通过。 -- [ ] 单独运行 0.4.1 新增 Explosive gate。 -- [ ] 运行 `source_size` 检查并确认无新增无理由例外。 -- [ ] 运行 `git diff --check` 并清理空白问题。 -- [ ] 更新 README、06、09 和 11 号文档的 0.4.1 测试和验收记录。 +- [x] 新增 `input_explosive_multi_ignition` 测试并接入 CTest。 +- [x] 新增 `input_explosive_multimaterial` 测试并接入 CTest。 +- [x] 新增 `explosive_initial_mass_release` 测试并接入 CTest。 +- [x] 新增 `explosive_release_balance` 测试并接入 CTest。 +- [x] 新增 `explosive_source_targeting` 测试并接入 CTest。 +- [x] 新增 `explosive_phase_refresh` 测试并接入 CTest。 +- [x] 新增 `explosive_restart_041` 测试并接入 CTest。 +- [x] 新增 `explosive_restart_040_compat` 测试并接入 CTest。 +- [x] 新增 `explosive_restart_no_double_release` 测试并接入 CTest。 +- [x] 新增 `explosive_water_gas_smoke` 测试并接入 CTest。 +- [x] 新增 `explosive_release_c_api` 测试并接入 CTest。 +- [x] 新增 `explosive_release_python` 测试并接入 CTest。 +- [x] 新增 `explosive_release_cli` 测试并接入 CTest。 +- [x] 新增 `explosive_041_source_size` 检查项并接入 CTest。 +- [x] 复核 `tests/source_size_exceptions.txt` 中 stale 例外。 +- [x] 保持 0.4.0 完整 gate 全部通过。 +- [x] 单独运行 0.4.1 新增 Explosive gate。 +- [x] 运行 `source_size` 检查并确认无新增无理由例外。 +- [x] 运行 `git diff --check` 并清理空白问题。 +- [x] 更新 README、06、09 和 11 号文档的 0.4.1 测试和验收记录。