Files
SPHLite/docs/11_benchmark_matrix.md
T
2026-07-04 12:06:47 +08:00

42 KiB

11 Benchmark 与验收矩阵

文档状态:0.8.1 gate 记录

1. 当前状态

0.8.1 在 0.8.0 SPHLite 侧中立接触耦合接口 gate 基础上加固 facet pressure/traction/resultant、受控载荷分配、contact state、载荷守恒诊断、输出、restart、接口层和 mock coupling smoke。0.8.1 仍不作为真实 FEMLite 联合运行、连续体耦合或工程级水下接触爆炸 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 通过

2.11 0.6.0 Release Gate

0.6.0 默认 gate 在 0.5.1 Solid gate 基础上新增 Shell material/section 输入、厚度积分规则和 Shell 状态分配验收。当前 gate 只覆盖 Shell 输入与状态基线,不验收完整 Shell 动力学闭环。

测试名 类型 验收点
input_shell_section Fortran input Shell material、*SHELL SECTION、厚度、3 点/5 点积分、剪切修正、section/material 映射和未绑定 material warning
input_shell_errors Fortran input 缺密度、缺弹性、Johnson-Cook 非有限参数、failure 非法参数、缺失 Shell section 和非法积分点错误路径
shell_state_build Fortran module Shell 粒子级状态数组分配、默认值、active Shell 计数、section/material 映射和非 Shell 安全默认值
shell_section_integration Fortran module 3 点/5 点厚度积分坐标、权重、积分点状态数组和 Shell section 规则
source_size 工具门禁 Fortran/C/C++/Python 文件和 stale exception 检查

0.6.0 不验收 director/转动更新、Mindlin-Reissner 应变路径、Shell 材料点更新、Shell 内力、Shell 内力矩、显式推进、restart、接口层或生产计算路径,也不验收真实水-气-结构工程爆炸响应和真实 FEM-SPH 联合运行。

本地验收记录:

日期 构建目录 结果
2026-07-03 build-codex-unix 完整 CTest 103/103 通过,0.6.0 Shell 输入/状态基线 gate 4/4 通过,source_size 1/1 通过,git diff --check 通过

2.12 0.6.1 Release Gate

0.6.1 默认 gate 在 0.6.0 Shell 输入/状态基线 gate 基础上新增 Shell director、参考几何、局部坐标系、转动状态、Mindlin-Reissner 小变形应变和厚度积分点应变增量验收。当前 gate 只覆盖 Shell 运动学基线,不验收完整 Shell 动力学闭环。

测试名 类型 验收点
input_shell_section Fortran input 0.6.0 Shell material、section、厚度积分规则和剪切修正输入回归
input_shell_errors Fortran input 0.6.0 Shell 输入错误路径回归
shell_state_build Fortran module 0.6.0 Shell 粒子级状态数组和非 Shell 安全默认值回归
shell_section_integration Fortran module 0.6.0 3 点/5 点厚度积分规则和积分点状态数组回归
shell_director_input Fortran input/module 显式 Shell director、section orientation、非法向量错误和未使用 orientation warning
shell_reference_geometry Fortran module 三角形/四边形参考面 director、参考面积、等效转动惯量和非 Shell 默认值
shell_director_update Fortran module Shell 内部角速度设置、小转动 director 更新、归一化保护和无 Shell no-op
shell_rotation_kinematics Fortran input/module *SPHLITE SHELL ROTATION 输入、角加速度默认值、最大角速度和 Solid 隔离
shell_local_frame Fortran module Shell 局部 e1/e2/e3 正交、右手性、orientation/reference tangent 选择和非 Shell 默认值
shell_membrane_strain Fortran module 刚体平动零膜应变、单轴膜应变、简单剪切膜应变和膜应变诊断
shell_bending_strain Fortran module 均匀 director 零弯曲、受控曲率弯曲应变和弯曲诊断
shell_shear_strain Fortran module 横向剪切应变、Shell/Solid 隔离和 failed Shell 跳过
shell_ip_strain_increment Fortran module 3 点/5 点厚度积分点应变增量映射、未使用积分点清零、诊断和 Gas no-op
shell_061_source_size 工具门禁 Shell 0.6.1 source size、说明性例外和 stale exception 检查

0.6.1 不验收 Shell Johnson-Cook 材料点更新、Shell 内力、Shell 内力矩、稳定时间步、完整显式推进、restart、公开接口层或生产计算路径,也不验收真实水-气-结构工程爆炸响应和真实 FEM-SPH 联合运行。Shell 0.6.1 gate 只证明运动学基线和积分点应变映射可测,不代表工程级板壳变形、损伤或撕裂预测能力。

本地验收记录:

日期 构建目录 结果
2026-07-03 build-codex-unix 完整 CTest 113/113 通过,0.6.0 Shell 输入/状态基线 gate 4/4 通过,0.6.1 Shell 运动学 gate 13/13 通过,source_size/shell_061_source_size 2/2 通过,git diff --check 通过

2.13 0.7.0 Release Gate

0.7.0 默认 gate 在 0.6.1 Shell 运动学基线之上新增水-气-结构局部爆炸 smoke 链路。该 gate 只覆盖小型 Water/Gas/Explosive/Solid/Shell 输入、载荷缓存、显式推进接入、诊断输出和 restart 边界,不验收工程级水下接触爆炸 benchmark。

测试名 类型 验收点
input_blast_region Fortran input *SPHLITE BLAST REGION 名称、中心、半径、源/目标 phase、target set、scale、time window 和 mode 解析
input_blast_errors Fortran input 非法半径、非法 scale、非法 time window、非法 phase 和缺失 target set 错误路径
blast_source_snapshot Fortran module 源区 Water/Gas/Explosive 计数、质量、能量、压力和反应进度快照
blast_target_filter Fortran module 目标 set、半径、phase、active/failed 状态筛选和跳过计数
blast_load_accumulator Fortran module Solid/Shell 结构外载荷缓存、隔离和 no-source 默认值
blast_load_conservation Fortran module 总力、Solid/Shell 分力、冲量、动量、做功和能量诊断一致性
blast_solver_order Fortran solver Water/Gas 压力、Explosive 更新、Gas 源项和载荷投影调用顺序
blast_solid_response Fortran solver Solid 外载荷进入显式加速度和多步速度累积
blast_shell_response Fortran solver Shell 平动外载荷、moment 占位和 director 隔离
blast_noop_regression Fortran solver 载荷禁用、时间窗结束清零、failed Solid/Shell 目标跳过
blast_summary Fortran API Blast summary counts/values 查询和非法 region 错误路径
blast_output Fortran output summary CSV blast 指标和粒子 CSV 外载荷字段
blast_restart_boundary Fortran restart 0.7.0 不写 STATE_0_7,Blast 控制和诊断不作为正式 restart state
blast_smoke Fortran smoke Solid、Shell、Solid/Shell 局部爆炸单步/多步 smoke,检查方向、进度、冲量、能量和有限性

0.7.0 不验收真实工程级水下接触爆炸响应、真实 FEM-SPH 接触耦合或连续体耦合、完整舱段破坏 benchmark、复杂撕裂/穿孔/碎片云、焊缝失效库、大规模并行或 GPU 后端。0.7.0 的局部爆炸诊断先提供 Fortran API 和 CSV 调试输出,不公开 C ABI/C++/Python 稳定接口。

本地验收记录:

日期 构建目录 结果
2026-07-03 build-codex-unix 完整 CTest 127/127 通过,0.7.0 局部爆炸专项 gate 14/14 通过,source size 相关 gate 7/7 通过,git diff --check 通过

2.14 0.7.1 Release Gate

0.7.1 默认 gate 在 0.7.0 局部爆炸 smoke 起点之上稳定多 region、载荷叠加、诊断有限性、输出和 restart 边界。该 gate 只覆盖小型 Water/Gas/Explosive/Solid/Shell 链路,不验收工程级水下接触爆炸 benchmark。

测试名 类型 验收点
input_blast_multiregion Fortran input 多 blast region 解析、名称保持、启用状态、source/target phase 和 target set 独立性
input_blast_region_errors_071 Fortran input 重复 region、非法 enabled/active、缺失字段和禁用 region 边界错误路径
blast_multiregion_snapshot Fortran module 多 region 源区质量、能量、压力、Gas 体积和 Explosive 进度诊断互不串扰
blast_multiregion_target_filter Fortran module 多 region target set、phase、active/failed 和跳过计数互不串扰
blast_load_superposition Fortran module Solid 结构外载荷跨 region 叠加、分量方向和总力诊断
blast_load_diagnostics_071 Fortran module 目标数、总力、冲量、能量输入、最大加速度和非有限计数诊断
blast_solver_order_071 Fortran solver Explosive、Gas 源项、Blast snapshot/load 和 Solid/Shell 响应调用顺序稳定
blast_response_multiregion Fortran solver Solid/Shell 多 region 外载荷显式响应和禁用 region 隔离
blast_noop_regression_071 Fortran solver Water-only、Gas-only、Explosive-only 和 no-active-target 情况不产生结构载荷
blast_output_071 Fortran output summary CSV 和粒子 CSV 中 blast 诊断字段边界稳定
blast_restart_boundary_071 Fortran restart 0.7.1 不新增正式 Blast restart state,读写边界保持兼容
blast_smoke_071 Fortran smoke Solid、Shell、Solid/Shell 混合多 region、禁用载荷、无 active target 小模型状态有限且诊断受控

0.7.1 不验收真实工程级水下接触爆炸响应、真实 FEM-SPH 接触耦合或连续体耦合、完整舱段破坏 benchmark、复杂撕裂/穿孔/碎片云、焊缝失效库、大规模并行或 GPU 后端。0.7.1 的 Blast 诊断仍限定在 Fortran 内部查询和 CSV 调试边界,不公开 C ABI/C++/Python 稳定接口。

本地验收记录:

日期 构建目录 结果
2026-07-04 build-codex-unix 完整 CTest 139/139 通过,Water/Gas/Explosive/Solid/Shell 分类 gate 6/6、16/16、27/27、31/31、13/13 通过,0.7.0 blast 回归 gate 14/14 通过,0.7.1 blast 专项 gate 12/12 通过,source size 相关 gate 7/7 通过,git diff --check 通过

2.15 0.8.0 Release Gate

0.8.0 默认 gate 在 0.7.1 局部爆炸稳定化版本之上建立 SPHLite 侧中立接触耦合接口。该 gate 只验收小型 mock coupling 链路和接口契约,不验收真实 FEMLite 联合运行、外部 CouplingModule、连续体耦合或工程级船舶水下接触爆炸破坏 benchmark。

测试名 类型 验收点
input_coupling_region_080 Fortran input coupling region 名称、set、phase/material/section 过滤、enabled、export/import 语义
input_coupling_errors_080 Fortran input 非法 type/export/import/enabled、重复名称、缺失 set 和 continuum 预留错误路径
coupling_region_build_080 Fortran database active/disabled region 构建、内部 id、粒子索引表和隔离性
coupling_particle_export_080 Fortran API 粒子 external/internal id、phase/status、material/section、标量和三维状态导出
coupling_facet_export_080 Fortran API Shell Facet Proxy 数量、id、中心、速度、法向、面积和材料/section 导出
coupling_facet_errors_080 Fortran API 无 facet proxy、非法 facet、零面积/非法法向错误路径
coupling_particle_force_import_080 Fortran API external id/region index 粒子力导入、累加、清零、stale/skipped/nonfinite 计数
coupling_facet_load_import_080 Fortran API facet load 和 facet 粒子力映射、非法 facet、数量不匹配和非有限错误路径
coupling_motion_boundary_080 Fortran API direct velocity/position 运动边界、penalty 预留错误路径和 inactive skip
coupling_diagnostics_080 Fortran solver/API 当前力、力矩、冲量、做功、动量/能量交换、最大响应和缓存消费
coupling_solver_order_080 Fortran solver coupling 载荷与显式 Velocity-Verlet 步序、空导入和禁用 region 安全路径
coupling_solid_response_080 Fortran solver Solid 粒子受控方向响应、加速度、速度和诊断
coupling_shell_response_080 Fortran solver Shell 平动响应、director/转动隔离和 facet load 诊断
coupling_noop_regression_080 Fortran regression Water/Gas/Explosive/Solid/Shell 单相无 coupling 污染、disabled region no-op
coupling_output_080 Fortran output summary CSV 和 particle CSV coupling 字段
coupling_restart_080 Fortran restart STATE_0_8 coupling 状态、缓存、运动边界和累计诊断读回
coupling_restart_071_compat Fortran restart 既有 restart 兼容读入后初始化空 coupling 状态
coupling_fortran_api_080 Fortran API region 查询、导出、导入和 packed diagnostics
coupling_c_api_080 C ABI C 层 region/export/import/diagnostics 追加接口
coupling_cpp_api_080 C++ wrapper C++ 薄包装的 coupling 查询、导出、导入和诊断
coupling_python_080 Python ctypes Python debug wrapper coupling 查询、导出、导入和诊断
coupling_cli_080 CLI inspect 输出 coupling region、export/import mode 和 diagnostics
coupling_smoke_080 Fortran smoke Solid/Shell/混合 mock contact、disabled/no-active/stale/repeated import 有限性
coupling_source_size_080 工具门禁 Coupling 0.8 source size、说明性例外和 stale exception 检查

0.8.0 不验收真实 FEMLite 联合运行、外部 CouplingModule、连续体一部分 FEM 一部分 SPH 的生产级连续体耦合、工程级接触算法、工程级船舶水下接触爆炸破坏 benchmark、复杂撕裂/穿孔/碎片云、焊缝失效库、大规模并行或 GPU 后端。

本地验收记录:

日期 构建目录 结果
2026-07-04 build-codex-unix 完整 CTest 163/163 通过,0.8.0 coupling 专项 gate 24/24 通过,Water/Gas/Explosive/Solid/Shell 分类 gate 6/6、19/19、28/28、33/33、14/14 通过,0.7.0 blast 回归 gate 19/19 通过,0.7.1 blast 专项 gate 7/7 通过,source size 相关 gate 8/8 通过,git diff --check 通过

2.16 0.8.1 Release Gate

0.8.1 默认 gate 在 0.8.0 中立接触耦合接口之上稳定载荷模式、分配策略、接触诊断和接口层。该 gate 只验收 SPHLite 侧小型 mock coupling 链路和接口契约,不验收真实 FEMLite 联合运行、外部 CouplingModule、连续体耦合或工程级船舶水下接触爆炸破坏 benchmark。

测试名 类型 验收点
input_coupling_load_mode_081 Fortran input LOAD_MODE、DISTRIBUTION、CONTACT_STATE 输入解析和兼容默认值
input_coupling_load_errors_081 Fortran input 非法 load mode、distribution、contact state 和 pressure/traction 缺少 facet proxy 错误
coupling_contact_state_081 Fortran API contact flag、normal、gap、penetration 和 contact pressure 缓存分配/清零
coupling_facet_pressure_081 Fortran API pressure 到 facet 合力和粒子力的方向、面积权重与最大 pressure 诊断
coupling_facet_traction_081 Fortran API traction 到粒子力的映射、质量权重和最大 traction 诊断
coupling_facet_resultant_081 Fortran API facet resultant 直接导入和分配
coupling_distribution_uniform_081 Fortran API uniform 分配策略
coupling_distribution_area_081 Fortran API area 分配策略和面积诊断
coupling_distribution_mass_081 Fortran API mass 分配策略和非法权重诊断
coupling_load_balance_081 Fortran diagnostics 输入/分配总力、力矩和误差有限性
coupling_contact_diagnostics_081 Fortran diagnostics active/skipped contact、最大 penetration、nonfinite 诊断
coupling_solver_order_081 Fortran solver pressure/traction/resultant 与 blast/coupling 外载荷显式步序
coupling_stale_epoch_081 Fortran diagnostics stale epoch 清理、重复导入和缓存清空
coupling_solid_surface_pressure_081 Fortran smoke Solid 等效 surface pressure 粒子力响应方向
coupling_shell_pressure_081 Fortran smoke Shell facet pressure 平动响应方向
coupling_mixed_pressure_motion_081 Fortran smoke pressure 与 direct motion boundary 混合优先级
coupling_output_081 Fortran output summary CSV 和 particle CSV 0.8.1 contact/载荷字段
coupling_restart_081 Fortran restart STATE_0_8_1 写入、读回和继续显式步
coupling_restart_080_compat Fortran restart STATE_0_8 兼容读入后初始化 0.8.1 新增状态
coupling_fortran_api_081 Fortran API pressure、traction、resultant、contact state、load balance 和 diagnostics 入口
coupling_c_api_081 C ABI C 层 pressure/traction/contact diagnostics 入口和错误路径
coupling_cpp_api_081 C++ wrapper C++ 薄包装 pressure、traction 和 diagnostics
coupling_python_081 Python ctypes Python debug wrapper 0.8.1 coupling 字段
coupling_cli_081 CLI inspect 输出 load mode、distribution 和 contact diagnostics
coupling_smoke_081 Fortran smoke Solid 等效受压、Shell pressure、traction、pressure-motion 和 stale epoch mock 样例
coupling_source_size_081 工具门禁 0.8.1 source size 和 stale exception 检查

0.8.1 不验收真实 FEMLite 联合运行、外部 CouplingModule、连续体一部分 FEM 一部分 SPH 的生产级连续体耦合、工程级接触算法、工程级船舶水下接触爆炸破坏 benchmark、复杂撕裂/穿孔/碎片云、焊缝失效库、大规模并行或 GPU 后端。

本地验收记录:

日期 构建目录 结果
2026-07-04 build-codex-unix 完整 CTest 189/189 通过,0.8.1 coupling 专项 gate 26/26 通过,0.8.0 coupling 回归 gate 24/24 通过,Water/Gas/Explosive/Solid/Shell 分类 gate 6/6、19/19、29/29、33/33、14/14 通过,0.7.0 blast 回归 gate 15/15 通过,0.7.1 blast 专项 gate 11/11 通过,source size 相关 gate 9/9 通过,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 采用定量阈值还是形态分类。