Files
SPHLite/docs/11_benchmark_matrix.md
T
2026-07-02 19:50:44 +08:00

4.5 KiB

11 Benchmark 与验收矩阵

文档状态:0.1.1 gate 记录

1. 当前状态

0.1.1 不交付工程 benchmark,只建立并加固 release gate 和 source size 门禁。后续物理 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 通过

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 采用定量阈值还是形态分类。