200 lines
9.5 KiB
Markdown
200 lines
9.5 KiB
Markdown
# 09 版本历史与验收记录
|
||
|
||
文档状态:0.3.0 开发中
|
||
|
||
## 1. 当前状态
|
||
|
||
SPHLite 当前进入 0.3.0 `Gas` 首个正式开发版本。本版本在 0.2.2 `Water` 稳定化基线之上交付 Gas 输入、状态、EOS、显式推进、summary、bubble metrics、output、restart、C/C++/Python/CLI 诊断接口和 release gate;`Explosive`、`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 注入质量/动量/能量的源项路径。
|
||
|
||
后续每个版本应记录:
|
||
|
||
- 完成能力。
|
||
- 明确不交付范围。
|
||
- 本地构建命令。
|
||
- CTest 结果。
|
||
- benchmark/checker 结果。
|
||
- 已知限制。
|
||
|
||
## 4. 待讨论问题
|
||
|
||
- 是否需要在 0.3 前完成最小可视化输出。
|
||
- 0.8 和 0.9 是否拆分为独立大版本。
|