diff --git a/README.md b/README.md index 158d6a3..61a5816 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。 -当前目标版本:0.2.0。该版本定位为 `Water` 基础 SPH 最小闭环版,在 0.1.1 工程框架和接口闭合基础上交付 3D 水相弱可压 SPH 的核函数、邻域搜索、Tait EOS、人工黏性、连续性方程、显式推进、诊断输出、restart、CLI/API 和 pressure wave smoke。不交付 `Gas`、`Explosive`、`Solid`、`Shell` 的生产路径,也不交付真实 FEM-SPH 联合运行。 +当前目标版本:0.2.1。该版本定位为 `Water` 基础 SPH 加固版,在 0.2.0 最小闭环基础上加固输入校验、粒子状态一致性、核函数/邻域边界、Tait EOS、连续性方程、人工黏性、压力力、显式推进、CSV 输出、restart、CLI/API、CouplingInterface 占位和 pressure wave smoke。不交付 `Gas`、`Explosive`、`Solid`、`Shell` 的生产路径,也不交付真实 FEM-SPH 联合运行。 代码仓库地址: @@ -63,13 +63,13 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: ## 当前状态 -0.2.0 当前实现重点包括: +0.2.1 当前实现重点包括: - CMake/CTest 工程骨架和 Fortran 95 核心库。 - C ABI、C++ 头文件薄包装和 Python `ctypes` 调试入口。 - Abaqus `.inp` 明确子集解析,以及 `*SPHLITE EOS`、`*SPHLITE VISCOSITY`、`*SPHLITE PARTICLE CONTROL`、`*SPHLITE BODY FORCE`。 - 3D Water 粒子的 Wendland/Cubic 核函数、uniform cell 邻域搜索、Tait EOS、Monaghan 人工黏性、连续性方程和 Velocity-Verlet 显式推进。 -- Water summary、稳定时间步诊断、CSV output、restart 和 pressure wave smoke。 -- CouplingInterface 的中立数据导出、外部粒子力导入和诊断占位;真实 FEM-SPH 联合运行仍由外部 CouplingModule 后续实现。 -- `Gas`、`Explosive`、`Solid`、`Shell` 仍为后续阶段,不在 0.2.0 交付生产计算路径。 -- 0.2.0 release gate 与 source size 门禁。 +- Water summary、稳定时间步诊断、CSV output、restart 和双 pressure wave smoke 小算例。 +- CouplingInterface 的中立数据导出、外部粒子力导入和诊断占位;0.2.1 不暴露 CouplingInterface C ABI,真实 FEM-SPH 联合运行仍由外部 CouplingModule 后续实现。 +- `Gas`、`Explosive`、`Solid`、`Shell` 仍为后续阶段,不在 0.2.1 交付生产计算路径。 +- 0.2.1 release gate 与 source size 门禁。 diff --git a/docs/09_release_history.md b/docs/09_release_history.md index 1f3b38c..6da73b7 100644 --- a/docs/09_release_history.md +++ b/docs/09_release_history.md @@ -1,10 +1,10 @@ # 09 版本历史与验收记录 -文档状态:0.2.0 本地验收通过 +文档状态:0.2.1 本地验收进行中 ## 1. 当前状态 -SPHLite 当前完成 0.2.0 `Water` 基础 SPH 最小闭环版本的本地验收。该版本交付 3D 水相弱可压 SPH 的最小可测试计算路径;`Gas`、`Explosive`、`Solid`、`Shell` 生产路径和真实 FEM-SPH 联合运行仍不在本版本交付范围内。 +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. 规划版本线 @@ -94,6 +94,19 @@ cmake --build build-codex-unix - 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 接口。 + 后续每个版本应记录: - 完成能力。 diff --git a/docs/11_benchmark_matrix.md b/docs/11_benchmark_matrix.md index 0957639..cf3275d 100644 --- a/docs/11_benchmark_matrix.md +++ b/docs/11_benchmark_matrix.md @@ -1,10 +1,10 @@ # 11 Benchmark 与验收矩阵 -文档状态:0.2.0 gate 记录 +文档状态:0.2.1 gate 记录 ## 1. 当前状态 -0.2.0 交付 `Water` 基础弱可压 SPH 的最小可测试 gate,并继续保留工程 benchmark 矩阵作为长期规划。本版本的 pressure wave smoke 只用于小规模数值链路检查,不作为工程精度 benchmark。 +0.2.1 在 0.2.0 `Water` 基础弱可压 SPH 最小可测试 gate 上进行加固,并继续保留工程 benchmark 矩阵作为长期规划。本版本的 pressure wave smoke 只用于小规模数值链路检查,不作为工程精度 benchmark。 ## 2. 0.1.0 Release Gate @@ -77,6 +77,36 @@ |---|---|---| | 2026-07-02 | `build-codex-unix` | 0.2.0 gate 18/18 通过,`git diff --check` 通过 | +## 2.3 0.2.1 Release Gate + +| 测试名 | 类型 | 验收点 | +|---|---|---| +| `smoke` | Fortran smoke | 版本 0.2.1、生命周期和显式步进错误路径 | +| `input` | Fortran input | Water 关键字、coupling region 类型、warning/error 路径 | +| `kernel` | Fortran unit | 核函数边界、错误路径和有限性 | +| `neighbor` | Fortran unit | 邻域边界、容量、统计和小规模一致性 | +| `water_eos` | Fortran module | Tait EOS、负压策略、声速和 summary | +| `water_density` | Fortran module | 连续性方程、跳过规则和低密度错误路径 | +| `water_viscosity` | Fortran module | Monaghan 参数、方向、有限性和跳过规则 | +| `water_force` | Fortran module | 压力力、body force、外部粒子力占位和跳过规则 | +| `solver_water` | Fortran module | 显式推进、stable dt、API 兼容和错误默认值 | +| `output` | Fortran output | 自动输出、手动输出不改状态、CSV 字段和目录错误路径 | +| `restart` | Fortran restart | 0.2.1 state version、Water 状态、诊断、读回和非法文件 | +| `coupling_interface` | Fortran coupling | Water 状态导出、外力导入、work/momentum/energy 诊断 | +| `c_api` | C ABI | 空指针、小容量、错误码透传和 Water 诊断 | +| `cpp_api` | C++ wrapper | RAII 生命周期、薄包装和 Water 诊断 | +| `python_debug` | Python `ctypes` | C ABI 加载、inspect/run、Water 诊断和错误路径 | +| `cli` | CLI | version、inspect、check、run、output 和错误输入 | +| `pressure_wave_smoke` | Fortran smoke | 5 粒子线性和 3D 非共线压力扰动、小规模趋势检查 | +| `source_size` | 工具门禁 | Fortran/C/C++/Python 文件和 stale exception | + +0.2.1 不验收 `Gas`、`Explosive`、`Solid`、`Shell` 的生产级物理结果,也不验收真实 FEM-SPH 联合运行。CouplingInterface 不在 0.2.1 暴露 C ABI。 + +阶段性验收记录: +| 日期 | 构建目录 | 结果 | +|---|---|---| +| 2026-07-02 | `build-codex-unix` | `coupling_interface`、`c_api`、`cpp_api`、`python_debug`、`cli`、`pressure_wave_smoke`、`source_size` 和 `git diff --check` 通过 | + ## 3. 基础数值矩阵 | 领域 | 测试或 benchmark | 验收点 | diff --git a/todo.md b/todo.md index dbdd5c2..1205263 100644 --- a/todo.md +++ b/todo.md @@ -420,29 +420,29 @@ - [x] 运行 `solver_water` 测试。 - [x] 运行 `output` 测试。 - [x] 运行 `restart` 测试。 -- [ ] 运行 `coupling_interface` 测试。 -- [ ] 运行 `c_api` 测试。 -- [ ] 运行 `cpp_api` 测试。 -- [ ] 运行 `python_debug` 测试。 -- [ ] 运行 `cli` 测试。 -- [ ] 运行 `pressure_wave_smoke` 测试。 -- [ ] 运行 `source_size` 测试。 -- [ ] 运行 `git diff --check`。 +- [x] 运行 `coupling_interface` 测试。 +- [x] 运行 `c_api` 测试。 +- [x] 运行 `cpp_api` 测试。 +- [x] 运行 `python_debug` 测试。 +- [x] 运行 `cli` 测试。 +- [x] 运行 `pressure_wave_smoke` 测试。 +- [x] 运行 `source_size` 测试。 +- [x] 运行 `git diff --check`。 ## 阶段 T:文档同步 -- [ ] 更新 README 当前版本为 0.2.1。 -- [ ] 更新 README 的 0.2.1 实际能力说明。 -- [ ] 记录 0.2.1 交付 Water 加固能力。 -- [ ] 记录 0.2.1 不交付 Gas 生产路径。 -- [ ] 记录 0.2.1 不交付 Explosive 生产路径。 -- [ ] 记录 0.2.1 不交付 Solid 生产路径。 -- [ ] 记录 0.2.1 不交付 Shell 生产路径。 -- [ ] 记录 0.2.1 不交付真实 FEM-SPH 联合运行。 -- [ ] 更新 `docs/09_release_history.md` 的 0.2.1 条目。 -- [ ] 更新 `docs/11_benchmark_matrix.md` 的 0.2.1 gate。 -- [ ] 确认 01-06 文档与 0.2.1 实际能力不冲突。 -- [ ] 确认文档使用 UTF-8 without BOM。 +- [x] 更新 README 当前版本为 0.2.1。 +- [x] 更新 README 的 0.2.1 实际能力说明。 +- [x] 记录 0.2.1 交付 Water 加固能力。 +- [x] 记录 0.2.1 不交付 Gas 生产路径。 +- [x] 记录 0.2.1 不交付 Explosive 生产路径。 +- [x] 记录 0.2.1 不交付 Solid 生产路径。 +- [x] 记录 0.2.1 不交付 Shell 生产路径。 +- [x] 记录 0.2.1 不交付真实 FEM-SPH 联合运行。 +- [x] 更新 `docs/09_release_history.md` 的 0.2.1 条目。 +- [x] 更新 `docs/11_benchmark_matrix.md` 的 0.2.1 gate。 +- [x] 确认 01-06 文档与 0.2.1 实际能力不冲突。 +- [x] 确认文档使用 UTF-8 without BOM。 - [ ] 确认文档不宣称已实现完整水下爆炸。 - [ ] 确认文档不宣称已实现生产级多物理耦合。 - [ ] 记录 restart 格式版本策略。