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

191 lines
16 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 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 接口已移除且旧编号作为非法配置拒绝 |
## 执行命令
```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 --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|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 |
| `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 夸大为完整工业场景全覆盖。