686 lines
35 KiB
Markdown
686 lines
35 KiB
Markdown
# 09 版本历史与验收记录
|
||
|
||
文档状态:0.8.1 本地验收记录
|
||
|
||
## 1. 当前状态
|
||
|
||
SPHLite 当前发布版本为 0.8.0 中立接触耦合接口起步版本;当前本地验收版本为 0.8.1 接触耦合接口稳定化版本。0.8.1 在 0.8.0 基础上追加 facet pressure/traction/resultant 导入、受控载荷分配、接触状态诊断、输出、restart、接口和 mock coupling gate。0.8.1 不交付真实 FEMLite 联合运行、外部 CouplingModule、连续体耦合、生产级接触算法或工程级水下接触爆炸舱段破坏 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`
|
||
|
||
构建配置:
|
||
|
||
```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`。
|
||
|
||
### 0.5.0 本地验收记录
|
||
|
||
记录日期:2026-07-03
|
||
|
||
本地构建目录:`build-codex-unix`
|
||
|
||
版本定位:
|
||
|
||
- 0.5.0 是 `Solid` 3D 实体结构粒子的起步闭环版本。
|
||
- 0.5.0 支持 `TYPE=SOLID` material、`*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 内力/断裂加固,或进入 `Shell` 0.6.0 前置设计。
|
||
|
||
发布记录:
|
||
|
||
- 0.5.0 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.5.0`。
|
||
|
||
### 0.5.1 本地验收记录
|
||
|
||
记录日期:2026-07-03
|
||
|
||
本地构建目录:`build-codex-unix`
|
||
|
||
版本定位:
|
||
|
||
- 0.5.1 是 0.5 `Solid` 版本线的稳定化和结构算法加固版本。
|
||
- 0.5.1 补强 Solid 参考邻域计数、退化状态、修正矩阵状态、修正矩阵行列式诊断和变形梯度状态。
|
||
- 0.5.1 新增 Solid 速度梯度、应变率、等效应变率、最小内力、softening 内力折减、最大加速度、最大应变率和内力动量残差诊断。
|
||
- 0.5.1 将 Solid 新状态写入 `STATE_0_5_1` restart,并兼容 `STATE_0_5` 读入时初始化新增状态。
|
||
- 0.5.1 追加 Solid 粒子级状态、诊断和参考质量的 Fortran API、C ABI、C++ wrapper、Python `ctypes`、CLI 字段和专项 CTest gate。
|
||
- 0.5.1 为 source size 门禁拆分 Solid C ABI、Python Solid 调试包装和 Solid API 查询模块;`src/solid/sph_solid.f90` 作为 Solid 输入/material 表 owner 登记说明性例外。
|
||
|
||
验收结果:
|
||
|
||
- `cmake --build build-codex-unix` 通过。
|
||
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:99/99。
|
||
- 0.5.0 Solid 回归 gate 通过:17/17。
|
||
- 0.5.1 Solid 专项 gate 通过:16/16。
|
||
- `ctest --test-dir build-codex-unix -R "^(source_size|solid_source_size|solid_051_source_size)$" --output-on-failure` 通过:3/3。
|
||
- `git diff --check` 通过。
|
||
- 代码、构建脚本、测试和工具目录中未新增 FEMLite 直接依赖。
|
||
|
||
不交付范围:
|
||
|
||
- 0.5.1 不交付 `Shell` 生产路径。
|
||
- 0.5.1 不交付真实水-气-结构工程爆炸响应。
|
||
- 0.5.1 不交付真实 FEM-SPH 接触耦合或连续体耦合。
|
||
- 0.5.1 不交付工程级结构破坏 benchmark、复杂断裂面追踪、碎片云、焊缝失效库、大规模并行或 GPU 后端。
|
||
|
||
已知限制:
|
||
|
||
- 0.5.1 Solid 内力仍是小型可测最小路径,不代表工程级结构破裂预测能力。
|
||
- 参考修正矩阵提供质量诊断和 fallback,但尚未交付复杂断裂面追踪或碎片云模型。
|
||
- `Shell` phase/status 与文档路线仍保留,但板壳生产计算路径尚未实现。
|
||
|
||
发布建议:
|
||
|
||
- 建议将 0.5.1 作为 Solid 稳定化版本发布。
|
||
- 0.5.1 发布后,后续主线可继续加固 Solid 断裂/接触前置能力,或进入 `Shell` 0.6.0 前置设计。
|
||
|
||
发布记录:
|
||
|
||
- 0.5.1 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.5.1`。
|
||
|
||
### 0.6.0 本地验收记录
|
||
|
||
记录日期:2026-07-03
|
||
|
||
本地构建目录:`build-codex-unix`
|
||
|
||
版本定位:
|
||
|
||
- 0.6.0 是 0.6 `Shell` 板壳粒子版本线的起点。
|
||
- 0.6.0 在 0.5.1 `Solid` 稳定化基线之上新增 `TYPE=SHELL` material 识别、`*SHELL SECTION` 输入解析、Shell section 映射、厚度、3 点/5 点积分规则和剪切修正校验。
|
||
- 0.6.0 新增 Shell 粒子级状态数组,包括 active、section/material 映射、厚度、积分点数、剪切修正、director/转动占位、应变、曲率、剪切应变、合力/合力矩和失效状态默认值。
|
||
- 0.6.0 新增 Shell 厚度积分点状态数组,包括积分点坐标、权重、应力、应变、塑性应变、等效塑性应变、damage、softening、温度、内能和失效状态默认值。
|
||
- 0.6.0 的 Shell 发布范围是输入与状态基线,不是完整 Shell 结构动力学闭环。
|
||
|
||
验收结果:
|
||
|
||
- `cmake --build build-codex-unix --parallel` 通过。
|
||
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:103/103。
|
||
- 0.6.0 Shell 输入/状态基线专项 gate 通过:4/4。
|
||
- `ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure` 通过:1/1。
|
||
- `git diff --check` 通过。
|
||
- 代码、构建脚本、测试和工具目录中未新增 FEMLite 直接依赖。
|
||
|
||
不交付范围:
|
||
|
||
- 0.6.0 不交付 director 或法向的真实更新。
|
||
- 0.6.0 不交付转动惯量、角速度、角加速度或转动显式推进。
|
||
- 0.6.0 不交付 Mindlin-Reissner 应变计算路径。
|
||
- 0.6.0 不交付 Shell Johnson-Cook 材料点更新、Shell 内力、Shell 内力矩或 Shell 稳定时间步。
|
||
- 0.6.0 不交付 Shell restart、公开 API、C ABI、C++ wrapper、Python ctypes 或 CLI 诊断字段。
|
||
- 0.6.0 不交付真实水-气-结构工程爆炸响应、真实 FEM-SPH 接触耦合或连续体耦合。
|
||
- 0.6.0 不交付工程级船舱破坏 benchmark、复杂撕裂面追踪、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。
|
||
|
||
已知限制:
|
||
|
||
- Shell 状态数组中的 director、转动、应变、曲率、剪切应变、内力和合力矩当前为初始化占位,不参与生产计算。
|
||
- Shell section 支持 3 点和 5 点厚度积分规则,但尚未用于真实厚度积分材料更新。
|
||
- 当前 Shell gate 只证明输入解析和状态构建可用,不代表工程级板壳变形、损伤或撕裂预测能力。
|
||
|
||
发布建议:
|
||
|
||
- 建议将 0.6.0 作为 Shell 输入与状态基线版本发布。
|
||
- 0.6.0 发布后,后续主线应继续完成 Shell director/转动、Mindlin-Reissner 应变、材料点、内力、显式推进、restart 和接口层。
|
||
|
||
发布记录:
|
||
|
||
- 0.6.0 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.6.0`。
|
||
|
||
### 0.6.1 本地验收记录
|
||
|
||
记录日期:2026-07-03
|
||
|
||
本地构建目录:`build-codex-unix`
|
||
|
||
版本定位:
|
||
|
||
- 0.6.1 是 0.6 `Shell` 板壳粒子版本线的运动学基线版本。
|
||
- 0.6.1 在 0.6.0 Shell 输入与状态基线之上新增显式 director 输入、`*ORIENTATION` 解析、Shell section orientation 引用和未使用 orientation warning。
|
||
- 0.6.1 支持从显式 set、section orientation、三角形/四边形参考面或局部粒子云推断 active Shell director,并记录 director 来源、退化数量和长度偏差诊断。
|
||
- 0.6.1 新增 active Shell 参考面积、等效转动惯量、局部 `e1/e2/e3` 坐标系、角速度、角加速度、最大角速度和 director 小转动更新入口。
|
||
- 0.6.1 新增 Mindlin-Reissner 小变形膜应变、弯曲应变、横向剪切应变、厚度积分点应变增量映射和运动学诊断查询入口。
|
||
- 0.6.1 的 Shell 发布范围仍是可测运动学基线,不是完整 Shell 结构动力学闭环。
|
||
|
||
验收结果:
|
||
|
||
- `cmake --build build-codex-unix --parallel` 通过。
|
||
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:113/113。
|
||
- 0.6.0 Shell 输入/状态基线专项 gate 通过:4/4。
|
||
- 0.6.1 Shell 运动学专项 gate 通过:13/13。
|
||
- `ctest --test-dir build-codex-unix -R "^(source_size|shell_061_source_size)$" --output-on-failure` 通过:2/2。
|
||
- `git diff --check` 通过。
|
||
- 代码、构建脚本、测试和工具目录中未新增 FEMLite 直接依赖。
|
||
|
||
不交付范围:
|
||
|
||
- 0.6.1 不交付 Shell Johnson-Cook 材料点更新。
|
||
- 0.6.1 不交付 Shell 内力、Shell 内力矩或 Shell 稳定时间步。
|
||
- 0.6.1 不交付完整显式推进生产路径、Shell restart、公开 C ABI、C++ wrapper、Python ctypes 或 CLI 诊断字段。
|
||
- 0.6.1 不交付真实水-气-结构工程爆炸响应、真实 FEM-SPH 接触耦合或连续体耦合。
|
||
- 0.6.1 不交付工程级船舱破坏 benchmark、复杂撕裂面追踪、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。
|
||
|
||
已知限制:
|
||
|
||
- Shell 小变形路径当前只形成运动学基线和积分点应变映射,不驱动材料点、内力或显式推进生产计算。
|
||
- `src/shell/sph_shell.f90` 暂作为 0.6.1 Shell 输入、状态、几何和运动学 owner 保留说明性 source size 例外,后续在材料点、内力、restart 或接口层进入前应优先拆分 geometry、kinematics 和 diagnostics 子模块。
|
||
- Shell 厚度积分点应变增量已经可测,但尚未用于真实厚度积分材料更新或失效演化。
|
||
|
||
发布建议:
|
||
|
||
- 建议将 0.6.1 作为 Shell 运动学基线版本发布。
|
||
- 0.6.1 发布后,后续主线应优先完成 Shell 材料点、内力/内力矩、稳定时间步和最小显式推进闭环;若 `sph_shell.f90` 继续增长,应先完成 Shell 子模块拆分。
|
||
|
||
发布记录:
|
||
|
||
- 0.6.1 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.6.1`。
|
||
|
||
### 0.7.0 本地验收记录
|
||
|
||
记录日期:2026-07-03
|
||
|
||
本地构建目录:`build-codex-unix`
|
||
|
||
版本定位:
|
||
|
||
- 0.7.0 是水-气-结构局部爆炸 smoke 起点版本。
|
||
- 0.7.0 在 0.6.1 Shell 运动学基线之上,新增 `*SPHLITE BLAST REGION` 输入控制、源/目标筛选、局部源项快照和结构外载荷缓存。
|
||
- 0.7.0 将局部爆炸外载荷接入显式推进中的 Solid/Shell 平动响应路径,并保留 Shell 内力和内力矩闭环的受控占位边界。
|
||
- 0.7.0 新增 Blast summary Fortran 查询、summary CSV 调试字段、粒子 CSV 结构外载荷字段和 restart 边界测试。
|
||
- 0.7.0 的局部爆炸诊断不进入公开 C ABI/C++/Python 稳定接口,也不写入正式 `STATE_0_7` restart。
|
||
|
||
验收结果:
|
||
|
||
- `cmake --build build-codex-unix --parallel` 通过。
|
||
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:127/127。
|
||
- 0.7.0 局部爆炸专项 gate 通过:14/14。
|
||
- source size 相关 gate 通过:7/7。
|
||
- `git diff --check` 通过。
|
||
- 代码、构建脚本、测试和工具目录中未新增 FEMLite 直接依赖。
|
||
|
||
不交付范围:
|
||
|
||
- 0.7.0 不交付真实工程级水下接触爆炸响应。
|
||
- 0.7.0 不交付真实 FEM-SPH 接触耦合或连续体耦合。
|
||
- 0.7.0 不交付完整舱段破坏 benchmark。
|
||
- 0.7.0 不交付复杂撕裂、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。
|
||
- 0.7.0 不宣称 Shell 完整动力学闭环;Shell 外载荷当前仅进入受控平动响应路径。
|
||
|
||
已知限制:
|
||
|
||
- 局部爆炸载荷为 smoke 级调试投影,不是工程级近场爆炸载荷算法。
|
||
- restart 仍保持既有 `STATE_0_5_1` 状态边界,Blast 控制和诊断在 0.7.0 不作为正式 restart state 保存。
|
||
- C ABI、C++ wrapper、Python ctypes 和 CLI 暂不公开 Blast 调试查询函数。
|
||
|
||
发布建议:
|
||
|
||
- 建议将 0.7.0 作为局部爆炸 smoke 起点版本发布。
|
||
- 0.7.0 发布后,后续主线应优先完善真实压力载荷投影、Shell 动力学闭环、restart 状态和稳定公开接口边界。
|
||
|
||
发布记录:
|
||
|
||
- 0.7.0 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.7.0`。
|
||
|
||
### 0.7.1 本地验收记录
|
||
|
||
记录日期:2026-07-04
|
||
|
||
本地构建目录:`build-codex-unix`
|
||
|
||
版本定位:
|
||
|
||
- 0.7.1 是局部爆炸链路稳定化版本。
|
||
- 0.7.1 在 0.7.0 blast smoke 起点之上,新增多 blast region 输入、禁用 region、重复 region 错误检查和源/目标统计加固。
|
||
- 0.7.1 补强 Solid/Shell 结构载荷叠加、诊断有限性、显式推进顺序和 no-active-target 回归。
|
||
- 0.7.1 新增 `blast_smoke_071`,覆盖 Solid、Shell、Solid/Shell 混合多 region、小型禁用载荷和无 active target 样例。
|
||
- 0.7.1 仍不新增公开 Blast C ABI/C++/Python 稳定接口,也不新增正式 Blast restart state。
|
||
|
||
验收结果:
|
||
|
||
- `cmake --build build-codex-unix --parallel` 通过。
|
||
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:139/139。
|
||
- Water/Gas/Explosive/Solid/Shell 分类 gate 通过:6/6、16/16、27/27、31/31、13/13。
|
||
- 0.7.0 blast 回归 gate 通过:14/14。
|
||
- 0.7.1 blast 专项 gate 通过:12/12。
|
||
- source size 相关 gate 通过:7/7。
|
||
- `git diff --check` 通过。
|
||
- 代码、构建脚本、测试和工具目录中未新增 FEMLite 直接依赖。
|
||
|
||
不交付范围:
|
||
|
||
- 0.7.1 不交付真实工程级水下接触爆炸响应。
|
||
- 0.7.1 不交付真实 FEM-SPH 接触耦合或连续体耦合。
|
||
- 0.7.1 不交付完整舱段破坏 benchmark。
|
||
- 0.7.1 不交付复杂撕裂、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。
|
||
- 0.7.1 不宣称 Shell 完整动力学闭环;Shell blast 仍只覆盖受控平动响应和诊断边界。
|
||
|
||
已知限制:
|
||
|
||
- Blast 外载荷仍是 smoke 级调试投影,不是工程级近场爆炸载荷算法。
|
||
- restart 仍保持既有 `STATE_0_5_1` 状态边界,Blast 控制和诊断不作为正式 restart state 保存。
|
||
- C ABI、C++ wrapper、Python ctypes 和 CLI 暂不公开 Blast 调试查询函数。
|
||
|
||
发布建议:
|
||
|
||
- 建议将 0.7.1 作为局部爆炸稳定化版本记录。
|
||
- 0.7.1 之后,若继续沿 blast 主线推进,应优先进入 0.8.0 的耦合边界设计或真实压力载荷投影设计。
|
||
|
||
发布记录:
|
||
|
||
- 0.7.1 已于 2026-07-04 完成本地发布记录提交,并准备标记 `v0.7.1`。
|
||
|
||
### 0.8.0 本地验收记录
|
||
|
||
记录日期:2026-07-04
|
||
|
||
本地构建目录:`build-codex-unix`
|
||
|
||
版本定位:
|
||
- 0.8.0 是 SPHLite 侧中立接触耦合接口起步版本。
|
||
- 0.8.0 新增并验收 `*SPHLITE COUPLING REGION` 的 0.8 子集、active/disabled region 构建、phase/material/section 过滤和 `TYPE=CONTACT` 启用路径。
|
||
- 0.8.0 支持按 region 导出粒子状态和 Shell Facet Proxy,导入外部粒子力、facet load 和 direct motion boundary。
|
||
- 0.8.0 将 coupling 外部载荷接入显式步,记录当前力、冲量、做功、动量/能量交换、stale/skipped/nonfinite/imported 计数和最大响应诊断。
|
||
- 0.8.0 新增 `STATE_0_8` restart,保存 coupling region、导入缓存、运动边界和累计诊断,并兼容既有 restart 读入时初始化空 coupling 状态。
|
||
- 0.8.0 追加 Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI inspect 的 coupling 查询、导出、导入和诊断入口。
|
||
- 0.8.0 新增 `coupling_smoke_080`,覆盖 Solid mock contact、Shell mock contact、Solid/Shell 混合、disabled region、no-active response 和 stale/repeated import。
|
||
|
||
验收结果:
|
||
- `cmake --build build-codex-unix` 通过。
|
||
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:163/163。
|
||
- 0.8.0 coupling 专项 gate 通过:24/24。
|
||
- Water/Gas/Explosive/Solid/Shell 分类 gate 通过:6/6、19/19、28/28、33/33、14/14。
|
||
- 0.7.0 blast 回归 gate 通过:19/19。
|
||
- 0.7.1 blast 专项 gate 通过:7/7。
|
||
- source size 相关 gate 通过:8/8。
|
||
- `git diff --check` 通过。
|
||
- 代码、构建脚本、测试和工具目录未新增 FEMLite 或 CouplingModule 直接依赖。
|
||
- 输出目录、CSV、VTK、restart 和临时结果未进入待提交清单。
|
||
|
||
不交付范围:
|
||
- 0.8.0 不交付真实 FEMLite 联合运行。
|
||
- 0.8.0 不交付外部 CouplingModule、CoupleLite、CoupledLite 或 CouplingLite。
|
||
- 0.8.0 不交付连续体一部分 FEM 一部分 SPH 的生产级连续体耦合。
|
||
- 0.8.0 不交付生产级接触搜索、接触约束、摩擦、接触稳定化或工程接触参数库。
|
||
- 0.8.0 不交付工程级船舶水下接触爆炸舱段破坏 benchmark。
|
||
- 0.8.0 不交付复杂撕裂、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。
|
||
|
||
已知限制:
|
||
- Facet Proxy 当前仍是 Shell 粒子级中立代理,不等价于真实外表面重构。
|
||
- Mock coupling smoke 只验证 SPHLite 侧接口链路和受控响应,不代表真实外部耦合模块。
|
||
- Source size 中对 0.8.0 接口层、restart、CLI、Python/C++ wrapper 和 CouplingInterface 主文件登记了说明性例外;后续版本应优先拆分。
|
||
|
||
发布建议:
|
||
- 建议将 0.8.0 作为 SPHLite 侧中立接触耦合接口起步版本发布。
|
||
- 0.8.0 发布后,后续主线应优先推进接口拆分、耦合边界稳定性、真实外部耦合模块对接设计和连续体耦合的需求拆分。
|
||
|
||
发布记录:
|
||
- 0.8.0 已于 2026-07-04 完成本地发布 gate,并准备标记 `v0.8.0`。
|
||
|
||
### 0.8.1 本地验收记录
|
||
|
||
记录日期:2026-07-04
|
||
|
||
本地构建目录:`build-codex-unix`
|
||
|
||
版本定位:
|
||
- 0.8.1 是 SPHLite 侧中立接触耦合接口稳定化版本。
|
||
- 0.8.1 在 0.8.0 coupling region、粒子/Facet Proxy 导出、外部载荷/运动边界导入和 diagnostics 基础上,新增 `LOAD_MODE=PRESSURE`、`LOAD_MODE=TRACTION`、facet resultant、`DISTRIBUTION=UNIFORM/AREA/MASS` 和 `CONTACT_STATE=IMPORT` 的稳定化测试。
|
||
- 0.8.1 新增 contact flag、normal、gap、penetration、contact pressure 缓存,以及 active/skipped contact、stale/repeated/nonfinite/bad area/invalid weight、最大 pressure/traction/penetration 和载荷守恒诊断。
|
||
- 0.8.1 将新增 contact 和载荷守恒字段写入 summary CSV、粒子 CSV 和 `STATE_0_8_1` restart,并兼容读入 `STATE_0_8` coupling restart 后初始化 0.8.1 新增状态。
|
||
- 0.8.1 追加 Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI inspect 的 pressure、traction、contact state、load balance 和 contact diagnostics 入口。
|
||
- 0.8.1 新增 `coupling_smoke_081`,覆盖 Solid 等效 surface pressure、Shell pressure、traction、pressure-motion 混合和 stale epoch mock coupling 样例。
|
||
|
||
验收结果:
|
||
- `cmake --build build-codex-unix --parallel` 通过。
|
||
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:189/189。
|
||
- 0.8.1 coupling 专项 gate 通过:26/26。
|
||
- 0.8.0 coupling 回归 gate 通过:24/24。
|
||
- Water/Gas/Explosive/Solid/Shell 分类 gate 通过:6/6、19/19、29/29、33/33、14/14。
|
||
- 0.7.0 blast 回归 gate 通过:15/15。
|
||
- 0.7.1 blast 专项 gate 通过:11/11。
|
||
- source size 相关 gate 通过:9/9。
|
||
- `git diff --check` 通过。
|
||
- 代码、构建脚本、测试和工具目录未新增 FEMLite 直接依赖。
|
||
- 输出目录、CSV、VTK、restart 和临时结果未进入待提交清单。
|
||
|
||
不交付范围:
|
||
- 0.8.1 不交付真实 FEMLite 联合运行。
|
||
- 0.8.1 不交付外部 CouplingModule、CoupleLite、CoupledLite 或 CouplingLite。
|
||
- 0.8.1 不交付连续体一部分 FEM 一部分 SPH 的生产级连续体耦合。
|
||
- 0.8.1 不交付生产级接触搜索、接触约束、摩擦、接触稳定化或工程接触参数库。
|
||
- 0.8.1 不交付工程级船舶水下接触爆炸舱段破坏 benchmark。
|
||
- 0.8.1 不交付复杂撕裂、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。
|
||
|
||
已知限制:
|
||
- Solid surface pressure smoke 当前使用等效粒子力验证 Solid 受压方向响应,不表示 0.8.1 已实现 Solid 实体表面 facet pressure 重构。
|
||
- Shell Facet Proxy 当前仍是 Shell 粒子级中立代理,不等价于真实外表面重构。
|
||
- Mock coupling smoke 只验证 SPHLite 侧接口链路和受控响应,不代表真实外部耦合模块。
|
||
- Source size 中对 0.8.1 相关接口层、restart、输出、测试和 CouplingInterface 主文件继续通过 source size gate 约束;后续版本应继续拆分 owner 文件。
|
||
|
||
发布建议:
|
||
- 0.8.1 可以作为 SPHLite 侧中立接触耦合接口稳定化版本进入发布准备。
|
||
- 0.8.1 发布后,后续主线可进入 0.8.2 接口清理/错误路径加固,或进入 0.9.0 连续体耦合需求拆分,但不应在 0.8.1 内宣称真实 FEMLite 联合运行。
|
||
|
||
后续每个版本应记录:
|
||
|
||
- 完成能力。
|
||
- 明确不交付范围。
|
||
- 本地构建命令。
|
||
- CTest 结果。
|
||
- benchmark/checker 结果。
|
||
- 已知限制。
|
||
|
||
## 4. 待讨论问题
|
||
|
||
- 是否需要在 0.3 前完成最小可视化输出。
|
||
- 0.8 和 0.9 是否拆分为独立大版本。
|