# 11 Benchmark 与验收矩阵 文档状态:0.2.1 gate 记录 ## 1. 当前状态 0.2.1 在 0.2.0 `Water` 基础弱可压 SPH 最小可测试 gate 上进行加固,并继续保留工程 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` | `coupling_interface`、`c_api`、`cpp_api`、`python_debug`、`cli`、`pressure_wave_smoke`、`source_size` 和 `git diff --check` 通过 | ## 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 采用定量阈值还是形态分类。