45 KiB
FEM 求解器手册
本文说明 M3Frame 中 FEM 求解器的标准配置方式、常用 XML 关键词、求解流程和验证建议。FEM 的公共入口主要包括:
fem/fem_solver_config.h:FEM 配置数据模型与读取入口。fem/fem_solver_config_io.h:XML/JSON/YAML 统一配置读入与execute_config(...)。fem/fem_solver_pipeline.h:FEM 仿真流程调度。fem/fem_solver.h:FEM 配置数据模型、共享类型和求解器依赖。
头文件职责建议保持分层:
| 文件 | 职责 | 建议使用方式 |
|---|---|---|
fem_solver_config.h |
用户侧统一入口,汇总关键词、pipeline 和配置读入能力。 | 示例程序、pipeline、外部调用优先包含这个文件。 |
fem_solver_config_io.h |
配置文件解析与 FEMSimulationDocument 映射实现。 |
FEM 内部维护使用,普通案例不需要直接包含。 |
fem_solver_keywords.h |
FEM 标准配置关键词常量。 | 需要生成或校验配置文件时使用。 |
fem_solver_pipeline.h |
FEMSimulationPipeline 的声明与实现,包括 build/execute、输出和监控流程。 |
调度层或高级接口使用。 |
fem_solver.h |
FEM 配置数据模型、共享类型和求解器依赖。 | 核心开发时使用,案例代码尽量通过 fem_solver_config.h 进入。 |
因此,fem_solver_config.h 和 fem_solver_config_io.h 不建议合并:前者保持轻量公共入口,后者保留较重的读写实现,便于后续继续支持 XML/JSON/YAML 和减少公共 API 的噪声。
推荐所有工程案例使用 pipeline.xml 串联几何、网格、材料、FEM 求解和后处理。单独调试 FEM 时,也可以直接调用 FEM 标准配置文件。
推荐案例结构
case/
pipeline.xml
config/
cad.xml
meshing.xml
fem_solver.xml
outputs/
典型 pipeline.xml:
<M3FramePipeline version="1.0" name="fem_case">
<Stages>
<Stage kind="geometry" path="config/cad.xml" />
<Stage kind="meshing" mesh_type="volume" path="config/meshing.xml" />
<Stage kind="solver" solver="fem" path="config/fem_solver.xml" />
</Stages>
</M3FramePipeline>
FEM 标准 XML 骨架
<M3FrameFEMSimulation version="1.0" name="uniaxial_tension" problem_type="standard">
<Mesh path="outputs/mesh.vtu" />
<MaterialLibrary path="material/builtin_materials.xml" />
<Material id="1" key="steel.linear_elastic" />
<NodeSet id="bottom" selector="plane" axis="z" side="min" tolerance="1e-8" />
<NodeSet id="top" selector="plane" axis="z" side="max" tolerance="1e-8" />
<Boundary name="bottom_fixed" type="fixed" node_set="bottom" />
<Boundary name="top_uz" type="prescribed_displacement" node_set="top" dof="uz" value="0.001" />
<Solver physics="solid"
kinematics="small_strain"
integration="gauss"
linear_solver="bicgstab"
linear_tolerance="1e-10"
nonlinear_tolerance="1e-8"
max_linear_iterations="1000"
max_nonlinear_iterations="20" />
<Control analysis="static" dt="1.0" steps="1" />
<Output directory="outputs/fem" prefix="uniaxial" pvd="uniaxial.pvd" output_interval="1" />
<Monitor enabled="true" log="outputs/fem/uniaxial.log"
reaction_balance="true"
residual_history="true"
min_jacobian="true" />
</M3FrameFEMSimulation>
根节点
根节点固定为:
<M3FrameFEMSimulation version="1.0" name="case_name" problem_type="standard">
常用属性:
| 属性 | 说明 |
|---|---|
name |
案例名称,用于日志和输出标识。 |
problem_type |
问题类型,默认 standard。多孔弹性专用流程使用 poro_elasticity 等可识别类型。 |
网格输入
<Mesh path="outputs/mesh.vtu" />
FEM 当前以 VTU 网格作为主要输入。网格应包含节点、单元拓扑,并建议包含:
material_id:材料编号。region_id:区域编号。boundary_id:边界编号,用于边界条件和载荷选择。
支持的主要单元拓扑:
| 类别 | 单元 |
|---|---|
| 实体 | tet4、hex8、wedge/wedge6、pyramid/pyramid5 |
| 面/壳/膜 | tri3、quad4 |
| 梁/索 | line2 |
| 点质量 | vertex/vertex1 |
材料设置
从材料库读取:
<MaterialLibrary path="material/builtin_materials.xml" />
<Material id="1" key="steel.linear_elastic" />
也可以直接在 FEM 文件中给出材料参数:
<Material id="1"
model="linear_elastic"
density="7850"
young_modulus="2.10e11"
poisson_ratio="0.30" />
常用属性:
| 属性 | 说明 |
|---|---|
id |
材料编号,网格 material_id 会与它关联。 |
key |
材料库中的可读键,例如 steel.linear_elastic、rubber.neo_hookean。 |
model |
直接指定材料模型,如 linear_elastic、neo_hookean、elastoplastic_damage、porous_elastoplastic_damage。 |
density |
密度。 |
young_modulus、poisson_ratio |
线弹性参数。 |
yield_stress、hardening_modulus |
弹塑性参数。 |
damage_threshold、damage_rate、max_damage |
损伤参数。 |
biot_coefficient、initial_porosity、permeability0、porosity_compressibility |
多孔介质参数。 |
材料库和材料模型的详细说明见 material_manual.md。
NodeSet 选择
NodeSet 用于把几何/网格上的节点选择成可复用集合。
<NodeSet id="left" selector="plane" axis="x" side="min" tolerance="1e-8" />
<NodeSet id="load_point" selector="nearest" x="1.0" y="0.0" z="0.0" />
<NodeSet id="explicit_nodes" selector="explicit" node_ids="0,1,2,3" />
<NodeSet id="wall_nodes" selector="boundary_id" boundary_id="2" />
常用属性:
| 属性 | 说明 |
|---|---|
id |
节点集合名称。 |
selector |
选择方式,常用 plane、nearest、explicit、boundary_id、all。 |
axis |
plane 选择用,可取 x、y、z。 |
side |
plane 选择用,当前源码按坐标极值面选择;min/lower 选最小坐标面,max/upper/top 选最大坐标面。 |
from |
nearest 选择可选父节点集,只在该节点集内部寻找最近点。 |
tolerance |
选择容差。 |
x、y、z |
最近点坐标。 |
node_ids |
显式节点列表,逗号分隔。 |
boundary_id |
按网格边界编号选择。 |
注意:当前 selector="plane" 不是按任意 value 坐标截面选点,而是选择指定轴向的最小或最大外边界面。如果需要任意内部截面,建议先在网格或后处理阶段生成显式节点列表,或后续扩展 NodeSet 选择器。
边界条件与载荷
边界条件使用 <Boundary>,接触也可以使用 <Contact>。
位移约束
<Boundary name="fixed_left" type="fixed" node_set="left" />
<Boundary name="top_uz" type="prescribed_displacement" node_set="top" dof="uz" value="0.001" />
支持自由度:
| 自由度 | 说明 |
|---|---|
ux、uy、uz |
平动自由度。 |
rx、ry、rz |
转角自由度,梁/壳/膜常用。 |
p 或 pore_pressure |
孔压自由度。 |
temperature |
温度自由度。 |
外力与体力
<Boundary name="tip_force" type="nodal_force" node_set="tip" fx="0" fy="0" fz="-100" />
<Boundary name="gravity" type="body_force" fx="0" fy="-9.81" fz="0" />
<Boundary name="pressure_face" type="surface_traction" boundary_id="5" fx="0" fy="0" fz="-1e5" />
孔压、温度和通量
<Boundary name="drained_top" type="prescribed_pore_pressure" node_set="top" dof="p" value="0" />
<Boundary name="fixed_temperature" type="prescribed_temperature" node_set="left" value="293.15" />
<Boundary name="fluid_flux" type="flux" boundary_id="3" value="1e-6" />
对称边界、MPC 与刚体参考点
<Boundary name="sym_x" type="symmetry_plane" node_set="xmin" dof="ux" />
<Boundary name="slave_tracks_master"
type="mpc"
node_ids="12"
master_node="3"
dof="ux"
slave_coefficient="1.0"
master_coefficient="-1.0" />
<Boundary name="rigid_face"
type="rigid_reference_point"
node_set="rigid_surface"
reference_node="0" />
梁、索、壳和膜截面
梁单元和索单元使用 line2 网格,通过 <BeamSection> 控制截面:
<BeamSection line2_element="beam"
area="1.0e-4"
iy="8.33e-10"
iz="8.33e-10"
j="1.67e-9" />
索/缆网:
<BeamSection line2_element="cable"
cable_area="1.0e-4"
cable_initial_tension="100"
cable_tension_only="true" />
壳/膜单元通过 <ShellSection> 控制厚度和剪切修正:
<ShellSection thickness="0.01"
shear_correction="0.8333333333"
shear_scale="1.0"
drilling_stiffness_ratio="1e-3" />
求解器设置
<Solver> 控制物理场、运动学、积分、线性求解器、非线性迭代和稳定化选项。
<Solver physics="solid"
kinematics="small_strain"
integration="gauss"
linear_solver="bicgstab"
linear_tolerance="1e-10"
nonlinear_tolerance="1e-8"
max_linear_iterations="1000"
max_nonlinear_iterations="20"
line_search="true" />
物理场
physics |
说明 |
|---|---|
solid |
固体力学,默认。 |
poromechanics |
位移-孔压耦合。 |
thermal_solid |
热-固体相关自由度。 |
运动学
kinematics |
说明 |
|---|---|
small_strain |
小应变。 |
total_lagrangian |
Total Lagrangian 大变形。 |
updated_lagrangian |
Updated Lagrangian 大变形。 |
单元积分
integration |
说明 |
|---|---|
gauss |
Gauss 积分,默认。 |
lagrange、nodal |
Lagrange/节点积分。 |
reduced |
减缩积分。 |
线性求解器
linear_solver |
说明 |
|---|---|
bicgstab |
默认迭代求解器。 |
cg 或 conjugate_gradient |
共轭梯度。 |
jacobi |
Jacobi 迭代。 |
gauss_seidel |
Gauss-Seidel 迭代。 |
静力学、准静态和动力学
<Control> 控制时间步和求解类型:
<Control analysis="static" dt="1.0" steps="1" />
analysis |
说明 |
|---|---|
static |
静力学或准静态单步加载。 |
quasi_static |
多步准静态加载。 |
implicit_dynamic |
隐式动力学。 |
explicit_dynamic |
显式动力学。 |
隐式动力学:Newmark-beta
<Control analysis="implicit_dynamic"
time_integration="newmark_beta"
newmark_scheme="average_acceleration"
newmark_beta="0.25"
newmark_gamma="0.5"
dt="1.0e-4"
steps="1000" />
隐式动力学:广义 alpha
<Control analysis="implicit_dynamic"
time_integration="generalized_alpha"
spectral_radius_infinity="0.8"
dt="1.0e-4"
steps="1000" />
也可以显式给出:
<Control time_integration="generalized_alpha"
generalized_alpha_m="0.0"
generalized_alpha_f="0.3333333333"
newmark_beta="0.4444444444"
newmark_gamma="0.8333333333" />
显式动力学:velocity-Verlet
<Control analysis="explicit_dynamic"
time_integration="velocity_verlet"
adaptive_time_step="true"
time_step_safety="0.8"
min_dt="1e-8"
max_dt="1e-5"
dt="1e-6"
steps="10000" />
非线性控制
强非线性问题建议启用 line search、加载步自动缩减和位移增量限制:
<Solver line_search="true"
line_search_damping="1.0"
line_search_min_damping="1e-4"
line_search_reduction="0.5"
max_line_search_iterations="10"
energy_convergence="true"
energy_tolerance="1e-10" />
<Control load_step_cutback="true"
load_step_cutback_factor="0.5"
load_step_min_dt="1e-8"
max_load_step_cutbacks="8"
displacement_increment_limit="true"
max_displacement_increment="1e-3" />
说明:
nonlinear_tolerance控制残差收敛。energy_convergence和energy_tolerance启用能量收敛检查。line_search会与材料状态 commit/rollback 配合,避免失败迭代污染历史变量。load_step_cutback用于强非线性不收敛时自动减小加载步。
稳定性与锁定控制
<Solver shear_locking_control="true"
shear_locking_scale="0.5"
volumetric_locking_control="true"
volumetric_locking_factor="0.25"
hourglass_control="true"
hourglass_stiffness="0.05"
bbar_method="true"
fbar_method="false"
eas_method="false"
eas_stabilization="0.2"
ans_method="true"
ans_shear_scale="0.5" />
建议:
| 问题 | 建议 |
|---|---|
| 近不可压材料 | 优先考虑 bbar_method 或 fbar_method。 |
| 壳/板剪切锁定 | 使用 ans_method、eas_method 或剪切锁定控制。 |
| 减缩积分 hourglass | 启用 hourglass_control。 |
| 大变形畸变 | 启用网格质量和 Jacobian 监测。 |
网格质量和畸变检测
<Solver mesh_quality_check="true"
distortion_check="true"
stop_on_distortion="true"
min_cell_measure="1e-12"
max_aspect_ratio="100"
min_detF="1e-8" />
其中:
mesh_quality_check在初始网格读入后检查质量。distortion_check在计算过程中检查单元畸变。min_detF用于大变形计算中的变形梯度行列式下限。stop_on_distortion=true时发现严重畸变会终止计算。
接触设置
节点-面、面-面、双向接触、摩擦、接触阻尼和 mortar 接触可通过 <Contact> 和 <Solver> 共同控制。
<Contact name="ball_floor"
type="contact"
slave_boundary_id="10"
master_boundary_id="20"
penalty="1e7"
friction_coefficient="0.2"
contact_damping="10"
use_mortar="false" />
<Solver contact_penalty="1e7"
contact_tolerance="1e-5"
contact_search_radius="0.02"
friction_coefficient="0.2"
tangential_penalty_ratio="0.1"
enable_contact_damping="true"
contact_damping="10"
contact_tangential_damping_ratio="0.2"
enable_contact_spatial_search="true"
enable_contact_auto_match="true"
enable_bidirectional_contact="true"
enable_mortar_contact="false"
mortar_integration_order="2"
enable_augmented_lagrangian_contact="false" />
接触建议:
- 简单碰撞可先用 penalty 接触。
- 大滑移问题启用
enable_contact_spatial_search。 - 主从面不易手动指定时启用
enable_contact_auto_match。 - 接触振荡明显时启用
enable_contact_damping。 - 工程级面-面压力分布测试可启用 mortar 接触,但应先用接触 benchmark 校验。
OpenMP 与 CUDA
CPU 多线程:
<Solver backend="openmp"
openmp="true"
openmp_threads="4" />
CUDA:
<Solver backend="cuda"
cuda_device="0"
cuda_explicit_dynamics="true"
cuda_tet4_internal_force="true"
cuda_tet4_material_update="true"
cuda_contact_search="true"
cuda_contact_force_scatter="true"
cuda_global_system_cache="true"
cuda_sparse_solver="true" />
CUDA 适合显式动力学、大量 Tet4、接触搜索和大规模稀疏线性代数。对于复杂梁壳、强非线性接触、材料路径相关问题,建议先用 CPU/OpenMP 与 CUDA 做小规模一致性测试。
输出与监控
<Output directory="outputs/fem"
prefix="case"
pvd="case.pvd"
output_interval="10" />
<Monitor enabled="true"
log="outputs/fem/case.log"
interval="1"
reaction_balance="true"
energy_balance="true"
momentum_conservation="true"
mass_conservation="true"
residual_history="true"
max_kinematics="true"
min_jacobian="true"
contact_penetration="true"
material_history="true" />
输出建议:
- 场变量使用 VTU/PVD。
- 时间历程、反力、能量、误差指标使用 CSV。
- 日志同时用于命令行进度和
log文件保存。
常见输出内容包括:
- 位移、速度、加速度。
- 应力、应变、von Mises、主应力。
- 反力、外力功、应变能、动能。
- 孔压、孔隙率、渗透率。
- 接触穿透量、接触力。
- 材料损伤变量和等效塑性应变。
多孔弹性与孔压耦合
多孔介质问题使用:
<M3FrameFEMSimulation name="poro_case" problem_type="poro_elasticity">
<Mesh path="outputs/poro_mesh.vtu" />
<Material id="6" key="soil.porous_elastoplastic_damage" />
<Solver physics="poromechanics"
kinematics="small_strain"
linear_solver="bicgstab" />
<Boundary name="drained_top" type="prescribed_pore_pressure" node_set="top" dof="p" value="0" />
<Control dt="100.0" steps="100" />
</M3FrameFEMSimulation>
多孔介质相关材料参数包括:
biot_coefficientinitial_porositypermeability0porosity_compressibility
典型验证包括 Terzaghi 一维固结、排水/不排水压缩、位移-孔压 patch test。
后处理
FEM 后处理入口为 fem/fem_post.h。常用任务:
- 反力按边界汇总。
- 应变能密度、外力功和内能平衡检查。
- von Mises 与主应力输出。
- Patch test 误差汇总。
- CSV 时间历程输出。
后处理配置建议单独放在 config/post.xml,由 pipeline 的 post stage 或 benchmark 程序调用。
常见问题
线性问题没有一步收敛
检查:
- 约束是否足以消除刚体模态。
- 载荷单位和材料刚度是否量级合理。
- 网格是否存在负体积、退化单元或错误节点顺序。
linear_solver、linear_tolerance和max_linear_iterations是否足够。
大变形计算发散
检查:
- 是否启用合适的
kinematics。 min_detF是否过小或单元严重畸变。- 材料切线是否适配当前大变形模型。
- 是否需要
line_search、load_step_cutback和max_displacement_increment。
接触穿透明显
检查:
contact_penalty是否过小。contact_search_radius是否覆盖可能接触距离。- 主从面方向、边界编号和法向是否正确。
- 显式动力学中时间步是否过大。
- 是否需要接触阻尼或双向接触。
动力学结果振荡过强
检查:
- 时间步是否满足稳定性要求。
- 是否需要 Rayleigh 阻尼:
rayleigh_alpha、rayleigh_beta。 - 隐式动力学可考虑
generalized_alpha。 - 显式动力学可启用
adaptive_time_step。
推荐验证顺序
- Tet4/Hex8 patch test。
- Tri3/Quad4 patch test。
- 单轴拉伸/压缩。
- 梁拉伸、弯曲、扭转。
- 壳/板膜内拉伸、纯弯曲、剪切锁定测试。
- 体力、面力积分和反力平衡。
- MPC、刚体参考点和 NodeSet 选择测试。
- J2 弹塑性、损伤、卸载/循环加载材料路径测试。
- Total Lagrangian / Updated Lagrangian 大变形测试。
- 无摩擦、库仑摩擦、Hertz、mortar 和大滑移接触测试。
- 多孔弹性和渗流-变形耦合 patch test。
- 工程级网格收敛和畸变鲁棒性测试。
求解模式选择建议
| 目标问题 | 推荐 analysis |
推荐 time_integration |
说明 |
|---|---|---|---|
| 小变形线弹性静力 | static |
可省略 | 最简单,优先用于 patch test、单轴拉伸、受压块。 |
| 接触或材料非线性准静态 | quasi_static |
可省略 | 建议启用 line_search、load_step_cutback 和 energy_convergence。 |
| 低频结构瞬态 | implicit_dynamic |
newmark_beta |
平均加速度法稳定,适合较大时间步。 |
| 需要数值高频耗散 | implicit_dynamic |
generalized_alpha |
通过 spectral_radius_infinity 控制高频耗散。 |
| 冲击、碰撞、自由落体 | explicit_dynamic |
velocity_verlet |
建议启用 adaptive_time_step,严格控制接触刚度和时间步。 |
| 多孔介质固结 | quasi_static 或专用 poro_elasticity |
视案例而定 | 需要孔压边界、Biot 系数、渗透率和储水项。 |
一般顺序是先用静力或准静态做同一网格的基准验证,再切换到动力学。如果动力学结果异常,优先检查质量矩阵、初始速度、阻尼、时间步和接触参数。
标准 FEM XML 检查清单
提交计算前建议逐项检查:
Mesh path是否存在,且 VTU 能正常读入。- 网格是否包含正确的
material_id、region_id、boundary_id。 <Material>的id是否与网格material_id匹配。NodeSet是否能选中预期节点,特别是平面容差tolerance。- 位移约束是否足以消除刚体模态。
- 载荷方向和单位是否与模型坐标系一致。
- 大变形问题是否设置了
kinematics="total_lagrangian"或updated_lagrangian。 - 动力学问题是否给出了合理的
density、dt、steps和初始条件。 - 接触问题是否设置了合理的
contact_search_radius和contact_penalty。 - 输出目录是否与案例目录一致,避免写到旧路径。
推荐最小 FEM 配置由以下标签组成:
<M3FrameFEMSimulation name="case" problem_type="standard">
<Mesh path="outputs/mesh.vtu" />
<MaterialLibrary path="material/builtin_materials.xml" />
<Material id="1" key="steel.linear_elastic" />
<NodeSet id="fixed" selector="plane" axis="x" value="0" tolerance="1e-8" />
<Boundary name="fixed" type="fixed" node_set="fixed" />
<Solver physics="solid" kinematics="small_strain" linear_solver="bicgstab" />
<Control analysis="static" dt="1" steps="1" />
<Output directory="outputs/fem" prefix="case" pvd="case.pvd" />
</M3FrameFEMSimulation>
时间积分参数速查
Newmark-beta
平均加速度法:
<Control analysis="implicit_dynamic"
time_integration="newmark_beta"
newmark_scheme="average_acceleration"
dt="1e-4"
steps="1000" />
适用场景:
- 结构低频响应。
- 需要比显式动力学更大时间步。
- 接触不太剧烈的隐式动力学。
广义 alpha
<Control analysis="implicit_dynamic"
time_integration="generalized_alpha"
spectral_radius_infinity="0.7"
dt="1e-4"
steps="1000" />
建议:
spectral_radius_infinity越小,高频耗散越强。- 若位移响应被过度平滑,可增大到
0.8到1.0。 - 若高频振荡明显,可降低到
0.5到0.8。
Velocity-Verlet
<Control analysis="explicit_dynamic"
time_integration="velocity_verlet"
adaptive_time_step="true"
time_step_safety="0.8"
min_dt="1e-8"
max_dt="1e-5"
dt="1e-6"
steps="10000" />
建议:
- 显式动力学时间步应由单元尺寸、材料波速和接触刚度共同约束。
- 接触 penalty 太大时会显著降低稳定时间步。
- 结果出现穿透或能量爆炸时,优先减小
dt或开启adaptive_time_step。
载荷和边界的建模建议
位移边界
优先使用 NodeSet,避免直接在 XML 中写大量 node_ids:
<NodeSet id="left" selector="plane" axis="x" value="0.0" tolerance="1e-8" />
<Boundary name="left_fixed" type="fixed" node_set="left" />
直接指定节点只适合很小的单元测试:
<Boundary name="node_0_fixed" type="fixed" node_ids="0" />
面力和压力
均布面力建议通过 boundary_id 或 face_ids 施加:
<Boundary name="top_pressure"
type="surface_traction"
boundary_id="3"
fx="0"
fy="0"
fz="-1e5" />
曲面内压/外压可使用 RadialPressure:
<RadialPressure name="inner_pressure"
boundary_id="10"
pressure="1e6"
direction="outward"
cx="0"
cy="0"
cz="0"
axis="z" />
体力
重力可以用 body_force:
<Boundary name="gravity" type="body_force" fx="0" fy="-9.81" fz="0" />
体力方向与单位要和几何长度单位、密度单位保持一致。如果几何使用米、密度使用 kg/m^3,重力用 m/s^2。
接触参数调试顺序
接触问题建议按以下顺序调试:
- 先关闭摩擦,只保留无摩擦法向 penalty 接触。
- 选择较小时间步或准静态加载,确认不会发生明显穿透。
- 调整
contact_penalty,使穿透量可接受且不导致迭代发散。 - 设置
contact_search_radius覆盖可能的接触距离。 - 启用
enable_contact_spatial_search改善大模型接触搜索效率。 - 再启用
friction_coefficient、tangential_penalty_ratio。 - 动力学碰撞中启用
enable_contact_damping,减少非物理反弹。 - 面-面压力分布敏感时,再考虑
enable_mortar_contact。
接触常用组合:
<Solver contact_penalty="1e7"
contact_search_radius="0.02"
enable_contact_spatial_search="true"
enable_bidirectional_contact="true"
friction_coefficient="0.0"
enable_contact_damping="true"
contact_damping="5.0" />
大变形建模建议
小应变、大变形 Total Lagrangian 和 Updated Lagrangian 的适用范围不同:
| 运动学 | 适用场景 | 应力度量 |
|---|---|---|
small_strain |
小变形、小转动 | 小应变应力。 |
total_lagrangian |
参考构型清晰、网格不频繁更新 | Green-Lagrange 应变、Second Piola-Kirchhoff 应力。 |
updated_lagrangian |
当前构型主导、接触和大位移更明显 | 当前构型应变、Cauchy 应力。 |
示例:
<Solver physics="solid"
kinematics="total_lagrangian"
line_search="true"
energy_convergence="true"
mesh_quality_check="true"
distortion_check="true"
min_detF="0.2" />
大变形问题建议同时输出:
current_positionreference_position- 应力/应变张量
von_misesprincipal_stressstrain_energy_densitydetF或 Jacobian 监控日志
多孔介质配置建议
多孔介质算例需要同时检查固体骨架和孔压自由度:
<M3FrameFEMSimulation name="poro_patch" problem_type="poro_elasticity">
<Mesh path="outputs/poro_mesh.vtu" />
<Material id="6"
model="porous_elastoplastic_damage"
young_modulus="5e7"
poisson_ratio="0.3"
density="1800"
biot_coefficient="1.0"
initial_porosity="0.35"
permeability0="1e-12"
porosity_compressibility="1e-9" />
<Solver physics="poromechanics" linear_solver="bicgstab" />
<Boundary name="top_drained" type="prescribed_pore_pressure" node_set="top" dof="p" value="0" />
<Control analysis="quasi_static" dt="100" steps="100" />
</M3FrameFEMSimulation>
建议先运行:
- 一维固结。
- 排水/不排水压缩。
- 位移-孔压 patch test。
- 多孔弹塑性压缩。
确认孔压边界、Biot 系数、渗透率演化和块矩阵装配正确后,再进入复杂工程模型。
输出字段和后处理建议
VTU/PVD 用于空间场,CSV 用于时间历程。
推荐 VTU 字段:
| 字段 | 位置 | 用途 |
|---|---|---|
displacement |
PointData | 位移。 |
velocity |
PointData | 动力学速度。 |
acceleration |
PointData | 动力学加速度。 |
external_force |
PointData | 外力。 |
internal_force |
PointData | 内力。 |
reaction_force |
PointData | 反力。 |
stress |
CellData | 单元平均应力。 |
strain |
CellData | 单元平均应变。 |
von_mises |
CellData | 等效应力。 |
principal_stress |
CellData | 主应力。 |
strain_energy_density |
CellData | 应变能密度。 |
damage |
CellData | 损伤变量。 |
equivalent_plastic_strain |
CellData | 等效塑性应变。 |
pore_pressure |
PointData 或 CellData | 孔压。 |
推荐 CSV 文件:
reaction_report.csv:按边界汇总反力。energy_report.csv:外力功、内能、动能和能量误差。convergence_report.csv:每步 Newton 残差和能量范数。contact_report.csv:最大穿透、接触力和活动接触数。material_history_report.csv:最大损伤、平均损伤、最大塑性应变。
后处理配置入口
fem/fem_post.h 提供 FEMPostProcessor::execute_config(...)。该入口会根据根标签、type 属性或 <PostProcess>/<Task> 自动识别后处理任务。它适合 benchmark 和结果复核,不建议把几何建模、网格划分和 FEM 求解都塞进后处理文件中;常规工程流程仍应由 pipeline.xml 串联 CAD、meshing、FEM solver 和 post。
源码当前可识别的后处理任务包括:
| 任务 | 可识别名称 | 主要用途 |
|---|---|---|
| von Mises/主应力 | mises_principal_stress、mises_principal、principal_stress、von_mises |
检查应力不变量和主应力输出。 |
| 能量平衡 | energy_balance、energy、post_energy_test、strain_energy |
输出应变能、外力功、内能平衡误差。 |
| 边界反力 | boundary_reaction、reaction_force |
按边界汇总反力和力矩。 |
| Patch test | patch_test |
Tet4/Hex8/Tri3/Quad4 等单元的常应变或线性位移场验证。 |
后处理会向 VTU 中追加:
- 点场:
displacement、velocity、acceleration、external_force、internal_force、reaction_force、reaction_moment。 - 单元场:
stress、strain、von_mises、principal_stress_1/2/3、strain_energy_density。
边界反力 CSV 推荐格式由 io::ReactionHistoryCSV 统一输出,适合后续画时间历程曲线或做解析解对比。
Solver 高级参数补充
以下参数在源码中已经由 <Solver> 或 <Control> 读取,适合在非线性、动力学和点质量问题中使用:
| 参数 | 说明 |
|---|---|
default_density 或 density |
没有从材料中取得密度时的默认密度。 |
point_mass 或 mass |
vertex/vertex1 点质量单元的默认质量。 |
rayleigh_alpha、rayleigh_beta |
Rayleigh 阻尼系数,阻尼矩阵近似为 alpha*M + beta*K。 |
line_search_damping |
初始 line search 阻尼系数。 |
line_search_min_damping |
line search 最小可接受阻尼。 |
line_search_reduction |
每次回溯时的阻尼缩减比例。 |
line_search_sufficient_decrease |
充分下降判据参数。 |
max_line_search_iterations |
每个 Newton 迭代内最大 line search 次数。 |
thermal_conductivity、heat_capacity、thermal_source |
physics="thermal_solid" 路径中的热传导、热容和热源参数。 |
动力学中建议同时设置材料密度或 default_density。如果质量矩阵过小或缺失,显式动力学的稳定时间步和加速度都会变得不可信。
示例案例索引
常用 FEM 示例位于 examples/fem:
| 目录 | 用途 |
|---|---|
uniaxial_loading |
单轴拉伸/压缩基础验证。 |
tet4_patch_test、hex8_patch_test |
实体单元 patch test。 |
tri3_quad4_patch_test |
二维退化或板壳基础验证。 |
beam、beam_concentrated_force、beam_moment |
梁单元轴拉、弯曲、扭转和解析解对比。 |
shell |
壳/板膜内、弯曲和剪切锁定测试。 |
cube_press |
均匀压缩和反力检查。 |
surface_integrate_test、body_force_test |
面力和体力积分验证。 |
boundary_test、nodeset_pick_test、mpc_test、rigid_body |
约束系统验证。 |
cnt_* |
接触、摩擦、mortar、大滑移和 Hertz 接触验证。 |
material_* |
材料路径、泊松比、近不可压、J2、DP、损伤测试。 |
ld_* |
大变形、TL/UL、超弹性和刚体旋转测试。 |
poro_* |
多孔弹性和渗流-变形耦合测试。 |
solver_* |
线性求解器、Newton、line search、rollback 和奇异约束测试。 |
mesh_* |
网格收敛、贴体性、Tet4/Hex8 对比和畸变鲁棒性测试。 |
从失败计算中定位问题
建议按以下顺序排查:
- 查看 log 中的
step/time/dt,确认计算是否真正推进。 - 查看
residual_history,判断是线性求解失败还是非线性迭代失败。 - 查看
min_jacobian,确认是否有单元翻转或严重畸变。 - 查看
reaction_balance,确认约束反力与外载是否平衡。 - 查看
energy_balance,确认动力学或接触问题中能量是否爆炸。 - 查看
contact_penetration,确认穿透是否发生在接触搜索半径之外。 - 查看材料历史变量,确认损伤或塑性变量是否异常跳变。
- 在 ParaView 中按
material_id、region_id、boundary_id着色,确认网格分组正确。
如果一个工程算例不稳定,应先构造同材料、同单元、同边界类型的小 benchmark,确认基础路径正确后再回到大模型。
源码对照:配置读入路径
当前 FEM 配置读入链路为:
fem_solver_config.h
-> fem_solver_config_io.h
-> io::ConfigIO::read(...)
-> FEMSimulationDocument
-> FEMSimulationPipeline::execute(...)
这意味着 XML、JSON、YAML 等格式最终都会先转为 io::ConfigDocument,再映射到 FEMSimulationDocument。用户侧建议只包含 fem/fem_solver_config.h,不要直接依赖旧的 fem_solver_xml.h 名称。
FEMSimulationDocument 中的主要字段和 XML 标签对应关系如下:
FEMSimulationDocument 字段 |
XML 标签/属性 | 说明 |
|---|---|---|
name |
<M3FrameFEMSimulation name="..."> |
案例名称。 |
problem_type |
<M3FrameFEMSimulation problem_type="..."> |
standard 或多孔介质专用流程。 |
mesh_path |
<Mesh path="..."/> |
VTU 网格输入。 |
material_config_path |
<MaterialLibrary path="..."/> |
材料库路径。 |
material_id/material_key/material_model |
<Material id="..." key="..." model="..."/> |
材料编号、材料库 key 或直接模型名。 |
node_sets |
<NodeSet .../> |
节点集定义。 |
boundaries |
<Boundary .../>、<Contact .../> |
约束、载荷和接触。 |
initial_conditions |
<InitialCondition .../> |
初始位移、速度、加速度、孔压、温度。 |
radial_pressures |
<RadialPressure .../> |
圆柱/球壳压力类解析测试辅助载荷。 |
affine_displacements |
<AffineDisplacement .../> |
patch test 中的线性位移场。 |
options |
<Solver .../>、<Control .../> |
求解器、时间积分、并行和稳定化参数。 |
output_* |
<Output .../> |
VTU/PVD 输出控制。 |
monitor |
<Monitor .../> |
命令行和 log 监控。 |
源码支持的枚举值
物理场和运动学
| 参数 | 支持值 | 源码映射 |
|---|---|---|
physics |
solid、poromechanics、thermal_solid |
FEMPhysics。 |
kinematics |
small_strain、updated_lagrangian、total_lagrangian |
FEMKinematics。 |
integration / element_integration |
gauss、lagrange、langrange、nodal、reduced、reduced_integration |
FEMElementIntegrationRule。 |
linear_solver |
jacobi、gauss_seidel、cg/conjugate_gradient、bicgstab |
FEMLinearSolverType。 |
backend |
cpu、serial、openmp、cuda、gpu |
FEMExecutionBackend。 |
lagrange 和历史拼写 langrange 都会被接受。对于工程配置,建议统一写 lagrange。
分析类型和时间积分
| 参数 | 支持值/别名 | 行为 |
|---|---|---|
analysis |
static、quasi_static、quasi-static、quasistatic |
准静态或静力流程。 |
analysis |
dynamic、transient、implicit_dynamic、newmark、generalized_alpha、velocity_verlet |
动力学流程。 |
dynamics_solver / solver_type |
implicit、implicit_dynamic |
隐式动力学。 |
dynamics_solver / solver_type |
explicit、explicit_dynamic |
显式动力学。 |
time_integration |
newmark |
隐式 Newmark。 |
time_integration |
generalized_alpha、generalized-alpha |
广义 alpha。 |
time_integration |
velocity_verlet、velocity-verlet、verlet |
显式 Velocity-Verlet。 |
默认约定是:隐式动力学使用 Newmark,显式动力学使用 Velocity-Verlet。若给出 spectral_radius_infinity、generalized_alpha_m 或 generalized_alpha_f,会自动切换到广义 alpha。
自由度和边界类型
| 参数 | 支持值 |
|---|---|
dof |
ux、uy、uz、rx、ry、rz、p/pore_pressure、T/temperature |
Boundary type |
fixed、prescribed_displacement、prescribed_pore_pressure、prescribed_temperature、temperature、nodal_force、surface_traction、body_force、flux、contact、symmetry、symmetry_plane、mpc、multi_point_constraint、rigid_reference、rigid_reference_point |
Contact |
<Contact .../> 会强制作为接触边界处理,也可用 <Boundary type="contact" .../> |
<InitialCondition> 支持字段
InitialCondition 会根据 field 或 field_name 选择变量:
field 值 |
内部字段 |
|---|---|
u、displacement、disp |
位移 |
v、velocity、vel |
速度 |
a、acceleration、accel |
加速度 |
p、pressure、pore_pressure |
孔压 |
temperature、temp、t |
温度 |
向量型初值可使用 x/y/z,也可使用更具体的 ux/uy/uz、vx/vy/vz、ax/ay/az。标量型初值使用 value。region_id 或 region 小于 0 时作用于全域,否则只作用于对应区域。
示例:
<InitialCondition field="velocity" vx="0" vy="-1.0" vz="0" />
<InitialCondition field="pore_pressure" value="100000" region_id="2" />
<AffineDisplacement> 和 <RadialPressure>
这两个标签主要服务于 patch test、圆筒/球壳压力等 benchmark。
AffineDisplacement 支持:
<AffineDisplacement name="linear_field"
node_set="all_nodes"
ux0="0" uy0="0" uz0="0"
ux_x="0.01" ux_y="0" ux_z="0"
uy_x="0" uy_y="-0.003" uy_z="0"
uz_x="0" uz_y="0" uz_z="-0.003" />
RadialPressure 支持:
<RadialPressure name="inner_pressure"
boundary_id="2"
pressure="1.0e6"
direction="outward"
cx="0" cy="0" cz="0"
axis="z" />
其中 direction 用于控制径向压力方向,center 和 axis 用于确定径向方向。
截面与单元族
line2 网格默认按梁单元处理,可通过 <BeamSection line2_element="cable"> 切换为索/桁架类单元。
| 标签/属性 | 说明 |
|---|---|
<BeamSection line2_element="beam"> |
Euler-Bernoulli/Timoshenko 风格的工程梁路径,使用平动和转角自由度。 |
<BeamSection line2_element="cable"> |
Cable/truss 路径,主要使用平动自由度,可设置仅受拉。 |
area、iy、iz、j |
梁截面积、惯性矩和扭转常数。 |
cable_area、cable_initial_tension、cable_tension_only |
索单元面积、初拉力和仅受拉开关。 |
<ShellSection thickness="..."> |
壳/膜厚度。 |
shear_correction、shear_scale |
壳剪切修正。 |
drilling_stiffness_ratio |
壳 drilling DOF 稳定化刚度比例。 |
实体单元包括 Tet4、Hex8、Wedge6、Pyramid5;面单元包括 Tri3、Quad4;点质量使用 Vertex1。网格 XML 中可写 wedge/pyramid/vertex,进入 FEM 后会归一为 Wedge6、Pyramid5、Vertex1。
稳定化和单元质量检查
<Solver> 中的稳定化和质量检查参数如下:
| 参数 | 作用 |
|---|---|
shear_locking_control、shear_locking_scale |
剪切锁定缓解,主要用于壳/梁/低阶单元。 |
volumetric_locking_control、volumetric_locking_factor |
体积锁定缓解。 |
hourglass_control、hourglass_stiffness |
减缩积分或低阶单元的 hourglass 控制。 |
bbar_method |
B-bar 体积应变投影路径。 |
fbar_method |
F-bar 大变形体积修正路径。 |
eas_method、eas_stabilization |
EAS 增强假定应变路径。 |
ans_method、ans_shear_scale |
ANS 假定自然应变路径。 |
mesh_quality_check |
求解前网格质量检查。 |
distortion_check、stop_on_distortion |
计算过程中畸变检查和是否遇到畸变立即停止。 |
min_cell_measure |
最小单元体积/面积/长度阈值。 |
max_aspect_ratio |
最大长宽比阈值;为 0 时通常不启用该限制。 |
min_detF |
大变形最小 det(F) 阈值。 |
建议:先打开 mesh_quality_check 和 distortion_check,确认模型稳定后,再逐步测试 B-bar/F-bar/EAS/ANS 等稳定化选项对结果的影响。
CUDA 参数总表
CUDA 后端通过 <Solver backend="cuda"> 开启,细分功能可单独控制:
| 参数 | 说明 |
|---|---|
cuda_device |
CUDA 设备编号。 |
cuda_explicit_dynamics 或 cuda_velocity_verlet |
显式动力学 Velocity-Verlet 路径 GPU 化。 |
cuda_tet4_internal_force |
Tet4 内力 GPU 路径。 |
cuda_tet4_material_update |
Tet4 材料更新 GPU 路径。 |
cuda_structural_elements |
梁/壳/膜结构单元的 CUDA 路径。 |
cuda_high_fidelity_element_assembly |
更接近 CPU 单元公式的高保真装配路径。 |
cuda_poromechanics_blocks |
位移-孔压块矩阵和渗流项 CUDA 路径。 |
cuda_thermal_blocks |
热传导块 CUDA 路径。 |
cuda_contact_search |
接触搜索 CUDA 路径。 |
cuda_contact_force_scatter |
接触力 scatter CUDA 路径。 |
cuda_global_system_cache 或 cuda_resident_global_system |
全局矩阵/向量 GPU 常驻缓存。 |
cuda_sparse_solver 或 cuda_linear_solver |
稀疏线性求解器 CUDA 路径。 |
cuda_sparse_jacobi_solver |
CUDA Jacobi 迭代路径。 |
工程建议:CUDA 计算应先在小网格上和 CPU/OpenMP 做位移、内力、能量、接触穿透量的一致性对比,再用于大规模计算。
多孔弹性专用配置标签
当根节点设置 problem_type="poro_elasticity" 时,FEMSimulationPipeline::execute_config(...) 会进入多孔弹性专用流程。源码支持以下专用标签:
| 标签 | 主要属性 | 说明 |
|---|---|---|
<Layer> |
height、drainage |
固结层厚度和排水条件。 |
<Material> |
coefficient_of_consolidation、constrained_modulus、initial_excess_pore_pressure、biot_coefficient、fluid_bulk_modulus、porosity、storage_coefficient、hydraulic_conductivity |
多孔介质解析/半解析测试参数。 |
<Series> |
terms |
Terzaghi 级数项数。 |
<Time> |
value |
输出或采样时间。 |
<Depth> |
value |
孔压采样深度。 |
<Compression> |
type、height、applied_total_stress、drained_pore_pressure |
排水/不排水压缩测试。 |
<PatchTest> |
type、displacement_gradient、pressure_gradient |
位移-孔压块矩阵 patch test。 |
<ElastoPlasticCompression> |
type、final_axial_strain、final_pore_pressure、steps |
多孔弹塑性压缩测试。 |
<Checks> |
monotonic_tolerance、drained_pressure_tolerance、final_degree_min、block_tolerance 等 |
自动验证阈值。 |
<Visualization> |
depth_samples |
一维孔压剖面 VTU 采样点数。 |
<Output> |
report |
CSV 报告路径。 |
type 常用值包括 drained_undrained_compression、coupled_patch_test、poro_patch_test、poro_elasto_plasticity、poro_elastoplasticity。
配置文件最小模板
静力/准静态最小模板:
<M3FrameFEMSimulation name="minimum_static" problem_type="standard">
<Mesh path="outputs/mesh.vtu" />
<MaterialLibrary path="material/builtin_materials.xml" />
<Material id="1" key="steel.linear_elastic" />
<NodeSet id="fixed" selector="plane" axis="x" side="min" />
<Boundary name="fixed" type="fixed" node_set="fixed" />
<Solver physics="solid" kinematics="small_strain" linear_solver="bicgstab" />
<Control analysis="static" dt="1.0" steps="1" />
<Output directory="outputs/fem" prefix="minimum_static" pvd="minimum_static.pvd" />
</M3FrameFEMSimulation>
显式动力学最小模板:
<M3FrameFEMSimulation name="minimum_explicit" problem_type="standard">
<Mesh path="outputs/mesh.vtu" />
<Material id="1" model="neo_hookean" density="1100" young_modulus="1.0e6" poisson_ratio="0.45" />
<Solver physics="solid"
kinematics="updated_lagrangian"
analysis="explicit_dynamic"
dynamics_solver="explicit"
time_integration="velocity_verlet"
adaptive_time_step="true"
time_step_safety="0.7" />
<InitialCondition field="velocity" vx="0" vy="-1" vz="0" />
<Boundary name="gravity" type="body_force" fx="0" fy="-9.81" fz="0" />
<Control analysis="explicit_dynamic" dt="1.0e-6" steps="1000" />
<Output directory="outputs/fem" prefix="minimum_explicit" pvd="minimum_explicit.pvd" output_interval="10" />
<Monitor enabled="true" log="outputs/fem/minimum_explicit.log"
max_kinematics="true" energy_balance="true" min_jacobian="true" />
</M3FrameFEMSimulation>