Files
FemLite/docs/v4_acceptance_report.md
T
2026-06-26 12:54:40 +08:00

6.8 KiB

FemLite 第四版 V4.8 阶段验收报告

日期:2026-06-25

1. 版本信息

  • 软件名称:FemLite
  • 阶段范围:第四版 V4.1 至 V4.8
  • 开发分支:dev/v0.4
  • 交付形态:静态库、命令行程序、C ABI 静态库、测试程序、Python 检查脚本和示例算例
  • 默认验收构建:Windows GCC 16,构建目录 build-win-gcc-16

2. 验收口径

V4.8 是第四版阶段验收收束版,重点确认 0.4.x 开发期新增的接触、隐式、壳稳定、线性求解器、示例和发布检查能力可以作为下一阶段基线。

本次验收覆盖:

  • 第一版、第二版、第三版已验收能力无回退。
  • surface/contact 输入子集、contact pair active-set、augmented penalty、摩擦历史、BVH 搜索、候选缓存和性能统计保持可回归。
  • 非线性静力和非线性 Newmark 收敛诊断、cutback 诊断和 C ABI 查询接口保持可回归。
  • CG/BiCGSTAB/GMRES 线性求解器分发、预条件设置和统计接口保持可回归。
  • 壳 drilling 稳定、S3 剪切锁定诊断、壳 J2 剪切/弯曲代表性塑性和 Scordelis-Lo smoke 保持可回归。
  • examples/ 下文档型目录均有可执行 .inp,包含 .inp 的目录均有 run_case.bat。

本报告不声称 FemLite 已具备完整 Abaqus 兼容、完整工程级 mortar 约束求解、完整 Mohr-Coulomb 强度折减、完整高尔夫球多层超弹/黏弹模型或完整 shell-solid benchmark 保真能力。相关文档派生案例在 V4.8 中作为可执行缩减基准和回归入口。

3. 验收项结果

验收项 结果 覆盖说明
基础回归 PASS smoke、材料、单元、数据库、稀疏矩阵、线性求解、输出和 restart 测试保留
接触与摩擦 PASS contact、OMP 1/4、contact block sliding、rigid impact 和接触统计回归覆盖
隐式与收敛诊断 PASS implicit inp、solver implicit、cutback 和收敛状态接口回归覆盖
线性求解器 PASS CG/BiCGSTAB/GMRES、Jacobi 和 C ABI 设置查询覆盖;external 仅为后续第三方库适配项
壳稳定与壳塑性 PASS drilling、S3 剪切锁定、S4 J2 剪切/弯曲、trial rollback 和 Scordelis-Lo smoke 覆盖
示例目录结构 PASS examples_layout 检查文档目录和双击脚本约定
文档派生示例 PASS elliptic membrane、membrane uniaxial、shell-solid connection、strength reduction、golf ball impact,以及 block-on-arch、roller contact、sliding wedge、airbag membrane、spherical cap、two arches、blasting rock、nonlinear harmonic、layered shell、pinched hemisphere、stress dependent elasticity、roll forming、falling objects、ball adhesion contact、corrugated shell buckling preload、dynamic grain container 和 thick plate 均接入 smoke
源码规模门禁 PASS source_size 保持通过

4. 示例矩阵

V4.8 期间补齐或确认的示例目录:

目录 运行入口 验收说明
examples/elliptic_membrane run_case.bat NAFEMS LE1 椭圆膜文档派生 S4 静力缩减案例
examples/membrane_uniaxial_stretching run_case.bat 各向同性膜单轴拉伸静力案例
examples/shell_solid_connection run_case.bat C3D8 与 S4 共享节点接口静力案例
examples/strengthReduction run_case.bat 强度折减文档派生线弹性坡体案例
examples/golfBallImpact run_case.bat 壳接触动力缩减案例,采用文档摩擦系数尺度
examples/node_analytical_plane_contact run_case.bat node-based slave surface 到 analytical rigid plane 的接触 smoke
examples/block_on_arch run_case.bat 浅拱与解析刚体面接触代表性 smoke
examples/cylinder_roller_contact run_case.bat 滚子-基础法向接触代表性 smoke
examples/sliding_wedge run_case.bat 倾斜接触面摩擦滑移 smoke
examples/membrane_airbag_inflation run_case.bat S4 膜片压力载荷回归入口
examples/spherical_cap_with_central_point_load run_case.bat 球冠中心载荷 S4 静力回归入口
examples/two_arches run_case.bat 双拱壳-壳接触代表性 smoke
examples/blasting_rock run_case.bat C3D8 花岗岩块爆破脉冲动力 smoke
examples/nonlinear_harmonic run_case.bat 薄膜谐波压力显式动力 smoke
examples/failure_prediction_in_a_layered_shell run_case.bat 四层共享节点壳拉伸回归入口
examples/pinched_hemispherical_shell run_case.bat pinched hemisphere S4 壳动力 smoke
examples/stress_dependent_elasticity run_case.bat 分区弹性模量悬臂梁弯曲回归入口
examples/roll_forming run_case.bat 滚压成形文档派生的压紧-摩擦牵引 smoke
examples/falling_objects run_case.bat 多物体显式接触与刚性箱底代表性 smoke
examples/ball_adhesion_decohesion run_case.bat 球-膜接触压入 smoke,粘附/脱粘本构为后续能力
examples/buckling_corrugated_shell run_case.bat 波纹锥壳屈曲文档派生的静力预载 smoke
examples/Dynamic_Grain_Packing_of_a_Flexible_Container run_case.bat 动态颗粒装填文档派生的柔性容器压力-地面接触 smoke
examples/thick_plate run_case.bat NAFEMS LE10 厚板压力静力回归入口
既有基准目录 run_case.bat Kirsch、Scordelis-Lo、shell patch、压力脉冲、刚球冲击、2D/3D 拉伸等均补齐双击入口

5. 测试命令

V4.8 发布前建议执行:

cmake --build build-win-gcc-16 --config Release
ctest --test-dir build-win-gcc-16 --output-on-failure

示例结构专项检查:

ctest --test-dir build-win-gcc-16 -R examples_layout --output-on-failure

示例 smoke 专项检查:

ctest --test-dir build-win-gcc-16 -L example_smoke --output-on-failure

本轮 Windows GCC 16 验证结果:

cmake --build build-win-gcc-16 --config Release
completed successfully

ctest --test-dir build-win-gcc-16 --output-on-failure
100% tests passed, 0 tests failed out of 66

6. 后续限制

  • 完整 Mohr-Coulomb 强度折减、完整高尔夫球多材料冲击、高保真 shell-solid benchmark、几何非线性 pinched hemisphere 载荷曲线、复合材料失效准则、应力相关弹性弱式映射、低反射边界、频域-时域谐波初值流程、完整滚压成形刚体辊旋转/塑性过程、球-膜粘附/脱粘 cohesive law、线性屈曲特征值、循环对称边界和颗粒流-膜双向耦合仍需核心求解器后续能力支持。
  • pinched cylinder、hemisphere、twisted beam 和更密 Scordelis-Lo 收敛矩阵建议作为 0.5.x 或专项长跑基准推进。
  • 第三方稀疏求解器后端不作为第四版完成范围;当前第四版完成范围以内置 CG、BiCGSTAB 和 GMRES 为准。