Complete V5 acceptance milestone

This commit is contained in:
shenw
2026-06-26 12:54:40 +08:00
parent 26639d8dc2
commit a01a4fda24
105 changed files with 8694 additions and 8922 deletions
+64
View File
@@ -0,0 +1,64 @@
# 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`。
## 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`, `restart` | AL multiplier, tangent/report diagnostics, restart restored history | 接触历史、摩擦累计量和 multiplier 状态在 restart 后连续 |
| 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。