Files
FemLite/docs/v5_benchmark_matrix.md
T
shenw a2a11179d9
FemLite CI / build-test (push) Has been cancelled
Advance V5.3 contact audits for 0.5.1
2026-06-26 14:20:57 +08:00

85 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# FemLite V5 Benchmark And Acceptance Matrix
日期:2026-06-26
本文档记录当前 V5 已完成能力对应的测试入口、示例目录、参考指标和容差。
状态标记仍只维护在 `docs/v5_development_plan.md`;本文件只给出可执行验收矩阵。
## 测试层级
| 层级 | 用途 | 推荐命令 |
|---|---|---|
| 默认回归 | 快速确认全部单元、模块、CLI、示例和 benchmark 不回退 | `ctest --test-dir build-win-gcc-16 -C Release --output-on-failure` |
| V5 验收子集 | 只运行当前 V5 已完成能力的核心测试和 benchmark | `ctest --test-dir build-win-gcc-16 -C Release -L v5_acceptance --output-on-failure` |
| 示例 benchmark | 只运行带 benchmark 标签的示例级检查 | `ctest --test-dir build-win-gcc-16 -C Release -L benchmark --output-on-failure` |
| 定向调试 | 调试单个能力或相邻能力 | `ctest --test-dir build-win-gcc-16 -C Release -R "<test-name>" --output-on-failure` |
默认回归当前 Windows GCC 16 Release 记录为 `106/106 passed`。V5 验收子集
当前记录为 `35/35 passed`。
## 多平台复测矩阵
| 平台 | 构建目录 | 工具链 | 默认 CTest | V5 验收子集 | 备注 |
|---|---|---|---|---|---|
| Windows GCC | `build-win-gcc-16` | GNU Fortran 16.1.0 | 106/106 passed | 35/35 passed | 20.1 clean clone 和 20.2 后本地回归均通过 |
| WSL GNU | `build-wsl-gfortran-v5-20-2` | GNU Fortran 13.3.0、GNU C 13.3.0、CMake 3.28.3 | 106/106 passed | 35/35 passed | benchmark 工具已修正跨平台路径分隔符 |
| Windows Intel/MSVC | `build-win-ifx-v5-20-2` | VS DevCmd 17.14.33、MSVC 19.44.35227.0、IntelLLVM ifx 2026.0.0 | 106/106 passed | 35/35 passed | CTest 环境优先加载 ifx compiler runtime;Mohr-Coulomb 边界分类容差已稳定 |
| Windows GCC OpenMP | `build-win-gcc-16` | GNU Fortran 16.1.0,OpenMP enabled | `contact_omp1`、`contact_omp4`、`perf_contact_pair_omp_consistency` 3/3 passed | n/a | 1/4 线程 contact/performance smoke 非计时统计一致 |
## V5 验收矩阵
| V5 项 | 能力 | 目录或模块 | CTest 名称 | 参考指标 | 容差/验收条件 |
|---|---|---|---|---|---|
| V5.2 | 内部 solver 诊断、no-external-solver 策略 | `src/solver`, `tests/module`, `tests/interface` | `linear_solver_cg`, `csr_diagnostics`, `solver_implicit`, `implicit_inp`, `c_api`, CLI implicit/static tests | CG/BiCGSTAB/GMRES 迭代、残差、CSR matrix class、legacy external id rejection | 旧外部 method/backend id 被拒绝且不改变设置;静力、隐式和非线性路径通过内部 solver dispatch |
| V5.3 | 非匹配实体 mortar 压缩 | `examples/contact_two_blocks_compression` | `example_contact_two_blocks_compression_benchmark` | `pressure_profile.csv`, active contact, master coverage, weighted gap, multiplier residual | 多 master facet 覆盖;weighted penetration 和 multiplier residual 在 checker 容差内;VTK 输出存在 |
| V5.3 | 大滑移 mortar-friction | `examples/contact_block_sliding` | `example_contact_block_sliding_benchmark` | `sliding_profile.csv`, stick/slip, accumulated slip, tangential force, friction work | 多 master/active candidate;累计滑移和摩擦功为正且非负耗散;VTK 输出存在 |
| V5.3 | shell-shell contact | `examples/shell_shell_contact` | `example_shell_shell_contact_benchmark` | contact profile, active contact, force norm, gap residual, augmented multiplier | active contact 大于零;gap/force/multiplier 指标通过 checker |
| V5.3 | shell-solid contact | `examples/shell_solid_contact` | `example_shell_solid_contact_benchmark` | contact profile, master search, shell-to-solid force transfer | active contact 大于零;master search 和 nodal force 指标通过 checker |
| V5.3 | 接触状态和 restart 连续性 | `tests/module` | `contact_mortar_al`, `contact_mortar_iter`, `contact_mortar_report`, `contact_mortar_tangent`, `contact_multiplier_report`, `restart` | AL multiplier, `contact_multiplier_audit`, `mortar_tan_audit_matrix`, tangent/report diagnostics, restart restored history | 接触历史、摩擦累计量和 multiplier 状态在 restart 后连续;0.5.1 覆盖 active/released/open multiplier 写读、duplicate/invalid 为零、commit/trial 差异为零,并检查 mortar tangent row/column balance、刚体平移残差、非对称量和能量 probe |
| V5.4 | Mohr-Coulomb 材料点 | `tests/unit` | `material_mohr_coulomb`, `material_mc_driver`, `material_mc_envelope` | 三轴压缩/伸展、纯剪、张拉截断、branch id、plastic multiplier | yield margin、分支号、塑性增量和 envelope safety ratio 通过测试容差 |
| V5.4 | 强度折减坡体 benchmark | `examples/strengthReduction` | `example_strength_reduction_benchmark` | `FS=1.21125`, 8 trials, 3 stable, 5 unstable, 2 active plastic probes | safety factor 在 checker 容差内;bracket 收敛;plastic zone 和 displacement probe 激活 |
| V5.5 | Euler column 解析屈曲 | `examples/euler_column_buckling` | `example_euler_column_buckling_benchmark` | first load relative error `3.27660856E-05`, residual `1.50014805E-11`, `phi^T K_G phi=1` | 相对误差、残差和几何刚度归一化通过 checker |
| V5.5 | 波纹壳循环屈曲 benchmark | `examples/buckling_corrugated_shell` | `example_buckling_corrugated_shell_benchmark` | selected wave 4 load `453.031407`, critical wave 8 load `393.369677`, cyclic/full relative error `1.25473461E-16` | 循环边界残差、模态残差、wave sweep 和 modal CSV 通过 checker |
| V5.5 | 屈曲/循环模块 | `tests/module` | `buckling_support`, `cyclic_symmetry` | geometric stiffness helper, cyclic map residual | 内部 dense 特征值、Euler helper 和周期映射通过模块容差 |
| V5.6 | 辊运动学和正则化牵引 | `examples/roll_forming` | `example_roll_forming_kinematics_benchmark`, `rigid_roller` | mean slip `0.4` with spin vs `0.2` without spin; mean traction `289.208274` vs `228.478247`; torque `14.4604137` | 有/无角速度路径必须产生不同 slip/traction;摩擦能和扭矩为正 |
| V5.6 | 塑性成形和回弹 benchmark | `examples/roll_forming` | `example_roll_forming_springback_benchmark` | springback ratio `0.473154068`, residual displacement `0.0316107559`, plastic work `1.11591736E-05`, 56/81 plastic points | 塑性功为正;塑性区激活;残余弯矩接近零;回弹比例在 checker 范围内 |
| V5.7 | cohesive 单积分点 | `tests/module` | `cohesive_contact` | bonded loading, mixed-mode damage, unloading/reload, complete decohesion, restart | 损伤不可逆;耗散非负;failed 状态 traction 清零;restart 保持状态 |
| V5.7 | 球-膜粘附/脱粘 benchmark | `examples/ball_adhesion_decohesion` | `example_ball_adhesion_cohesive_benchmark` | peak pull-off `119.246023`, min compression `-362.051100`, dissipated energy `0.451891017`, final failed fraction `1.0` | 滞回面积、耗散能、损伤和脱粘面积通过 checker |
| V5.8 | 颗粒基础验收 | `tests/module` | `particle_acceptance`, `particle_fem_coupling` | free fall, wall collision, three-particle pile, particle-facet force balance | 质量守恒;重叠有界;耗散非负;facet 节点力平衡残差在容差内 |
| V5.8 | 动态颗粒柔性容器 benchmark | `examples/Dynamic_Grain_Packing_of_a_Flexible_Container` | `example_dynamic_grain_container_benchmark` | 4 particles, 4 facet contacts, `mapped_steps=40`, max load `3.68E+01`, min center `uz=-7.29240354E-06`, max overlap `3.00615680E-03` | 结构输入不得含 `*DLOAD` pressure surrogate;映射节点力和容器位移非零;质量守恒、重叠和能量通过 checker |
## 示例输出文件
| 示例目录 | 主要输出 | checker |
|---|---|---|
| `examples/contact_two_blocks_compression` | `pressure_profile.csv`, VTK | `check_contact_results.py` |
| `examples/contact_block_sliding` | `sliding_profile.csv`, VTK | `check_contact_results.py` |
| `examples/shell_shell_contact` | shell contact profile, VTK | `check_contact_results.py` |
| `examples/shell_solid_contact` | shell-solid contact profile, VTK | `check_contact_results.py` |
| `examples/strengthReduction` | `strength_reduction_history.csv`, summary, `plastic_zone.csv`, `displacement_probe.csv` | `check_strength_reduction_results.py` |
| `examples/euler_column_buckling` | `buckling_summary.csv`, `buckling_mode_1.csv` | `check_buckling_results.py` |
| `examples/buckling_corrugated_shell` | summary, wave sweep, modes, profile | `check_buckling_results.py` |
| `examples/roll_forming` | roller kinematics history/summary, springback history/summary, `plastic_zone.csv` | `check_roller_kinematics.py`, `check_springback_results.py` |
| `examples/ball_adhesion_decohesion` | `adhesion_history.csv`, `adhesion_summary.csv`, `decohesion_profile.csv` | `check_cohesive_results.py` |
| `examples/Dynamic_Grain_Packing_of_a_Flexible_Container` | `grain_container_history.csv`, `grain_container_summary.csv` | `check_grain_container_results.py` |
## Smoke 与 benchmark 边界
- V4 smoke 仍用于快速确认旧路径,例如动态颗粒容器目录中的 pressure/ground
smoke、roll forming friction smoke 和 ball adhesion contact smoke。
- V5 完成项必须至少有模块级验收或示例级 checker;不能只依赖 smoke。
- benchmark 编排工具放在 `tools/benchmarks`,示例输入和 checker 放在对应
`examples/<case>/` 目录,生产功能代码仍保留在 `src`。
- 当前模块不引入第三方 solver 或外部求解器进程;相关验收只覆盖内部 solver。
## 文档治理边界
- 状态标记只在 `docs/v5_development_plan.md` 维护;本矩阵只记录可运行入口、
指标和容差,避免多个文档出现互相冲突的 PASS/PARTIAL 口径。
- 每次新增或修正 benchmark 时,必须同步本文件中的 CTest 名称、示例目录、
checker、参考指标和容差说明。
- 每次完成发布确认、多平台复测或 longrun 后,必须同步本文件的测试层级和
多平台复测矩阵,并同步 `docs/v5_acceptance_report.md` 的验收结论。
- 若某项仅为 smoke、surrogate 或 debug fallback,不得在本矩阵中列为 V5
完成项;只能在边界说明或 DEFERRED/PARTIAL 说明中登记。