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

5.0 KiB
Raw Blame History

09 版本历史与验收记录

文档状态:0.2.1 本地验收进行中

1. 当前状态

SPHLite 当前进入 0.2.1 Water 基础 SPH 加固版本。本版本在 0.2.0 最小闭环基础上加固输入、状态一致性、Water 算法边界、output、restart、API/CLI、CouplingInterface 占位和 pressure wave smoke;Gas、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

构建配置:

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

构建配置:

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

构建配置:

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

当前已通过阶段性验收:

  • coupling_interface、c_api、cpp_api、python_debug、cli、pressure_wave_smoke、source_size 通过。
  • 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 接口。

后续每个版本应记录:

  • 完成能力。
  • 明确不交付范围。
  • 本地构建命令。
  • CTest 结果。
  • benchmark/checker 结果。
  • 已知限制。

4. 待讨论问题

  • 是否需要在 0.3 前完成最小可视化输出。
  • 0.8 和 0.9 是否拆分为独立大版本。