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

25 KiB

11 Benchmark 与验收矩阵

文档状态:0.5.1 gate 记录

1. 当前状态

0.5.1 在 0.5.0 Solid 起步闭环 gate 基础上新增 Solid 稳定化和结构算法加固 gate,并继续保留工程 benchmark 矩阵作为长期规划。本版本的 Solid 参考邻域、修正矩阵、速度梯度、应变率、最小内力、damage、softening、显式 smoke、pressure wave smoke、Explosive programmed burn、Gas 源项注入和 Gas bubble metrics 只用于小规模数值链路检查,不作为工程精度 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 0.2.2 gate 17/17 通过,source_size 1/1 通过,git diff --check 通过

2.5 0.3.0 Release Gate

0.3.0 默认 gate 在 0.2.2 Water gate 基础上新增 Gas 输入、EOS、状态、summary、solver、output、restart 和接口诊断验收。

测试名 类型 验收点
smoke Fortran smoke 版本 0.3.0、生命周期和显式步进错误路径
input Fortran input 既有 Abaqus 子集、Water 关键词、warning/error 路径
input_gas Fortran input Gas material、三类 EOS、缺失字段、warning 和 Water/Gas 混合
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 Water 显式推进、stable dt、API 兼容和错误默认值
gas_eos_ideal Fortran module 理想气体压力、单调性和非法参数
gas_eos_jwl Fortran module JWL 压力、相对体积、有限性和非法参数
gas_eos_stiffened Fortran module Stiffened gas 压力、PINF 字段、有限性和非法参数
gas_state Fortran module Gas phase、rho、pressure、internal energy、temperature、mass、volume、h
gas_summary Fortran module Gas 质量、体积、中心、压力、密度范围和 bubble metrics
solver_gas Fortran module Gas 单步显式推进、Gas dt 和 Water 单相回归
output Fortran output 粒子 CSV 通用字段和 summary CSV 兼容
gas_output Fortran output Gas summary CSV 字段
restart Fortran restart STATE_0_3、Water 状态、诊断、读回和非法文件
gas_restart Fortran restart Gas EOS、默认控制、体力、summary、bubble 历史、dt 和继续显式步
coupling_interface Fortran coupling Water 状态导出、外力导入、work/momentum/energy 诊断
c_api C ABI Water/Gas 诊断、空指针、未初始化、未 build 和错误码透传
cpp_api C++ wrapper Water/Gas 诊断薄包装
python_debug Python ctypes C ABI 加载、Water/Gas inspect/run 和错误路径
cli CLI version、inspect、check、run、output、Water/Gas 字段和错误输入
pressure_wave_smoke Fortran smoke 5 粒子线性和 3D 非共线压力扰动、小规模趋势检查
source_size 工具门禁 Fortran/C/C++/Python 文件和 stale exception

0.3.0 不验收 Explosive、Solid、Shell 的生产级物理结果,也不验收真实 FEM-SPH 联合运行。CouplingInterface 仍不暴露 C ABI。

本地验收记录:

日期 构建目录 结果
2026-07-03 build-codex-unix 0.3.0 gate 27/27 通过,source_size 1/1 通过,git diff --check 通过

2.6 0.3.1 Release Gate

0.3.1 默认 gate 在 0.3.0 Gas gate 基础上新增多 Gas material、material/EOS 分派、Gas 源项占位、扩展诊断、restart 0.3.1 和 0.3.0 兼容读入测试。

测试名 类型 验收点
input_gas_multimaterial Fortran input 多 Gas material、多 section、缺失密度/EOS、重复 EOS、非 Gas material EOS 和无 active 粒子 warning
gas_eos_dispatch Fortran module 理想气体、JWL、Stiffened gas 按 material 分派,混合材料 dt 和共享 body force
gas_extended_summary Fortran API Gas 质量、动量、密度范围、dt 分量和源项默认诊断
gas_source Fortran module Gas 质量、动量、能量源项清零、累计和显式应用
gas_source_errors Fortran module 非法粒子、非 Gas 粒子和非法数值源项错误路径
gas_restart_031 Fortran restart STATE_0_3_1、Gas material/EOS 表、源项缓存、bubble/dt 状态和继续显式步
gas_restart_030_compat Fortran restart 0.3.0 STATE_0_3 兼容读入、新状态默认值和继续显式步
gas_python_extended Python ctypes Gas extended/source summary 薄包装和 inspect/run 字段
gas_cli_extended CLI Gas extended/source summary CLI 字段和输出检查
gas_source_size_cleanup 工具门禁 Gas source 拆分、source size 和 stale exception 检查

0.3.1 不验收 Explosive、Solid、Shell 的生产级物理结果,也不验收真实 FEM-SPH 联合运行。Gas 源项为 0.4.0 Explosive 的前置入口,不代表 0.3.1 已实现爆炸反应。

本地验收记录:

日期 构建目录 结果
2026-07-03 build-codex-unix 0.3.1 gate 37/37 通过,source_size 1/1 通过,git diff --check 通过

2.7 0.4.0 Release Gate

0.4.0 默认 gate 在 0.3.1 Gas gate 基础上新增 Explosive 输入、反应、Gas 源项/phase 转化、summary、restart 和接口层验收。

测试名 类型 验收点
input_explosive Fortran input Explosive material、section、control、ignition、product Gas/JWL EOS
input_explosive_errors Fortran input 非法爆速、非法 product、非法 ignition、缺密度、非法 burn time、非法能量、product Gas 缺 EOS
explosive_detonation_time Fortran module 按初始坐标和爆速计算爆轰到达时间范围
explosive_reaction_progress Fortran module programmed burn 下 lambda 单调增加并限制在 [0,1]
explosive_release_source Fortran module CONVERSION=SOURCE 向 Gas 源项注入质量、动量和能量
explosive_to_gas_phase Fortran module CONVERSION=PHASE 完全反应后不可逆转为 Gas
explosive_gas_coupling Fortran module 产物 Gas material 使用 JWL EOS 并刷新 Gas summary
explosive_summary Fortran API Explosive 粒子数、反应粒子数、lambda 范围和释放量一致性
explosive_restart_040 Fortran restart STATE_0_4 写入读回并继续显式步
explosive_restart_031_compat Fortran restart 0.3.1 restart 兼容读入并初始化空 Explosive 状态
explosive_c_api C ABI 点火点设置和 Explosive summary 查询
explosive_python Python ctypes Explosive summary 和点火接口薄包装
explosive_cli CLI inspect/run 输出 Explosive 字段
explosive_source_size 工具门禁 Explosive 模块拆分、source size 和 stale exception 检查

0.4.0 不验收 Solid、Shell 的生产级物理结果,也不验收真实 FEM-SPH 联合运行。Explosive-Gas 链路仍是小规模数值闭环,不代表工程级水下爆炸 benchmark。

本地验收记录:

日期 构建目录 结果
2026-07-03 build-codex-unix 完整 CTest 51/51 通过,Explosive gate 14/14 通过,source_size 1/1 通过,git diff --check 通过

2.8 0.4.1 Release Gate

0.4.1 默认 gate 在 0.4.0 Explosive gate 基础上新增多点点火、多炸药材料、冻结反应质量、release balance、SOURCE/PHASE 诊断、restart 兼容和接口层验收。

测试名 类型 验收点
input_explosive_multi_ignition Fortran input 同一 material 多点点火、顺序无关和最早到达时间
input_explosive_multimaterial Fortran input 多 Explosive material、多 product Gas material 和 warning/error 路径
explosive_initial_mass_release Fortran module 冻结初始反应质量并保持释放量基准一致
explosive_release_balance Fortran module 初始、已释放、剩余质量、能量和动量闭合诊断
explosive_source_targeting Fortran module SOURCE 只注入匹配 product material 的 active Gas 粒子
explosive_phase_refresh Fortran module PHASE 转化后 phase、material、密度、能量、压力和 Gas summary 刷新
explosive_restart_041 Fortran restart STATE_0_4_1 写入读回新增 Explosive 状态
explosive_restart_040_compat Fortran restart STATE_0_4 兼容读入并初始化 0.4.1 新状态
explosive_restart_no_double_release Fortran restart restart 后继续推进不重复释放
explosive_water_gas_smoke Fortran smoke Water/Gas/Explosive 混合小算例显式推进
explosive_release_c_api C ABI release balance 查询和错误路径
explosive_release_python Python ctypes release balance 薄包装和 inspect/run 字段
explosive_release_cli CLI inspect/run 输出 release balance 字段
explosive_041_source_size 工具门禁 0.4.1 Explosive source size 和 stale exception 检查

0.4.1 不验收 Solid、Shell 的生产级物理结果,也不验收真实 FEM-SPH 联合运行。Explosive-Water-Gas 链路仍是小规模数值闭环,不代表工程级水下接触爆炸 benchmark。

本地验收记录:

日期 构建目录 结果
2026-07-03 build-codex-unix 完整 CTest 66/66 通过,0.4.1 Explosive gate 14/14 通过,source_size 1/1 通过,git diff --check 通过

2.9 0.5.0 Release Gate

0.5.0 默认 gate 在 0.4.1 Explosive 稳定化 gate 基础上新增 Solid 输入、状态、本构、失效、显式推进、output、restart、接口和 source size 验收。

测试名 类型 验收点
input_solid_material Fortran input Solid material、密度、弹性、Johnson-Cook flow/failure、softening 和 section 映射
input_solid_errors Fortran input 缺密度、缺弹性、非法 Johnson-Cook 参数和非法 Solid section error 路径
solid_state_build Fortran module Solid 状态数组分配、默认值、active/failed 计数和非 Solid 安全默认值
solid_elastic_material Fortran unit 弹性材料点应力、内能和等效应力更新
solid_johnson_cook_flow Fortran unit Johnson-Cook 热软化、应变率项、硬化项和屈服应力
solid_johnson_cook_failure Fortran unit failure strain、damage 单调累积、失效状态切换
solid_progressive_softening Fortran unit damage/softening 范围限制和线性渐进软化
solid_gradient_correction Fortran module 参考体积、参考构型邻域和梯度修正占位状态
solid_stable_dt Fortran module 结构波速稳定时间步和全局 dt 约束
solid_explicit_smoke Fortran smoke Solid-only 体力驱动显式推进、能量和动量诊断
solid_output Fortran output summary CSV 和粒子 CSV 的 Solid 字段
solid_restart_050 Fortran restart STATE_0_5 写入读回 Solid material 和 per-particle 状态
solid_restart_041_compat Fortran restart STATE_0_4_1 兼容读入并初始化空 Solid 状态
solid_c_api C ABI Solid summary、failure counts 和错误路径
solid_python Python ctypes Solid summary 薄包装和 inspect/run 字段
solid_cli CLI Solid inspect/run/restart 字段检查
solid_source_size 工具门禁 Solid source size 和 stale exception 检查

0.5.0 不验收 Shell 生产路径,不验收真实水-气-结构工程爆炸响应,不验收真实 FEM-SPH 联合运行,也不验收工程级结构破坏 benchmark。Solid 显式 smoke 仅证明 0.5.0 状态、推进、输出、restart 和接口链路闭合。

本地验收记录:

日期 构建目录 结果
2026-07-03 build-codex-unix 完整 CTest 83/83 通过,0.4.1 Explosive gate 14/14 通过,0.5.0 Solid gate 17/17 通过,source_size 1/1 通过,git diff --check 通过

2.10 0.5.1 Release Gate

0.5.1 默认 gate 在 0.5.0 Solid gate 基础上新增参考构型、速度梯度、应变率、最小内力、能量诊断、restart 兼容和接口可观测性验收。

测试名 类型 验收点
solid_051_input_validation Fortran input 泊松比、Johnson-Cook 非有限参数、softening 类型、section/material 映射和缺失 Solid section 错误路径
solid_reference_neighbor Fortran module active Solid 参考邻域计数、非 Solid 跳过和退化邻域诊断
solid_correction_matrix Fortran module 修正矩阵行列式、状态码、近奇异 fallback 和 summary 质量诊断
solid_velocity_gradient Fortran module 均匀平动零梯度和单轴拉伸速度梯度
solid_strain_increment Fortran module 由应变率更新 Voigt 应变增量、总应变和材料点路径
solid_internal_force_pair Fortran module 成对 Solid 粒子内力对称性和动量残差
solid_uniform_stress_balance Fortran module 对称均匀应力下内力残差受控
solid_softening_force Fortran module softening 因子作用到 Solid 内力贡献
solid_energy_diagnostics Fortran module 动能、内能、塑性功等效量、最大应变率和最大加速度诊断
solid_dt_acceleration Fortran module Solid wave dt 与 acceleration dt 合并并进入全局稳定时间步
solid_restart_051 Fortran restart STATE_0_5_1 写入读回新增 Solid 状态并继续显式步
solid_restart_050_compat Fortran restart STATE_0_5 兼容读入并初始化 0.5.1 新状态
solid_state_api Fortran API Solid 粒子级状态、诊断和参考质量 API 容量/错误路径
solid_python_051 Python ctypes Solid 0.5.1 诊断、粒子级状态、restart 读回和兼容读入
solid_cli_051 CLI Solid 0.5.1 inspect/run/restart 字段检查
solid_051_source_size 工具门禁 0.5.1 Solid source size、拆分结果和 stale exception 检查

0.5.1 不验收 Shell 生产路径,不验收真实水-气-结构工程爆炸响应,不验收真实 FEM-SPH 联合运行,也不验收工程级结构破坏 benchmark。Solid 0.5.1 gate 只证明小型结构算法闭环和接口可观测性,不代表工程级断裂路径预测。

本地验收记录:

日期 构建目录 结果
2026-07-03 build-codex-unix 完整 CTest 99/99 通过,0.5.0 Solid gate 17/17 通过,0.5.1 Solid gate 16/16 通过,source_size/solid_source_size/solid_051_source_size 3/3 通过,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 采用定量阈值还是形态分类。