Files
SPHLite/docs/11_benchmark_matrix.md
T
2026-07-03 08:30:27 +08:00

200 lines
11 KiB
Markdown

# 11 Benchmark 与验收矩阵
文档状态:0.2.2 gate 记录占位
## 1. 当前状态
0.2.2 在 0.2.1 `Water` 基础弱可压 SPH 加固基线上进行稳定化复核,并继续保留工程 benchmark 矩阵作为长期规划。本版本的 pressure wave smoke 只用于小规模数值链路检查,不作为工程精度 benchmark。
## 2. 0.1.0 Release Gate
| 测试名 | 类型 | 验收点 |
|---|---|---|
| `smoke` | Fortran smoke | 生命周期、版本号、数据库最小分配、显式步进 |
| `input` | Fortran input | 最小 `.inp`、unknown keyword warning、关键数据缺失 error |
| `c_api` | C ABI | 生命周期、空指针错误、输入、查询、显式步进 |
| `python_debug` | Python `ctypes` | 加载 C ABI、读取最小 `.inp`、查询粒子数、显式运行 |
| `source_size` | 工具门禁 | Fortran/C 文件大小、Fortran 过程大小、stale exception |
0.1.0 不验收 Water、Gas、Explosive、Solid、Shell 的生产级物理结果,也不验收真实 FEM-SPH 联合运行。
本地验收记录:
| 日期 | 构建目录 | 结果 |
|---|---|---|
| 2026-07-02 | `build-codex-unix` | `smoke`、`input`、`c_api`、`python_debug`、`source_size` 和 `git diff --check` 均通过 |
## 2.1 0.1.1 Release Gate
| 测试名 | 类型 | 验收点 |
|---|---|---|
| `smoke` | Fortran smoke | 版本 0.1.1、生命周期、数据库、常量、显式步进错误路径 |
| `input` | Fortran input | 元数据占位、set 不作为类型判断、warning/error 路径 |
| `c_api` | C ABI | 空指针、非正容量、粒子状态、output、restart |
| `cpp_api` | C++ wrapper | RAII 生命周期、读入、构建、粒子状态 |
| `python_debug` | Python `ctypes` | 常量、粒子状态、output、restart、错误路径 |
| `cli` | CLI | `--version`、inspect、`--check`、`--run`、错误输入 |
| `restart` | Fortran restart | 写入、读回、继续最小显式步 |
| `output` | Fortran output | CSV 字段和输出路径控制 |
| `coupling_interface` | Fortran coupling | 中立导出/导入占位和诊断字段 |
| `source_size` | 工具门禁 | Fortran/C/C++/Python 文件大小和 stale exception |
0.1.1 不验收 Water、Gas、Explosive、Solid、Shell 的生产级物理结果,也不验收真实 FEM-SPH 联合运行。
本地验收记录:
| 日期 | 构建目录 | 结果 |
|---|---|---|
| 2026-07-02 | `build-codex-unix` | 0.1.1 gate 10/10 通过,`git diff --check` 通过 |
## 2.2 0.2.0 Release Gate
| 测试名 | 类型 | 验收点 |
|---|---|---|
| `smoke` | Fortran smoke | 版本 0.2.0、生命周期、显式步进错误路径 |
| `input` | Fortran input | Abaqus 子集、Water 关键字、warning/error 路径 |
| `kernel` | Fortran unit | Wendland/Cubic 核函数、梯度、不同 `h(i)` 和错误路径 |
| `neighbor` | Fortran unit | uniform cell/bin 邻域、移动重建、边界和容量错误路径 |
| `water_eos` | Fortran module | Tait EOS、声速、Water summary 和非 Water 跳过 |
| `water_density` | Fortran module | 连续性方程、压缩/拉伸、静止和非 Water 跳过 |
| `water_viscosity` | Fortran module | Monaghan 人工黏性方向、有限性和对称性 |
| `water_force` | Fortran module | 压力力、body force 和非 Water 跳过 |
| `solver_water` | Fortran module | Water 显式步、稳定时间步、Fortran API 和错误路径 |
| `pressure_wave_smoke` | Fortran smoke | 小规模压力扰动传播、质量/动量趋势、输出字段 |
| `output` | Fortran output | 粒子 CSV 和 Water summary CSV |
| `restart` | Fortran restart | Water 状态写入、读回、重建邻域和继续显式步 |
| `coupling_interface` | Fortran coupling | Water 运行后中立导出、外部粒子力导入和诊断占位 |
| `c_api` | C ABI | Water summary/dt limits、错误码和粒子状态 |
| `cpp_api` | C++ wrapper | Water summary/dt limits 薄包装 |
| `python_debug` | Python `ctypes` | Water inspect/run、summary/dt limits 和错误路径 |
| `cli` | CLI | 0.2.0 Water inspect/check/run/output/error 字段 |
| `source_size` | 工具门禁 | Fortran/C/C++/Python 文件大小和 stale exception |
0.2.0 不验收 `Gas`、`Explosive`、`Solid`、`Shell` 的生产级物理结果,也不验收真实 FEM-SPH 联合运行。
本地验收记录:
| 日期 | 构建目录 | 结果 |
|---|---|---|
| 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` | 0.2.1 gate 17/17 通过,`source_size` 1/1 通过,`git diff --check` 通过 |
## 2.4 0.2.2 Release Gate
0.2.2 继续使用 0.2.1 已建立的默认 gate,目标是复核 Water 路径、接口兼容性、restart/output 稳定性和文档边界,不新增 Gas、Explosive、Solid、Shell 或真实 FEM-SPH 联合运行验收。
| 测试名 | 类型 | 验收点 |
|---|---|---|
| `smoke` | Fortran smoke | 版本 0.2.2、生命周期和显式步进错误路径 |
| `input` | Fortran input | Abaqus 子集、Water 关键词、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 | STATE_0_2 状态版本、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.2 不验收 `Gas`、`Explosive`、`Solid`、`Shell` 的生产级物理结果,也不验收真实 FEM-SPH 联合运行。CouplingInterface 不在 0.2.2 暴露 C ABI。
本地验收记录:
| 日期 | 构建目录 | 结果 |
|---|---|---|
| 2026-07-03 | `build-codex-unix` | 待最终 gate 回填 |
## 3. 基础数值矩阵
| 领域 | 测试或 benchmark | 验收点 |
|---|---|---|
| 核函数 | kernel 单测 | 归一性、梯度方向、紧支撑 |
| 邻域搜索 | neighbor 单测 | 与朴素搜索一致 |
| 水体 EOS | Tait EOS 单测 | 压力量级和单调性 |
| 气体 EOS | JWL/理想气体单测 | 压力、能量和单位一致 |
| 爆轰传播 | ignition 单测 | 到达时间和反应进度 |
| 气体团簇 | gas summary 单测 | 体积、中心、等效半径 |
## 4. 水下爆炸矩阵
| 领域 | 代表算例 | 验收点 |
|---|---|---|
| 压力波 | 1D 水中压力传播 | 波速、峰值、数值耗散 |
| 自由场爆炸 | 小装药水域 | 压力峰值和冲量 |
| 气泡脉动 | 单气泡膨胀回缩 | 最大半径、周期、中心迁移 |
| 流固载荷 | 水冲击刚性板 | 法向压力和冲量 |
## 5. 结构矩阵
| 领域 | 代表算例 | 验收点 |
|---|---|---|
| `Solid` 弹性 | 单轴拉伸 | 应力应变曲线 |
| `Solid` 塑性 | 高速拉伸/压缩 | 屈服和塑性功 |
| `Solid` 断裂 | 缺口拉伸 | 损伤局部化和断裂路径 |
| `Shell` 变形 | 悬臂板/简支板 | 位移方向和量级 |
| `Shell` 破裂 | 薄板冲击 | 穿孔、撕裂和能量 |
## 6. 耦合矩阵
| 领域 | 代表算例 | 验收点 |
|---|---|---|
| SPH-FEM 接触 | SPH 压力作用 FEM facet | 合力、方向、能量 |
| FEM 驱动边界 | 运动 FEM facet 驱动水体 | 边界速度和压力响应 |
| `Solid` 连续体耦合 | `Solid` - FEM 实体拉伸 | 位移连续、力平衡 |
| `Shell` 连续体耦合 | `Shell` - FEM 壳弯曲 | 转角/位移连续、力矩平衡 |
| 混合舱段 | 局部 FEM + 局部 SPH 舱段爆炸 | 破坏模式和耦合诊断 |
## 7. 默认 gate 与非默认长跑
默认 gate 应只包含小型、快速、稳定的测试。
非默认长跑包括:
- 大水域自由场爆炸。
- 长时程气泡脉动。
- 复杂舱段破坏。
- SPH-FEM 混合整船局部模型。
- 高分辨率断裂和碎片云。
## 8. 待讨论问题
- 第一版 benchmark 是否需要真实工程量纲。
- 气泡脉动验收采用解析近似、实验曲线还是参考软件结果。
- 结构破裂 checker 采用定量阈值还是形态分类。