# 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 "" --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//` 目录,生产功能代码仍保留在 `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 说明中登记。