27 KiB
FemLite 0.5.x 用户手册
日期:2026-06-26
1. 适用范围
本文档面向 FemLite 0.5.x 的使用者,说明如何编译、运行、准备输入文件、查看结果和复现实例。
FemLite 0.5.x 是船舶接触爆炸结构响应 FEM 软件的第五版开发线,当前支持:
- 三维实体和壳单元结构分析。
- 显式瞬态动力学。
- 线性静力学和非线性静力学。
- 隐式 Newmark 和非线性 Newmark-Newton 主流程。
- 各向同性线弹性、J2 弹塑性、Johnson-Cook 相关材料路径。
- Mohr-Coulomb 材料点更新、张拉截断、分支诊断、材料 driver 和强度折减参数折减基础。
- 小规模线性屈曲支撑模块、内部 dense 特征值求解和 Euler 柱解析 benchmark。
- Abaqus inp 输入子集。
- element/node/analytical surface 子集、contact property 子集、刚性平面接触和面-面 contact pair 阶段能力。
- contact pair active set、gap residual 和 augmented penalty 诊断输出。
- 静力/隐式求解的收敛状态和 cutback 诊断查询接口。
- 线性求解器可在内部 CG、BiCGSTAB、GMRES 和 dense pivoting fallback 间切换,并提供预条件和迭代/残差统计查询;核心模块不依赖第三方或外部稀疏求解器。
- CSV、VTK、restart 和 contact CSV 输出。
- Fortran95 原生接口、C ABI 子集和 Python 调试脚本。
0.5.x 当前开发态不等价于完整 Abaqus 兼容求解器,也不等价于全部 V5 高保真 benchmark 已完成的最终版。
2. 目录概览
常用目录:
src/ Fortran95 核心源码和 C ABI 包装
include/ C ABI 头文件
Python/ Python 调试辅助脚本
docs/ 需求、设计、接口、测试和验收文档
examples/ 示例算例和生成脚本
tests/ 单元、模块、接口、示例 smoke 和性能测试
主要可执行目标:
femlite:命令行分析程序。test_*:各类本地测试程序。perf_p1:P1 性能测试程序。
主要库目标:
femlite_core:Fortran95 静态核心库。femlite_c:C ABI 静态库。
3. 环境准备
推荐环境:
- Windows:GCC 16.1.0 或 Intel oneAPI ifx 2026.0 + MSVC。
- Linux/WSL:Ubuntu + gfortran 13.3。
- 构建系统:CMake 3.20 或更高版本。
- 可选:Python 3,用于示例生成和 Python 调试测试。
- 可选:Gmsh Python API,用于部分示例重新生成网格。
本项目默认以 WSL Ubuntu + gfortran 13.3 + CMake 作为主要开发环境,同时保留 Windows GCC 和 Intel ifx 兼容性检查。
4. 编译
4.1 Windows GCC
在仓库根目录运行:
cmake -S . -B build-win-gcc-16 -G "MinGW Makefiles" -DCMAKE_Fortran_COMPILER=C:\gcc-16.1.0-64\bin\gfortran.exe -DCMAKE_C_COMPILER=C:\gcc-16.1.0-64\bin\gcc.exe
cmake --build build-win-gcc-16
可执行程序通常位于:
build-win-gcc-16\femlite.exe
4.2 WSL gfortran
在 Windows PowerShell 中可调用 WSL:
wsl bash -lc "cd /mnt/d/Codex/FemLite && cmake -S . -B build-wsl"
wsl bash -lc "cd /mnt/d/Codex/FemLite && cmake --build build-wsl"
4.3 Intel oneAPI ifx
Intel oneAPI 在 Windows 上安装后,可通过 oneAPI 和 MSVC 环境脚本配置编译环境,再运行 CMake 构建。0.3.3 发布基线已通过 Windows Intel oneAPI ifx 2026.0 + MSVC cl 19.44 构建与 CTest;0.4.x 发布前建议按同一流程复测。
5. 命令行用法
基本形式:
build-win-gcc-16\femlite.exe input.inp [analysis-mode] [options]
如果只给出 input.inp,程序会读取输入文件、构建模型并打印模型摘要,不执行分析。
分析模式只能选择一个:
| 参数 | 含义 |
|---|---|
--run |
显式瞬态动力学 |
--static-linear |
线性静力学 |
--implicit-linear |
--static-linear 的兼容别名 |
--static-nonlinear |
非线性静力学 |
--implicit-newmark |
隐式 Newmark 线性动力学 |
--implicit-newmark-nonlinear |
非线性 Newmark-Newton 动力学 |
通用选项:
| 参数 | 含义 |
|---|---|
--output-dir path |
设置结果输出目录 |
--output-interval n |
设置输出间隔;0 表示不输出步结果 |
--allow-cutback |
允许非线性静力/非线性 Newmark 在不收敛时自动缩步 |
--max-newton n |
设置非线性 Newton 最大迭代次数 |
--newton-tol value |
设置非线性力残差收敛容差 |
示例:
build-win-gcc-16\femlite.exe examples\scordelis_lo_roof\scordelis_lo_s4_static.inp --output-dir examples\scordelis_lo_roof\results\s4_static --static-linear
build-win-gcc-16\femlite.exe examples\rigid_sphere_impact_plate\rigid_sphere_impact_plate_s4.inp --output-dir examples\rigid_sphere_impact_plate\results\s4 --output-interval 50 --run
6. 输入文件
FemLite 使用 Abaqus inp 风格输入文件的子集。0.4.8 常用支持项包括:
*NODE*ELEMENT*NSET*ELSET*MATERIAL*DENSITY*ELASTIC*PLASTIC*MOHR COULOMB*SOLID SECTION*SHELL SECTION*BOUNDARY*CLOAD*DLOAD*AMPLITUDE*STEP*DYNAMIC*STATIC*NONLINEAR CONTINUATION*SURFACE*SURFACE INTERACTION*CONTACT PROPERTY*FRICTION*CONTACT PAIRGENERATE
不支持的 keyword 默认 warning 后跳过;关键数据缺失、非法材料参数、非法单元类型等会报错终止。
7. 单元与材料
当前常用单元:
| 类别 | 单元 |
|---|---|
| 实体线性 | C3D4、C3D8 |
| 实体二次 | C3D10、C3D20 |
| 壳单元 | S3、S4、S6、S8 |
材料:
- 各向同性线弹性:
*DENSITY和*ELASTIC。 - J2 von Mises 弹塑性:
*PLASTIC。 - Johnson-Cook 流动应力、应变率和损伤相关路径为阶段能力,具体格式见设计和示例输入。
- Mohr-Coulomb:
*MOHR COULOMB,当前材料点路径支持摩擦角、黏聚力、膨胀角、张拉强度、残余参数和强度折减系数。
密度是动力学分析的必需材料参数。
Mohr-Coulomb 输入示例:
*MATERIAL, NAME=SOIL
*DENSITY
1800.0
*ELASTIC
2.0E7, 0.30
*MOHR COULOMB
30.0, 10000.0, 5.0, 2000.0
20.0, 4000.0, 1.0, 1.5
第一行依次为摩擦角 degree、黏聚力、膨胀角 degree 和张拉强度;第二行依次为
残余摩擦角 degree、残余黏聚力、残余膨胀角 degree 和强度折减系数。材料点输出中
statev(11) 记录当前分支,statev(12:13) 记录最终剪切/张拉屈服值,
statev(22) 记录最近一次塑性增量。若选择方法 5,statev(27:32) 还记录
Mohr-Coulomb 子步数、请求子步数、driver 状态、分支 mask、最大屈服残差和最大
塑性增量。结构级强度折减 benchmark 已在
examples/strengthReduction 中按 PDF 参考路线接入,通用非线性自动 trial
重求解仍作为后续增强。
非线性 continuation 方法选择:
*STEP
*NONLINEAR CONTINUATION, METHOD=TWO_STAGE_LOAD_STRENGTH
*STATIC
0.01, 1.0, 1.0e-5, 0.05
*END STEP
如果省略 *NONLINEAR CONTINUATION,默认使用 METHOD=1,即
TWO_STAGE_LOAD_STRENGTH。当前 METHOD=1..5 和对应符号名已可由 INP 解析并写入
非线性诊断;方法 1 已用于 strengthReduction 非线性 chain/cloud 的两阶段路线:
先在强度因子 F=1.0 下收敛完整外载,再固定外载并推进材料强度折减因子。方法
2 ADAPTIVE_TARGET_NEWTON 已可用 TARGET_NEWTON、GROWTH 和 SHRINK 控制
静力 continuation 步长;方法 3 TRUST_REGION_DAMPED_NEWTON 已可用
TRUST_RADIUS、TRUST_MIN_RADIUS、TRUST_MAX_RADIUS、TRUST_GROWTH、
TRUST_SHRINK、TRUST_ACCEPT_RATIO 和 TRUST_GOOD_RATIO 限制 Newton 修正、
执行 residual-merit damping 并输出 trust 诊断。方法 4
ARC_LENGTH_OR_DISPLACEMENT_CONTROL 当前可记录直接 prescribed-displacement
accepted path:每个收敛增量输出控制参数、目标/实际位移、约束残差、反力和收敛状态;
完整弧长/Riks 增广方程仍按 V5 计划中的 NC-4 继续完善。方法 5
MC_SUBSTEPPING_SEMISMOOTH 当前会在 Mohr-Coulomb 材料点启用局部子步和活动集
诊断;结构级 substep 汇总和 longrun 效果证明仍按 NC-5 继续完善。
方法 2 示例:
*NONLINEAR CONTINUATION, METHOD=ADAPTIVE_TARGET_NEWTON, TARGET_NEWTON=6, GROWTH=1.5, SHRINK=0.5
方法 3 示例:
*NONLINEAR CONTINUATION, METHOD=TRUST_REGION_DAMPED_NEWTON, TRUST_RADIUS=0.1, TRUST_MIN_RADIUS=1.0e-6, TRUST_MAX_RADIUS=1.0, TRUST_GROWTH=1.5, TRUST_SHRINK=0.5
方法 4 示例:
*NONLINEAR CONTINUATION, METHOD=ARC_LENGTH_OR_DISPLACEMENT_CONTROL, SHELL_GEOMETRIC=YES
当输出目录启用且有 accepted path 数据时,会生成 continuation_path.csv;库调用者
也可使用 fem_get_continuation_path_count 和 fem_get_continuation_path_row
查询同一数据。SHELL_GEOMETRIC=YES 显式请求 S4 corotational 几何非线性路径;
GEOMETRIC_SHELL、COROTATIONAL_SHELL 和 S4_COROTATIONAL 是等价别名。方法 4
本身也会默认使用该 S4 路径。当前该路径包含弹性 S4 algorithmic tangent、
prestress-delta 膜几何刚度和壳压力 follower tangent。若 S4 壳材料不是
ELASTIC,该路径会在刚度装配阶段返回材料错误;完整弧长/Riks 方程、
塑性/多层壳切线和完整 Shell-4/8/16 后屈曲验收仍属于后续 V5.11 工程项。
方法 5 示例:
*NONLINEAR CONTINUATION, METHOD=MC_SUBSTEPPING_SEMISMOOTH, MC_MIN_SUBSTEPS=2, MC_MAX_SUBSTEPS=64, MC_TARGET_STRAIN=1.0e-3, MC_YIELD_TOL=1.0e-7, MC_PLASTIC_LIMIT=5.0e-2
方法 5 只改变 Mohr-Coulomb 局部材料积分路径;若算例没有 MOHR_COULOMB 材料,
这些 MC 控制项不会改变弹性或 J2 材料更新。
8. 边界、载荷与接触
常用边界和载荷:
*BOUNDARY:节点或集合自由度约束。*CLOAD:集中节点力。*DLOAD:分布载荷子集;target, P, pressure用于壳面压力,target, GRAV, magnitude, gx, gy, gz用于实体重力/体力加速度。*AMPLITUDE:时间或增量相关幅值。
contact pair 支持两种输入方式。
header 式:
*CONTACT PAIR, SLAVE=slave_target, MASTER=master_target, PENALTY=value, DAMPING=value, SEARCH=value, FRICTION=value, FRICTION_REGULARIZATION=value, AUGMENT=value
contact property 继承式:
*SURFACE, NAME=slave_surface, TYPE=ELEMENT
slave_elset_or_element, face_label
*SURFACE, NAME=master_surface, TYPE=ELEMENT
master_elset_or_element, face_label
*SURFACE INTERACTION, NAME=normal_contact, PENALTY=value, DAMPING=value, SEARCH=value, FRICTION_REGULARIZATION=value, AUGMENT=value
*FRICTION
mu
*CONTACT PAIR, INTERACTION=normal_contact
slave_surface, master_surface
说明:
PENALTY可在 contact pair 或 contact property 中给出,最终值必须大于 0。DAMPING、SEARCH、FRICTION、FRICTION_REGULARIZATION、AUGMENT可选,默认 0。FRICTION_REGULARIZATION是接触对级摩擦正则化滑移尺度;0 表示经典 Coulomb 截断。SLAVE和MASTER可为 surface 名称、elset 名称、element id 字符串或ALL。*SURFACE当前支持TYPE=ELEMENT、TYPE=NODE和TYPE=ANALYTICAL刚性平面子集。- 面-面 contact pair 当前仍以 element surface facet 路径为主;node surface 和 analytical plane 主要用于节点目标/刚性平面接触子集。
- analytical plane 数据行为
PLANE, nx, ny, nz, offset。 - face label 支持省略、
ALL、EXTERIOR、S1、F1、FACE1等形式。 - 壳单元支持
SPOS/SNEG当前单一 shell facet 语义。
9. 输出文件
默认输出文件包括:
| 文件 | 内容 |
|---|---|
history.csv |
时间步、能量或求解历史 |
nodes_XXXXXXXX.csv |
节点位移、速度、加速度等 |
elements_XXXXXXXX.csv |
单元应力、应变、塑性变量等 |
reactions_XXXXXXXX.csv |
节点反力 |
result_XXXXXXXX.vtk |
Legacy ASCII VTK 后处理文件 |
contact_XXXXXXXX.csv |
接触 summary 和逐 contact pair 统计 |
restart_*.frs |
restart 文件 |
contact_XXXXXXXX.csv 当前字段包含:
kind,pair_id,active_count,max_penetration,force_norm,work_estimate,cumulative_work,stick_count,slip_count,accumulated_slip,friction_work,friction_work_total,friction_regularization,ftx,fty,ftz,status,activation_count,release_count,gap_residual,aug_factor,aug_lambda,search_facets,search_masters,search_candidates,search_active,search_bvh_nodes,search_cache_used,search_cache_overflow,search_cpu_time,contact_force_cpu_time,contact_tangent_cpu_time
search_* 字段在 SUMMARY 行给出最近一次 contact pair 力评估的全局搜索统计、BVH 候选缓存使用情况和 cpu_time 口径秒数;逐 PAIR 行给出对应接触对的搜索、缓存和计时统计。cpu_time 是轻量趋势诊断,小算例中可能显示为 0。
Fortran95 API 可通过 fem_get_convergence_status 查询最近一次求解的增量、迭代、残差、位移修正范数和收敛标志;在 trust-region damped Newton 中,位移修正范数是半径限制和 damping 后实际应用的范数。通过 fem_get_convergence_metrics 可查询相对残差、contact gap residual 和 combined norm,通过 fem_get_convergence_diagnostics 查询 cutback 次数、最后步长、最后有效时间、状态码和失败原因码。fem_set_linear_solver 可选择 CG、BiCGSTAB、GMRES、DENSE 与 none/Jacobi/Gauss-Seidel/ILU0 预条件,fem_get_linear_solver_stats 查询最近一次线性求解迭代数、残差和状态,fem_get_linsol_diagnostics 查询 CSR 矩阵分类、初始残差、最终残差和最终相对残差;其他 method 值会返回错误且不会改变当前设置。非线性 Newton 修正若在配置的 CG 路径遇到非正定切线,可在内部 GMRES、BiCGSTAB 和 dense pivoting fallback 间自动重试,并在返回前恢复用户配置的求解器设置。V4.7 起,fem_set_shell_stabilization 可设置壳 drilling 系数、S3 剪切锁定折减系数和最小折减比例,默认分别为 1.0e-4、0.0625、1.0e-4;fem_get_shell_stability_stats 可查询最近壳刚度装配诊断。C ABI 提供同名 femlite_get_*/femlite_set_* 包装,converged 使用 0/1 整数返回。
建议把大型结果输出到 examples/.../results/... 或独立 output/ 目录。仓库 .gitignore 默认忽略大规模结果文件。
10. 示例算例
当前示例包括:
| 目录 | 说明 |
|---|---|
examples/uniaxialTension3D |
3D 圆柱单轴拉伸,tet/hex |
examples/tension2D |
板壳拉伸,tri/quad |
examples/ScordelisLo |
Scordelis-Lo 屋面壳体基准 |
examples/scordelis_lo_roof |
V4.7 Scordelis-Lo S3/S4 独立基准目录 |
examples/Kirsch |
Kirsch 带孔板静力基准 |
examples/shell_patch_test |
壳单元 patch test |
examples/clamped_square_plate_pressure_pulse |
固支方板压力脉冲 |
examples/rigid_sphere_impact_plate |
刚球冲击板壳接触算例 |
examples/elliptic_membrane |
NAFEMS LE1 椭圆膜缩减静力案例 |
examples/membrane_uniaxial_stretching |
文档参数派生的膜单轴拉伸静力案例 |
examples/shell_solid_connection |
共享节点壳-实体接口静力案例 |
examples/strengthReduction |
Mohr-Coulomb 坡体强度折减 benchmark |
examples/euler_column_buckling |
Euler pinned-pinned column 线性屈曲解析 benchmark |
examples/golfBallImpact |
高尔夫冲击文档派生的壳接触动力缩减案例 |
examples/node_analytical_plane_contact |
node surface 到 analytical plane 的接触 smoke |
examples/block_on_arch |
文档派生的浅拱-解析刚体面接触 smoke |
examples/cylinder_roller_contact |
滚子-基础法向接触代表性 smoke |
examples/sliding_wedge |
倾斜楔块摩擦滑移接触 smoke |
examples/membrane_airbag_inflation |
膜气囊压力载荷 S4 动力/静力回归入口 |
examples/spherical_cap_with_central_point_load |
球冠中心载荷位移控制壳 benchmark;默认检查 Shell-16 小应变样本,附带 opt-in S4 corotational nonlinear diagnostic deck |
examples/two_arches |
基于 models.sme.two_arches.pdf 几何的双拱壳-壳接触 benchmark |
examples/blasting_rock |
花岗岩块爆破脉冲显式动力 smoke |
examples/nonlinear_harmonic |
薄膜谐波压力响应显式动力 smoke |
examples/failure_prediction_in_a_layered_shell |
四层共享节点壳拉伸回归入口 |
examples/pinched_hemispherical_shell |
pinched hemisphere S4 壳动力 smoke |
examples/stress_dependent_elasticity |
应力相关弹性悬臂梁纯弯矩 benchmark |
examples/roll_forming |
滚压摩擦 smoke、roller kinematics benchmark 和 springback benchmark |
examples/falling_objects |
多物体显式接触与刚性箱底代表性 smoke |
examples/ball_adhesion_decohesion |
球-膜接触压入 smoke 和 compact cohesive 粘附/脱粘 benchmark |
examples/buckling_corrugated_shell |
波纹锥壳紧凑循环线性屈曲 benchmark |
examples/Dynamic_Grain_Packing_of_a_Flexible_Container |
柔性容器压力-地面接触 smoke 和 V5.8 真实粒子-柔性容器耦合 benchmark |
examples/thick_plate |
NAFEMS LE10 厚板压力静力回归入口 |
examples/contact_rigid_plane_indentation |
刚性平面压入接触算例 |
examples/contact_two_blocks_compression |
非匹配两实体块 mortar 压缩接触 benchmark |
examples/shell_rigid_plane_contact |
S4 壳-刚性平面接触算例 |
examples/contact_block_sliding |
非匹配两实体块大滑移 mortar-friction benchmark |
examples/shell_shell_contact |
S4-to-S4 shell-shell 接触 benchmark |
examples/shell_solid_contact |
S4-to-C3D8 shell-solid 接触 benchmark |
每个示例目录中的 README.md 给出几何、材料、边界、生成脚本和运行命令。新增基准测试应放在 examples/ 下,并为每个基准案例建立独立文件夹;旧目录可为兼容保留,但新的 CTest 和文档应优先指向独立目录。包含 .inp 的示例目录应提供 run_case.bat,可在 Windows 下双击自动运行,结果默认写入该目录的 results\auto_run。examples/contact_two_blocks_compression 的检查脚本会额外生成 pressure_profile.csv,用于检查非匹配接触压力、gap、weighted gap、multiplier residual 和 augmented multiplier。examples/contact_block_sliding 的检查脚本会额外生成 sliding_profile.csv,用于检查多 master 大滑移摩擦、stick/slip、累计滑移、摩擦功和切向力。examples/shell_shell_contact 和 examples/shell_solid_contact 的检查脚本分别生成 shell contact profile CSV,用于检查 active contact、force、gap、augmented multiplier 和 master search。examples/strengthReduction 的 benchmark checker 会生成 strength_reduction_path.csv、strength_reduction_cases.csv、strength_reduction_summary.csv、plastic_zone.csv 和 displacement_probe.csv,用于检查 PDF 8 工况安全系数曲线、bracket、塑性区和位移停止准则。examples/euler_column_buckling 的 benchmark checker 会生成 buckling_summary.csv 和 buckling_mode_1.csv,用于检查 Euler 临界载荷相对误差、特征残差、phi^T K_G phi 归一化和端部横向位移约束。examples/buckling_corrugated_shell 的 benchmark checker 会生成 corrugated_buckling_summary.csv、corrugated_buckling_waves.csv、corrugated_buckling_modes.csv 和 corrugated_buckling_profile.csv,用于检查循环波数、临界载荷、循环/全模型一致性、循环边界残差和模态输出。examples/roll_forming 的 roller kinematics checker 会生成 roller_kinematics_history.csv 和 roller_kinematics_summary.csv,用于检查辊角速度对切向滑移、正则化牵引、摩擦能、压力和扭矩的影响;springback checker 会生成 springback_history.csv、springback_summary.csv 和 plastic_zone.csv,用于检查 J2 塑性功、塑性区、卸载残余弯矩、残余位移和回弹比例。examples/ball_adhesion_decohesion 的 cohesive checker 会生成 adhesion_history.csv、adhesion_summary.csv 和 decohesion_profile.csv,用于检查 force-displacement 滞回、峰值拉脱力、耗散能、损伤和脱粘面积。examples/Dynamic_Grain_Packing_of_a_Flexible_Container 的 particle checker 会生成 grain_container_history.csv 和 grain_container_summary.csv,用于检查真实粒子-facet 接触、映射节点力、容器位移、质量守恒、重叠和能量。
examples/strengthReduction 的可选 nonlinear chain/cloud/progress 输出还会记录
continuation_method、target/actual/next continuation step、adaptive adjust、
trust radius、damping、merit ratio、trust rejection、MC 子步/分支聚合诊断和直接位移
控制 path 诊断;checker 会拒绝缺失或非法的 NC-2/NC-3/NC-5 字段;NC-4 path 数据由
生产 API/CSV 输出提供。
11. 测试
运行全量测试:
ctest --test-dir build-win-gcc-16 --output-on-failure
运行 V5 验收子集:
ctest --test-dir build-win-gcc-16 -C Release -L v5_acceptance --output-on-failure
运行指定测试:
ctest --test-dir build-win-gcc-16 -R "^(contact|implicit_inp|source_size)$" --output-on-failure
运行 V5.3 two-block 非匹配接触 benchmark:
ctest --test-dir build-win-gcc-16 -C Release -R example_contact_two_blocks_compression_benchmark --output-on-failure
运行 V5.3 large-sliding 摩擦 benchmark:
ctest --test-dir build-win-gcc-16 -C Release -R example_contact_block_sliding_benchmark --output-on-failure
运行 V5.3 shell contact benchmark:
ctest --test-dir build-win-gcc-16 -C Release -R "example_shell_(shell|solid)_contact_benchmark" --output-on-failure
运行 V5.4 Mohr-Coulomb 材料点测试:
ctest --test-dir build-win-gcc-16 -C Release -R "material_mohr_coulomb|material_mc_driver|material_mc_envelope" --output-on-failure
运行 V5.4 Mohr-Coulomb 强度折减 benchmark:
ctest --test-dir build-win-gcc-16 -C Release -R example_strength_reduction_benchmark --output-on-failure
运行 V5.5 Euler 柱线性屈曲 benchmark:
ctest --test-dir build-win-gcc-16 -C Release -R example_euler_column_buckling_benchmark --output-on-failure
运行 V5.5 波纹壳循环线性屈曲 benchmark:
ctest --test-dir build-win-gcc-16 -C Release -R example_buckling_corrugated_shell_benchmark --output-on-failure
运行 V5.6 roll forming roller kinematics benchmark:
ctest --test-dir build-win-gcc-16 -C Release -R example_roll_forming_kinematics_benchmark --output-on-failure
运行 V5.6 roll forming plastic springback benchmark:
ctest --test-dir build-win-gcc-16 -C Release -R example_roll_forming_springback_benchmark --output-on-failure
运行 V5.7 cohesive 单积分点验收:
ctest --test-dir build-win-gcc-16 -C Release -R cohesive_contact --output-on-failure
运行 V5.7 ball adhesion cohesive benchmark:
ctest --test-dir build-win-gcc-16 -C Release -R example_ball_adhesion_cohesive_benchmark --output-on-failure
运行 V5.8 particle acceptance primitives:
ctest --test-dir build-win-gcc-16 -C Release -R particle_acceptance --output-on-failure
运行 V5.8 dynamic grain container particle benchmark:
ctest --test-dir build-win-gcc-16 -C Release -R example_dynamic_grain_container_benchmark --output-on-failure
0.4.8 本地记录:
- Windows GCC 16:V4.8 后硬化加入 GMRES、node analytical contact、P1 contact 性能 smoke,并补齐所有文档型 examples 目录后,当前 CTest 记录为 66/66 passed。
- WSL Ubuntu + gfortran 13.3:沿用第三版发布流程复测。
- Windows Intel oneAPI ifx 2026.0 + MSVC:沿用第三版发布流程复测。
V5 当前开发态记录:
- Windows GCC 16 Release:内部 solver 诊断、no-external-solver 回归、非匹配 two-block contact benchmark、大滑移摩擦 benchmark、shell-shell/shell-solid contact benchmark、Mohr-Coulomb 材料点验收、strength reduction benchmark、Euler column buckling benchmark、corrugated shell cyclic buckling benchmark、roll forming kinematics benchmark、roll forming springback benchmark、cohesive 单积分点验收、ball adhesion cohesive benchmark、particle acceptance primitives 和 dynamic grain container particle benchmark 已接入;
ctest --test-dir build-win-gcc-16 -C Release --output-on-failure记录为 106/106 passed。
12. 常见问题
-
程序只打印模型摘要,没有计算: 需要显式指定分析模式,例如
--run或--static-linear。 -
没有输出 VTK 或 CSV: 检查
--output-interval是否为 0,以及输入文件/控制参数是否启用输出。 -
输入 keyword 被 warning 跳过: FemLite 只支持 Abaqus inp 子集。不支持 keyword 会跳过,关键数据缺失才报错。
-
静力求解不收敛: 可先使用
--static-linear检查边界、载荷和材料,再检查约束不足、接触 penalty、材料非线性和载荷增量设置。 -
接触结果异常: 检查 slave/master surface、face label、法向方向、搜索距离、penalty 和是否存在初始穿透。
13. 当前限制
- 不完整兼容 Abaqus 全部 keyword。
*SURFACE已支持 element/node/analytical plane 子集,但尚不支持完整 Abaqus surface 语义。- 面-面接触已具备 mortar 权重、mortar 积分点摩擦历史、正则化摩擦、摩擦功输出、BVH 搜索、active set 和 pair 级 augmented penalty 诊断,但仍不是完整工程级 mortar 约束求解器。
- Mohr-Coulomb 当前已具备材料点返回映射、driver、活动集算法一致切线、强度折减参数折减基础和结构级边坡安全系数 benchmark;完整结构级自动 trial 重求解、非线性失稳判据和 PDF 位移/塑性云图复现仍在 V5.4 后续项中完善。
- 线性屈曲当前已具备小规模内部 dense 特征值求解、梁柱几何刚度、Euler 柱解析 benchmark 和波纹壳紧凑循环屈曲 benchmark;通用
*BUCKLINGstep、静力预载后的壳/实体几何刚度装配、完整壳 FE 波纹壳高保真模型和循环扇区约束接入主求解流程仍在 V5.5 后续项中完善。 - 滚压成形当前已具备刚体辊平移/下压/角速度运动学、角速度参与切向相对速度和正则化牵引的 benchmark,以及基于 J2 多层材料点的塑性成形/卸载回弹 benchmark;主求解器通用滚压成形 step、完整三维工件网格滚压和 restart 驱动多 step 工艺流仍在后续完善。
- 颗粒耦合当前已具备内置离散球颗粒、颗粒-facet 映射和动态柔性容器紧凑 benchmark;它不是工业规模 DEM 长跑,也不接入外部颗粒求解器。
- 非线性 Newmark-Newton 和复杂壳塑性仍需要更多工程基准和长时间稳定性验证。
- 大型工程算例的并行、内存和接触收敛策略仍需后续版本完善。