Files
SPHLite/docs/09_release_history.md
T
2026-07-03 14:07:17 +08:00

308 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 09 版本历史与验收记录
文档状态:0.4.1 已发布记录
## 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 联合运行仍不在本版本交付范围内。
## 2. 规划版本线
| 版本线 | 目标 |
|---|---|
| 0.1.0 | 工程骨架、生命周期、错误码、C ABI、CLI、Python 调试入口和测试框架 |
| 0.1.1 | 输入元数据、粒子状态查询、C++ wrapper、CLI/output/restart/CouplingInterface gate 加固 |
| 0.2 | 粒子状态、核函数、邻域搜索和基础 `Water` |
| 0.3 | `Gas`、基础 EOS、气体统计和气泡诊断 |
| 0.4 | `Explosive`、解析点火、爆轰传播和产物气体注入 |
| 0.5 | 3D `Solid` 弹塑性、损伤和基础破裂 |
| 0.6 | `Shell` 板壳变形、损伤和撕裂 |
| 0.7 | 水-气-结构局部爆炸 smoke |
| 0.8 | SPH-FEM 接触耦合 |
| 0.9 | SPH-FEM 连续体耦合 |
| 1.0 | 船舱局部破坏综合 benchmark |
## 3. 验收记录
### 0.1.0 本地验收记录
记录日期:2026-07-02
本地构建目录:`build-codex-unix`
构建配置:
```powershell
cmake -S . -B build-codex-unix -G "Unix Makefiles" -DCMAKE_C_COMPILER=C:/gcc-16.1.0-64/bin/gcc.exe -DCMAKE_Fortran_COMPILER=C:/gcc-16.1.0-64/bin/gfortran.exe -DCMAKE_MAKE_PROGRAM=C:/gcc-16.1.0-64/bin/make.exe
cmake --build build-codex-unix --parallel
```
验收结果:
- `sphlite_core`、`sphlite_c` 和 `sphlite` 完整编译通过。
- `ctest -R "^(smoke|input|c_api|python_debug)$"` 通过,4/4。
- `ctest -R "^source_size$"` 通过,1/1。
- `git diff --check` 通过。
- CLI inspect 模式通过:`sphlite tests/data/minimal_particles.inp`。
- CLI run 模式通过:`sphlite tests/data/minimal_particles.inp --run`。
- 已通过 `.gitignore` 排除 build 目录、CSV/VTK/restart 临时结果和 Python 缓存。
- 文档已明确 0.1.0 不交付生产级 Water、Gas、Explosive、Solid、Shell 物理算法。
说明:0.1.0 已提交并推送到远端,标签为 `v0.1.0`。
### 0.1.1 本地验收记录
记录日期:2026-07-02
本地构建目录:`build-codex-unix`
构建配置:
```powershell
cmake -S . -B build-codex-unix -G "Unix Makefiles" -DCMAKE_C_COMPILER=C:/gcc-16.1.0-64/bin/gcc.exe -DCMAKE_CXX_COMPILER=C:/gcc-16.1.0-64/bin/g++.exe -DCMAKE_Fortran_COMPILER=C:/gcc-16.1.0-64/bin/gfortran.exe -DCMAKE_MAKE_PROGRAM=C:/gcc-16.1.0-64/bin/make.exe
cmake --build build-codex-unix --parallel
```
验收结果:
- `sphlite_core`、`sphlite_c`、`sphlite` 和 `test_cpp_api` 完整编译通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过,10/10。
- `source_size` 通过。
- `git diff --check` 通过。
- CLI `--version`、inspect、`--check`、`--run` 和错误输入路径通过。
- output、restart 和 CouplingInterface 占位测试通过。
- 文档已明确 0.1.1 不交付生产级 Water、Gas、Explosive、Solid、Shell 物理算法。
### 0.2.0 本地验收记录
记录日期:2026-07-02
本地构建目录:`build-codex-unix`
构建配置:
```powershell
cmake -S . -B build-codex-unix -G "Unix Makefiles" -DCMAKE_C_COMPILER=C:/gcc-16.1.0-64/bin/gcc.exe -DCMAKE_CXX_COMPILER=C:/gcc-16.1.0-64/bin/g++.exe -DCMAKE_Fortran_COMPILER=C:/gcc-16.1.0-64/bin/gfortran.exe -DCMAKE_MAKE_PROGRAM=C:/gcc-16.1.0-64/bin/make.exe
cmake --build build-codex-unix
```
验收结果:
- `sphlite_core`、`sphlite_c`、`sphlite_c_shared`、`sphlite` 和新增测试目标完整编译通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过,18/18。
- `source_size` 通过。
- `git diff --check` 通过。
- `Water` 基础弱可压 SPH 路径通过 kernel、neighbor、EOS、连续性方程、人工黏性、压力力、显式推进、output、restart、pressure wave smoke、C ABI、C++、Python 和 CLI gate。
- 0.2.0 不交付 `Gas`、`Explosive`、`Solid`、`Shell` 生产路径。
- 0.2.0 不交付真实 FEM-SPH 联合运行;CouplingInterface 仅提供中立数据导出、外部粒子力导入和诊断占位。
### 0.2.1 本地验收记录
记录日期:2026-07-02
本地构建目录:`build-codex-unix`
验收结果:
- `ctest --test-dir build-codex-unix -R "^(smoke|input|kernel|neighbor|water_eos|water_density|water_viscosity|water_force|solver_water|output|restart|coupling_interface|c_api|cpp_api|python_debug|cli|pressure_wave_smoke)$"` 通过,17/17。
- `ctest --test-dir build-codex-unix -R "^source_size$"` 通过,1/1。
- `git diff --check` 通过。
- 0.2.1 交付范围限定为 `Water` 基础路径加固、接口错误路径加固、restart/output 加固和小型 smoke/checker 加固。
- 0.2.1 不交付 `Gas`、`Explosive`、`Solid`、`Shell` 生产路径。
- 0.2.1 不交付真实 FEM-SPH 联合运行;CouplingInterface 仍为中立 Fortran 模块级占位,不暴露 C ABI coupling 接口。
- restart 文件继续写入 `STATE_0_2` 状态版本,并在 0.2.1 gate 中验证 current time、current step、Water 参数、诊断、粒子状态和邻域重建。
- 0.2.1 `Water` 生产 EOS 只接受 `TYPE=TAIT`;非 `TYPE=TAIT` 作为无法运行的输入错误处理。
- 0.2.1 保留 Tait EOS 在 `rho < rho0` 时得到的拉伸负压,不做压力截断或空化修正。
- 0.2.1 不新增 VTK 输出;默认 gate 继续使用 CSV 粒子输出和 summary CSV。
### 0.2.2 本地验收记录
记录日期:2026-07-03
本地构建目录:`build-codex-unix`
开发起点:`f8c1c9f Finalize 0.2.1 gate records`
版本定位:
- 0.2.2 是 0.2 `Water` 阶段后的稳定化补丁版本。
- 0.2.2 复核并保持 0.2.1 的 Water 计算行为、接口边界和默认 gate。
- 0.2.2 不交付 `Gas`、`Explosive`、`Solid`、`Shell` 生产路径。
- 0.2.2 不交付真实 FEM-SPH 联合运行;CouplingInterface 仍为中立 Fortran 模块级占位,不暴露 C ABI coupling 接口。
- 0.2.2 不新增几何、网格或粒子生成能力。
- 0.2.2 release gate 已通过:默认 gate 17/17 通过,`source_size` 1/1 通过,`git diff --check` 通过。
验收结果:
- `cmake -S . -B build-codex-unix -G "Unix Makefiles" -DCMAKE_C_COMPILER=C:/gcc-16.1.0-64/bin/gcc.exe -DCMAKE_CXX_COMPILER=C:/gcc-16.1.0-64/bin/g++.exe -DCMAKE_Fortran_COMPILER=C:/gcc-16.1.0-64/bin/gfortran.exe -DCMAKE_MAKE_PROGRAM=C:/gcc-16.1.0-64/bin/make.exe` 通过。
- `cmake --build build-codex-unix --parallel` 通过。
- `ctest --test-dir build-codex-unix -R "^(smoke|input|kernel|neighbor|water_eos|water_density|water_viscosity|water_force|solver_water|output|restart|coupling_interface|c_api|cpp_api|python_debug|cli|pressure_wave_smoke)$" --output-on-failure` 通过:17/17。
- `ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure` 通过:1/1。
- `git diff --check` 通过。
实际修复和整理:
- 软件版本、CMake 项目版本、CLI/API 测试期望统一更新为 0.2.2。
- README、09 和 11 号文档记录 0.2.2 稳定化补丁定位。
- 04 号算法文档明确 0.2.2 继续沿用 0.2.1 的 Water 连续性方程、Tait EOS、负压保留和无空化修正策略。
- CouplingInterface 中陈旧的 0.1.1 占位错误信息改为中立表述。
- 新增 `docs/v3.0_gas_handoff.md`,作为 0.3.0 Gas 输入、状态、EOS 测试命名和 Bubble 长期路线入口。
剩余风险和限制:
- 0.2.2 仍不交付 `Gas`、`Explosive`、`Solid`、`Shell` 生产路径。
- 0.2.2 仍不交付真实 FEM-SPH 联合运行。
- CouplingInterface 仍不暴露 C ABI coupling 接口。
- VTK 输出仍不进入默认 gate;0.2.2 默认输出为 CSV 和 summary CSV。
- pressure wave smoke 仍只用于小规模链路检查,不作为工程精度 benchmark。
发布建议:
- 建议发布 0.2.2 作为 Water 阶段稳定化补丁版本。
- 0.2.2 发布后,后续主线建议进入 0.3.0 Gas 开发。
### 0.3.0 本地验收记录
记录日期:2026-07-03
本地构建目录:`build-codex-unix`
版本定位:
- 0.3.0 是 `Gas` 模块第一个正式开发版本。
- 0.3.0 在 0.2.2 `Water` 稳定化基线之上新增 Gas material、理想气体/JWL/Stiffened gas EOS、Gas 状态初始化、Gas 单相显式推进、summary、bubble metrics、CSV output、restart、Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 诊断字段。
- 0.3.0 的 bubble metrics 为单气团近似,只用于 Gas 诊断和小规模链路检查,不作为工程精度气泡脉动 benchmark。
- 0.3.0 不交付 `Explosive` 点火/爆轰/源项注入,不交付 `Solid`、`Shell` 生产路径,不交付真实 FEM-SPH 联合运行。
- 0.3.0 restart 写入 `STATE_0_3`,并保留 `STATE_0_2` 读入容错路径。
验收结果:
- `cmake --build build-codex-unix` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:27/27。
- `ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure` 通过:1/1。
- `git diff --check` 通过。
发布建议:
- 若默认 gate、`source_size` 和 `git diff --check` 全部通过,建议发布 0.3.0 作为 Gas 最小闭环版本。
- 0.3.0 发布后,后续主线建议进入 0.4.0 `Explosive`,重点实现解析点火、爆轰传播和向 Gas 注入质量/动量/能量的源项路径。
### 0.3.1 本地验收记录
记录日期:2026-07-03
本地构建目录:`build-codex-unix`
版本定位:
- 0.3.1 是 0.3 `Gas` 版本线的稳定化和前置加固版本。
- 0.3.1 支持同一模型中多个 Gas material,并按 material 分派理想气体、JWL 和 Stiffened gas EOS。
- 0.3.1 新增 Gas 质量、动量、能量源项缓存和清零/累计/显式应用/诊断入口,但不实现 `Explosive` 反应。
- 0.3.1 restart 写入 `STATE_0_3_1`,保存 Gas material/EOS 表、源项缓存、dt 和 bubble 历史状态,并保持 0.3.0 `STATE_0_3` 兼容读入。
- 0.3.1 追加 Gas extended/source summary 的 Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 字段。
验收结果:
- `cmake --build build-codex-unix` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:37/37。
- `ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure` 通过:1/1。
- `git diff --check` 通过。
不交付范围:
- 0.3.1 不交付 `Explosive` 解析点火、爆轰传播、反应进度或炸药 phase 迁移。
- 0.3.1 不交付 `Solid`、`Shell` 生产路径。
- 0.3.1 不交付真实 FEM-SPH 接触耦合或连续体耦合。
发布建议:
- 建议发布 0.3.1 作为 Gas 稳定化版本。
- 0.3.1 发布后,后续主线可进入 0.4.0 `Explosive`,使用 0.3.1 已建立的 Gas 源项缓存作为质量/动量/能量注入入口。
### 0.4.0 本地验收记录
记录日期:2026-07-03
本地构建目录:`build-codex-unix`
版本定位:
- 0.4.0 是 `Explosive` 模块的起步闭环版本。
- 0.4.0 支持 `TYPE=EXPLOSIVE` material、`*SPHLITE EXPLOSIVE` programmed burn 控制和 `*SPHLITE IGNITION` 单点点火。
- 0.4.0 使用解析爆轰到达时间,不引入球面经验载荷主模型。
- 0.4.0 支持炸药反应进度、释放质量/动量/能量统计、`CONVERSION=SOURCE` 注入 Gas 源项,以及 `CONVERSION=PHASE` 完全反应后转为 Gas。
- 0.4.0 restart 写入 `STATE_0_4`,保存 Explosive material 表、点火记录和每粒子反应状态,并兼容 0.3.1 restart 读入时初始化空 Explosive 状态。
- 0.4.0 追加 Explosive summary 的 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` 通过:51/51。
- Explosive 专项 gate 通过:14/14。
- `ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure` 通过:1/1。
- `git diff --check` 通过。
不交付范围:
- 0.4.0 不交付 `Solid`、`Shell` 生产路径。
- 0.4.0 不交付真实 FEM-SPH 接触耦合或连续体耦合。
- 0.4.0 不交付工程级水下爆炸 benchmark、完整化学反应爆轰模型或气泡长周期脉动模型。
发布建议:
- 建议发布 0.4.0 作为 Explosive 起步闭环版本。
- 0.4.0 发布后,后续主线可进入 `Solid`/`Shell` 前置能力或继续加固 Explosive-Gas-Water 链路。
发布记录:
- 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 链路。
发布记录:
- 0.4.1 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.4.1`。
后续每个版本应记录:
- 完成能力。
- 明确不交付范围。
- 本地构建命令。
- CTest 结果。
- benchmark/checker 结果。
- 已知限制。
## 4. 待讨论问题
- 是否需要在 0.3 前完成最小可视化输出。
- 0.8 和 0.9 是否拆分为独立大版本。