17 KiB
09 版本历史与验收记录
文档状态:0.5.0 本地验收记录
1. 当前状态
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. 规划版本线
| 版本线 | 目标 |
|---|---|
| 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
验收结果:
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_size1/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.0STATE_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=EXPLOSIVEmaterial、*SPHLITE EXPLOSIVEprogrammed 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。
0.5.0 本地验收记录
记录日期:2026-07-03
本地构建目录:build-codex-unix
版本定位:
- 0.5.0 是
Solid3D 实体结构粒子的起步闭环版本。 - 0.5.0 支持
TYPE=SOLIDmaterial、*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 内力/断裂加固,或进入
Shell0.6.0 前置设计。
发布记录:
- 0.5.0 已于 2026-07-03 完成本地发布记录提交,并准备标记
v0.5.0。
后续每个版本应记录:
- 完成能力。
- 明确不交付范围。
- 本地构建命令。
- CTest 结果。
- benchmark/checker 结果。
- 已知限制。
4. 待讨论问题
- 是否需要在 0.3 前完成最小可视化输出。
- 0.8 和 0.9 是否拆分为独立大版本。