Files
FemLite/docs/v5_acceptance_report.md
T
shenw 2b7962eb96
FemLite CI / build-test (push) Has been cancelled
Release FemLite 0.5.3
2026-07-01 18:39:18 +08:00

16 KiB
Raw Blame History

FemLite 0.5.x V5 Acceptance Report

日期:2026-06-26

本文档记录 FemLite 0.5.x 当前 V5 开发态的阶段验收结果。它不是最终发布 公告;20.1 发布确认和 20.2 多平台复测已完成,最终发布前仍需完成更大规模 longrun 和剩余 PARTIAL 能力的工程化收束。

2026-06-30 V5.11 Scope Update

V5 release planning is now narrowed to a V5.11 finite-strain S4 capability checkpoint. The release claim is bounded: finite-membrane-strain S4 production dispatch, stable shell geometry inputs, continuation-path diagnostics, the spherical-cap Shell-4 translational-rim benchmark口径 and a reproducible post-peak load drop.

The release claim does not include strict full-curve reproduction of models.sme.spherical_cap_with_central_point_load.pdf through uz=-6.2 m, Shell-4/8/16 digitized reference matching, true pseudo-arclength branch following, or late post-peak GMRES performance close-out. Those items, together with the V5.12 engineering backlog, are deferred to the next version line and must be documented as limitations rather than release blockers.

2026-07-01 V5.12 Close-Out Boundary

V5.12 is closed as a bounded engineering checkpoint, not as a promise to finish every high-fidelity workflow listed in the original V5 plan.

V5 delivery includes the already stable subset: internal solver hardening, contact regression evidence, Mohr-Coulomb material and strength-reduction diagnostics, the selected two_arches reference-point check, bounded spherical-cap continuation/Riks evidence, small dense generic *BUCKLING, static-preload-to-buckling for explicit geometric lines and C3D4/C3D8 solid initial-stress K_G, WAVE=0 explicit-pair cyclic symmetry for solid and shell nodes, normal output-directory handling for generic buckling outputs, and the source-size governance cleanup already covered by targeted regression.

Deferred after V5: full shell preload-to-buckling geometric stiffness, higher-order solid geometric stiffness, automatic cyclic boundary pairing, nonzero harmonic-wave cyclic semantics, full shell FE corrugated preload buckling, production roll-forming process workflow, production cohesive contact integration, high-fidelity example upgrades that depend on those algorithms, and broad longrun/performance matrices.

The current V5 acceptance claim is therefore limited to the documented bounded subset and its regression tests. Deferred items must stay documented as post-V5 work and must not remain on a V5 must-complete checklist.

Current local regression evidence on 2026-07-01: ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure passed 39/39. The focused bounded buckling/cyclic subset also passed 8/8 with implicit_inp, cyclic_symmetry, cli_buckling_generic_dense, cli_buckling_static_preload_dense, cli_buckling_solid_preload_dense, buckling_support, example_euler_column_buckling_benchmark, and example_buckling_corrugated_shell_benchmark.

验收范围

当前报告覆盖:

  • 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 接口已移除且旧编号作为非法配置拒绝

执行命令

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 --build build-codex-gcc --parallel
ctest --test-dir build-codex-gcc -R "^(solver_implicit|implicit_inp|linear_solver_cg|restart|contact_mortar_report|contact_mortar_tangent|contact_multiplier_report|perf_contact_pair_omp_consistency)$" --output-on-failure
ctest --test-dir build-codex-gcc -R "^(example_contact_two_blocks_compression_benchmark|example_contact_block_sliding_benchmark|example_shell_shell_contact_benchmark|example_shell_solid_contact_benchmark)$" --output-on-failure
ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure
ctest --test-dir build-codex-gcc -R "^example_spherical_cap_point_load_benchmark$" --output-on-failure
$env:FEMLITE_SPHERICAL_CAP_NONLINEAR='1'
python examples\spherical_cap_with_central_point_load\check_spherical_cap_results.py . build-codex-gcc\femlite.exe build-codex-gcc\example_benchmark\spherical_cap_point_load_bounded

测试结果

命令 结果
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
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
0.5.1 V5.3 定向接触审计与 OpenMP smoke 7/7 passed
cmake --build build-codex-gcc --parallel passed for 0.5.3
0.5.3 targeted nonlinear/contact diagnostic regression on build-codex-gcc 8/8 passed
0.5.3 contact benchmark diagnostic checker subset on build-codex-gcc 4/4 passed
ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure 39/39 passed
ctest --test-dir build-codex-gcc -R "^example_spherical_cap_point_load_benchmark$" --output-on-failure 1/1 passed
V5.11 bounded spherical-cap nonlinear checker, FEMLITE_SPHERICAL_CAP_NONLINEAR=1 passed; 54 accepted increments

已完成内容

领域 验收证据
内部 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 按 PDF 路线输出 8 工况 path/cases、summary、塑性区和位移探针;PDF 参考位移云图尚未作为通过项。
屈曲和循环对称 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 验证真实粒子、映射节点力和柔性容器位移。
finite-strain S4 V5.11 已接入 finite-strain S4 生产路径、稳定 shell geometry 输入、continuation path 诊断和球冠 Shell-4 translational-rim bounded postbuckling checker。extended nonlinear checker 运行到 uz=-3.24 m,验证 post-peak load drop;完整 PDF 全曲线匹配不作为本报告通过项。
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 PDF 8 工况 FOS 曲线最大误差 6.9392E-03,86 trials,52 stable,34 unstable
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
examples/spherical_cap_with_central_point_load bounded nonlinear 54 accepted increments, final wn=15.89482, final Fn=1.058395, sampled Fn=1.340817 at wn=13.642; path shows post-peak load drop

仍需完善内容

领域 原因 风险 用户影响
完整 mortar / AL 一致切线 当前已有 multiplier、mortar、friction、多示例 benchmark;0.5.3 已补 nonlinear failure reason、residual breakdown、contact state/gap/slip/friction/multiplier/augmentation diagnostics、restart v4 diagnostic round-trip、normal/stick/slip tangent audit split 和 1/2/4 线程 OpenMP deterministic path consistency;完整工业级一致切线和真实非线性长路径仍移入后续版本 大规模非线性接触可能需要更强收敛控制 当前可运行紧凑接触 benchmark、接触审计回归和路径级并行一致性;不能宣称覆盖所有工业接触场景
Mohr-Coulomb 结构级自动 trial 重求解 材料点、活动集算法一致切线和 FOS 曲线 benchmark 已完成,完整结构非线性失稳判据和 PDF 位移/塑性云图仍需扩展 复杂边坡或三维岩土模型可能过早/过晚判稳 当前适合强度折减曲线验证,不等价于完整岩土生产求解器
通用 *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 装填求解器
球冠完整 PDF 全曲线 V5.11 验收收窄为 finite-strain S4 bounded postbuckling capability;完整 uz=-6.2 m、Shell-4/8/16 digitized reference matching、later restiffening 和 late GMRES 性能优化移入后续版本 严格参考曲线复现仍需更强 continuation 与性能工作 用户可使用 V5.11 验证 S4 finite-strain 生产路径和 post-peak load drop,不能把它声明为完整 NAFEMS/PDF 全曲线复现
后续 longrun 发布节奏 正式 v0.5.0 标签已指向包含 20.2 多平台复测和 20.4 文档治理的节点;main 后续提升到 0.5.3 更大规模 longrun 和剩余 PARTIAL 能力仍需后续版本继续收束 不影响 v0.5.0 阶段验收结论;后续发布应明确新的 tag/commit

暂缓或不纳入当前模块

项 原因 风险 用户影响
第三方/外部稀疏求解器后端 用户约束要求本模块不依赖第三方库且不允许外部求解器接口 若未来需要更大规模求解,需另行设计可选外围项目,不应污染核心模块 当前核心只支持内部 CG/BiCGSTAB/GMRES 和 dense pivoting fallback;旧外部编号会被拒绝
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 收束到可验收闭环,并完成 0.5.3 nonlinear/contact explainability hardening。v5_acceptance 标签提供当前 V5 验收子集,build-codex-gcc 当前记录为 39/39 passed;历史默认 Release CTest 保持 106/106 passed,并已完成 WSL GNU 和 Windows Intel/MSVC 多平台复测。

最终 0.5.x 发布仍需完成更大规模 longrun、最终标签决策和剩余 PARTIAL 能力的 工程化收束;不得把当前紧凑 benchmark 夸大为完整工业场景全覆盖。