107 lines
4.5 KiB
Markdown
107 lines
4.5 KiB
Markdown
# 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 采用定量阈值还是形态分类。
|