# FemLite 0.5.x V5 Acceptance Report 日期:2026-06-26 本文档记录 FemLite 0.5.x 当前 V5 开发态的阶段验收结果。它不是最终发布 公告;20.1 发布确认和 20.2 多平台复测已完成,最终发布前仍需完成更大规模 longrun 和剩余 PARTIAL 能力的工程化收束。 ## 验收范围 当前报告覆盖: - V5.2 内部稀疏求解器强化和 no-external-solver 策略。 - V5.3 接触 benchmark 增强,包括非匹配实体、滑移摩擦、shell-shell、 shell-solid 接触,以及 0.5.1 新增的 multiplier restart/tangent audit。 - V5.4 Mohr-Coulomb 材料点和强度折减 benchmark。 - V5.5 Euler 柱、波纹壳循环屈曲和循环对称验证。 - V5.6 滚压辊运动学和塑性回弹 benchmark。 - V5.7 cohesive 单积分点和球-膜粘附/脱粘 benchmark。 - V5.8 内置离散球颗粒、颗粒-facet 映射和动态颗粒柔性容器 benchmark。 - V5.9 benchmark 矩阵和 V5 验收 CTest 标签。 - V5.10 验收报告、release hygiene checkpoint、clean clone 发布确认和多平台复测。 ## 测试环境 | 项 | 记录 | |---|---| | 工作目录 | `D:\Codex\FemLite` | | 主构建目录 | `build-win-gcc-16` | | 多平台构建目录 | `build-wsl-gfortran-v5-20-2`、`build-win-ifx-v5-20-2` | | 构建类型 | Release | | 操作环境 | Windows PowerShell、WSL Ubuntu 24.04、Windows Intel oneAPI/VS DevCmd | | 日期 | 2026-06-26 | | Windows GCC 工具链 | GNU Fortran 16.1.0 | | WSL GNU 工具链 | GNU Fortran 13.3.0、GNU C 13.3.0、CMake 3.28.3 | | Windows Intel/MSVC 工具链 | VS DevCmd 17.14.33、MSVC 19.44.35227.0、IntelLLVM ifx 2026.0.0 | | 第三方 solver | 不使用;外部/第三方 solver 接口已移除且旧编号作为非法配置拒绝 | ## 执行命令 ```powershell cmake -S . -B build-win-gcc-16 cmake --build build-win-gcc-16 --config Release --target dynamic_grain_container_benchmark ctest --test-dir build-win-gcc-16 -C Release -R "example_dynamic_grain_container_benchmark|particle_acceptance|source_size" --output-on-failure ctest --test-dir build-win-gcc-16 -C Release -L v5_acceptance --output-on-failure ctest --test-dir build-win-gcc-16 -C Release --output-on-failure ctest --test-dir build-wsl-gfortran-v5-20-2 -C Release --output-on-failure ctest --test-dir build-wsl-gfortran-v5-20-2 -C Release -L v5_acceptance --output-on-failure ctest --test-dir build-win-ifx-v5-20-2 -C Release --output-on-failure ctest --test-dir build-win-ifx-v5-20-2 -C Release -L v5_acceptance --output-on-failure ctest --test-dir build-win-gcc-16 -C Release -R "contact_omp1|contact_omp4|perf_contact_pair_omp_consistency" --output-on-failure -V ctest --test-dir build-win-gcc-16 -C Release -R "^(contact_mortar_tangent|restart|contact_multiplier_diag|contact_multiplier_report|contact_omp1|contact_omp4|perf_contact_pair_omp_consistency)$" --output-on-failure ``` ## 测试结果 | 命令 | 结果 | |---|---| | `cmake -S . -B build-win-gcc-16` | 配置通过 | | `cmake --build build-win-gcc-16 --config Release --target dynamic_grain_container_benchmark` | 构建通过 | | `ctest --test-dir build-win-gcc-16 -C Release -R "example_dynamic_grain_container_benchmark|particle_acceptance|source_size" --output-on-failure` | 3/3 passed | | `ctest --test-dir build-win-gcc-16 -C Release -L v5_acceptance --output-on-failure` | 35/35 passed | | `ctest --test-dir build-win-gcc-16 -C Release --output-on-failure` | 106/106 passed | | `ctest --test-dir build-wsl-gfortran-v5-20-2 -C Release --output-on-failure` | 106/106 passed | | `ctest --test-dir build-wsl-gfortran-v5-20-2 -C Release -L v5_acceptance --output-on-failure` | 35/35 passed | | `ctest --test-dir build-win-ifx-v5-20-2 -C Release --output-on-failure` | 106/106 passed | | `ctest --test-dir build-win-ifx-v5-20-2 -C Release -L v5_acceptance --output-on-failure` | 35/35 passed | | `ctest --test-dir build-win-gcc-16 -C Release -R "contact_omp1|contact_omp4|perf_contact_pair_omp_consistency" --output-on-failure -V` | 3/3 passed | | 0.5.1 V5.3 定向接触审计与 OpenMP smoke | 7/7 passed | ## 已完成内容 | 领域 | 验收证据 | |---|---| | 内部 solver | CG、BiCGSTAB、GMRES、Jacobi/none 预条件、CSR 诊断、隐式/静力/非线性调用点和 C ABI legacy rejection 均有测试覆盖;无外部 solver 构建目标或接口。 | | 接触 benchmark | `contact_two_blocks_compression`、`contact_block_sliding`、`shell_shell_contact`、`shell_solid_contact` 均有示例目录、输入、checker、CTest 和参考指标;0.5.1 增加 multiplier restart audit、mortar tangent matrix audit 和 report 摘要审计字段。 | | Mohr-Coulomb | 材料点 driver/envelope 测试覆盖三轴、纯剪、张拉截断和分支诊断;`strengthReduction` 输出安全系数 history、summary、塑性区和位移探针。 | | 屈曲和循环对称 | Euler 柱解析 benchmark、波纹壳紧凑循环屈曲 benchmark、内部 dense 特征值求解和循环映射测试已接入。 | | 滚压 | 辊平移/下压/角速度运动学、正则化牵引、J2 多层截面成形、塑性功、塑性区和回弹指标已由示例 checker 验证。 | | cohesive | cohesive law/state/metrics 覆盖 loading、unloading、mixed-mode damage、complete decohesion、非负耗散和 restart;ball adhesion benchmark 输出滞回、拉脱力、能量和脱粘面积。 | | 颗粒耦合 | `particle_acceptance` 覆盖自由落体、墙碰撞、颗粒堆和颗粒-facet 载荷平衡;dynamic grain container benchmark 验证真实粒子、映射节点力和柔性容器位移。 | | benchmark 矩阵 | `docs/v5_benchmark_matrix.md` 映射 V5.2-V5.8 已完成能力到 CTest、目录、指标和容差;`v5_acceptance` 标签可运行当前 V5 验收子集。 | | 发布治理 | `docs/v5_development_plan.md` 为唯一状态入口;`docs/v5_benchmark_matrix.md` 记录可执行矩阵;本报告记录验收结论、限制和多平台复测证据。 | | 多平台复测 | Windows GCC 16、WSL GNU 13.3 和 Windows IntelLLVM 2026.0/MSVC 19.44 均通过默认 CTest 和 `v5_acceptance`;OpenMP contact/performance smoke 通过。 | ## 关键参考指标 | 案例 | 当前参考 | |---|---| | `examples/strengthReduction` | `FS=1.21125`, 8 trials, 3 stable, 5 unstable, 2 active plastic probes | | `examples/euler_column_buckling` | first load relative error `3.27660856E-05`, residual `1.50014805E-11`, `phi^T K_G phi=1` | | `examples/buckling_corrugated_shell` | selected wave 4 load `453.031407`, critical wave 8 load `393.369677`, cyclic/full relative error `1.25473461E-16` | | `examples/roll_forming` kinematics | mean slip `0.4` with spin vs `0.2` without spin; mean traction `289.208274` vs `228.478247`; positive torque `14.4604137` | | `examples/roll_forming` springback | springback ratio `0.473154068`, residual displacement `0.0316107559`, plastic work `1.11591736E-05`, 56/81 plastic points | | `examples/ball_adhesion_decohesion` | peak pull-off `119.246023`, dissipated energy `0.451891017`, final failed fraction `1.0` | | `examples/Dynamic_Grain_Packing_of_a_Flexible_Container` | 4 particles, 4 facet contacts, `mapped_steps=40`, max vertical mapped load `3.68E+01`, min center `uz=-7.29240354E-06`, max overlap `3.00615680E-03` | ## 仍需完善内容 | 领域 | 原因 | 风险 | 用户影响 | |---|---|---|---| | 完整 mortar / AL 一致切线 | 当前已有 multiplier、mortar、friction、多示例 benchmark、0.5.1 multiplier restart audit 和 tangent matrix audit;完整工业级一致切线、非线性长路径和更大规模并行 benchmark 仍需收束 | 大规模非线性接触可能需要更强收敛控制 | 当前可运行紧凑接触 benchmark 和接触审计回归;不能宣称覆盖所有工业接触场景 | | Mohr-Coulomb 结构级自动 trial 重求解 | 材料点和紧凑强度折减已完成,完整结构非线性失稳判据和工程切线仍需扩展 | 复杂边坡或三维岩土模型可能过早/过晚判稳 | 当前适合紧凑强度折减验证,不等价于完整岩土生产求解器 | | 通用 `*BUCKLING` step | 已有内部特征值和 benchmark 工具,主 `femlite` 输入流程尚未提供通用 buckling step | 用户需要通过 benchmark 工具验证屈曲,而非普通 INP 直接求解 | 小规模解析/紧凑循环 benchmark 可用,通用屈曲工况仍需后续版本 | | 完整三维滚压长跑 | 当前是辊运动学和紧凑多层 J2 截面 springback benchmark | 真实工艺网格、restart 多 step 和长时间稳定性尚未验证 | 用户可验证核心算法路径,但不能直接替代工业 roll forming 工艺仿真 | | 完整 FE cohesive 接触 step | 当前 cohesive law/state/metrics 和 ring benchmark 已完成,主接触流程切换与切线仍需集成 | 粘附/普通接触切换和 restart 长路径仍有风险 | 用户可使用 benchmark 验证 cohesive 模型,不应把它当作通用 FE cohesive 接触 | | 颗粒大规模 longrun | 当前 V5.8 限定内置离散球和紧凑柔性容器 benchmark | 大颗粒数性能、邻域搜索和长时间能量稳定性仍需验证 | 用户可验证双向映射闭环,但不能把它当作工业 DEM 装填求解器 | | 后续 longrun 发布节奏 | 正式 `v0.5.0` 标签已指向包含 20.2 多平台复测和 20.4 文档治理的节点;`main` 后续提升到 `0.5.1` | 更大规模 longrun 和 V5.3-V5.7 主流程工程化仍需后续版本继续收束 | 不影响 `v0.5.0` 阶段验收结论;后续发布应明确新的 tag/commit | ## 暂缓或不纳入当前模块 | 项 | 原因 | 风险 | 用户影响 | |---|---|---|---| | 第三方/外部稀疏求解器后端 | 用户约束要求本模块不依赖第三方库且不允许外部求解器接口 | 若未来需要更大规模求解,需另行设计可选外围项目,不应污染核心模块 | 当前核心只支持内部 CG/BiCGSTAB/GMRES;旧外部编号会被拒绝 | | `examples/shell_solid_connection` 高保真壳-实体连接 benchmark | 当前目录仍是共享节点 smoke,不是 V5 shell-solid contact benchmark | 连接过渡区应力和接触压力还缺高保真验证 | 用户可运行 smoke;高保真连接验收应等待后续示例 | | 工业规模颗粒 DEM 装填 | V5.8 只承诺内置离散球和紧凑 staggered 双向耦合 | 大规模性能和接触搜索尚未验收 | 当前 dynamic grain benchmark 用于算法闭环验收,不是工业 DEM 产品 | ## 结论 当前 V5 开发态已经将 V5.2 和 V5.8 收束到可验收闭环,并为 V5.3-V5.7 建立了真实算法路径、紧凑 benchmark 和可复现指标。`v5_acceptance` 标签提供 当前 V5 验收子集,默认 Release CTest 保持 106/106 passed,并已完成 WSL GNU 和 Windows Intel/MSVC 多平台复测。 最终 0.5.x 发布仍需完成更大规模 longrun、最终标签决策和剩余 PARTIAL 能力的 工程化收束;不得把当前紧凑 benchmark 夸大为完整工业场景全覆盖。