Files
FemLite/docs/v5_acceptance_report.md
T
shenw a2a11179d9
FemLite CI / build-test (push) Has been cancelled
Advance V5.3 contact audits for 0.5.1
2026-06-26 14:20:57 +08:00

127 lines
11 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 能力的工程化收束。
## 验收范围
当前报告覆盖:
- 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 夸大为完整工业场景全覆盖。