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

40 KiB
Raw Blame History

FEM Mathematical Model and Algorithms

文档状态:算法基线草稿

适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序

1. 文档目的

本文档说明软件采用的控制方程、空间离散、时间积分、材料算法、失效删除、载荷映射、SPH-FEM 耦合和数值稳定性算法。

本文档用于约束后续 Fortran95 实现和验证算例设计。

2. 算法范围

第一版必须支持:

  • 显式瞬态动力学。
  • Updated Lagrangian 大变形框架。
  • C3D4、C3D8、S4 单元。
  • Cauchy 应力。
  • Jaumann 客观应力率。
  • 小应变 J2 弹塑性。
  • 大变形 hypoelastic-plastic J2 弹塑性。
  • Johnson-Cook 流动应力。
  • 等效塑性应变阈值失效。
  • Johnson-Cook 损伤失效。
  • 单元删除。
  • 初始温度和绝热塑性温升。
  • 可选线性和二次 bulk viscosity。
  • SPH 压力、剪切力和节点力映射。

第二版应补充或形成最小可用框架:

  • 基础 penalty 接触算法。
  • 隐式线弹性小变形求解最小流程。
  • C3D10、C3D20、S3、S6、S8。

第三版应补充:

  • 线性静力学算法。
  • 非线性静力学 Newton-Raphson 算法。
  • 壳单元线性静力刚度。
  • 隐式 Newmark + Newton 非线性动力学算法。
  • Rayleigh 阻尼在隐式路径中的一致接入。
  • 通用接触搜索、节点-面接触和面-面接触框架。
  • 更完整的壳 hourglass 控制、drilling DOF 稳定和壳塑性路径。

3. 符号与约定

节点自由度:

1 UX
2 UY
3 UZ
4 RX
5 RY
6 RZ

应力、应变分量顺序:

1 XX / 11
2 YY / 22
3 ZZ / 33
4 XY / 12
5 XZ / 13
6 YZ / 23

剪切约定:

  • 应变向量采用工程剪切应变 gamma12、gamma13、gamma23。
  • 应力向量采用真实剪切应力 tau12、tau13、tau23。
  • 材料内部如需张量剪切应变,应显式执行 gamma_ij / 2 转换。

压力符号:

t = -p n

其中 n 为固体外法向,p > 0 表示受压,t 为作用在 FEM 边界上的面力向量。正应力仍采用受拉为正。

4. 控制方程

连续体动量方程:

div(sigma) + b = rho a

边界分解:

u = ubar on Gamma_u
t = tbar on Gamma_t
t = -p n + tau_s on Gamma_sph

半离散有限元方程:

M a + C v + F_int(u, state) = F_ext + F_sph + F_contact

线性静力方程:

K u = F_ext

非线性静力平衡方程:

R(u, state) = F_ext - F_int(u, state) - F_contact(u) = 0

第一版不实现接触,故实际显式残差为:

F_res = F_ext + F_sph - F_int - F_damp

5. 弱式形式

虚功形式:

Integral_Omega delta_epsilon : sigma dV
+ Integral_Omega rho delta_u . a dV
= Integral_Omega delta_u . b dV
+ Integral_Gamma_t delta_u . tbar dA
+ Integral_Gamma_sph delta_u . t_sph dA

有限元离散后:

F_int = Integral_Omega B^T sigma dV
F_ext = Integral_Omega N^T b dV + Integral_Gamma_t N^T tbar dA
F_sph = Integral_Gamma_sph N^T t_sph dA

Updated Lagrangian 第一版约定:

  • 当前构形用于计算体积、面积、法向和几何导数。
  • 内力在当前构形中使用 Cauchy 应力积分。
  • 单元节点坐标由 coord = coord0 + u 更新。
  • 单元删除后不再贡献内力和边界面力。

6. 空间离散

位移插值:

u(x,t) = Sum_i N_i(x) u_i(t)

实体单元应变率离散:

D = sym(grad(v))

小应变模式中使用增量工程应变:

Delta_epsilon = B Delta_u

大变形模式中使用当前构形速度梯度:

L = grad_current(v)
D = 0.5 * (L + L^T)
W = 0.5 * (L - L^T)

第一版实体单元:

  • C3D4:四节点线性四面体,一点积分。
  • C3D8:八节点线性六面体,2x2x2 全积分。
  • 第一版暂不支持 C3D8R 减缩积分。

第一版壳单元:

  • S4:四节点 Mindlin-Reissner 壳。
  • 膜/弯曲项采用 2x2 面内积分。
  • 横向剪切项采用选择性减缩积分。
  • 剪切修正系数采用 5/6。
  • 第一版 S4 大转动和 hourglass 控制能力有限,第二版完善。

7. 质量矩阵与阻尼

第一版采用集中质量矩阵。

实体单元质量:

m_e = rho V_e

C3D4 和 C3D8 平动质量按节点均分:

m_i += m_e / nnode

S4 壳单元质量:

m_e = rho A_e h

S4 平动质量按节点均分。转动惯量第一版采用简化对角近似:

I_i += rho A_e h^3 / (12 nnode)

阻尼策略:

  • 第一版默认无 Rayleigh 阻尼。
  • 第一版支持可选线性和二次 bulk viscosity。
  • 第三版在隐式动力路径中实现 Rayleigh 阻尼。

bulk viscosity 可写为等效附加压力:

q = rho (c1 c Lc div(v) + c2 Lc^2 div(v)^2)

仅在压缩状态 div(v) < 0 时启用。

8. 显式中心差分算法

第一版默认使用中心差分:

a_n = M^-1 F_res_n
v_(n+1/2) = v_(n-1/2) + dt a_n
u_(n+1) = u_n + dt v_(n+1/2)

整步速度用于输出和外部接口:

v_n = 0.5 * (v_(n-1/2) + v_(n+1/2))

单步流程:

clear force vectors
apply CLOAD and DLOAD
receive or keep SPH forces
compute element stress update and internal force
apply optional bulk viscosity
apply Dirichlet constraints
compute acceleration
update half-step velocity
update displacement
reconstruct output velocity
update current coordinates
evaluate material failure and element deletion
write output when requested

Dirichlet 约束处理:

  • 对约束自由度直接覆盖 u、v、vhalf 和 a。
  • 对固定自由度,速度和加速度置零。
  • 对给定位移历史,按 amplitude 更新约束值。

9. 稳定时间步

显式稳定步长采用单元临界步长估计:

dt_e = Lc / cd
dt = safety * min(dt_e)

默认安全系数:

safety = 0.8

弹性波速:

cd = sqrt((lambda + 2 mu) / rho)

其中:

mu = E / (2(1 + nu))
lambda = E nu / ((1 + nu)(1 - 2 nu))

第一版约定:

  • 弹塑性、应变率和温度影响下仍使用弹性波速进行保守估计。
  • 删除单元不参与后续稳定步长估计。
  • 若用户指定 dt,仍应检查 dt > 0 并在日志中报告 dt / dtcrit。

10. 实体单元算法

10.1 C3D4

C3D4 使用一点积分:

F_int_e = V B^T sigma

特征长度可由体积和最大面面积估计:

Lc = 3 V / Amax

失效删除默认规则:

ANY_FAILED_GP

即任一积分点失效则删除单元。

10.2 C3D8

C3D8 使用 2x2x2 全积分:

F_int_e = Sum_gp B_gp^T sigma_gp detJ_gp w_gp

第一版不支持 C3D8R。

失效删除默认规则:

FRACTION_FAILED_GP, fraction = 0.5

即失效积分点比例达到 0.5 时删除单元。

11. 壳单元算法

第一版 S4 采用 Mindlin-Reissner 壳。

壳应变包括:

epsilon_membrane
kappa_bending
gamma_transverse_shear

壳厚度方向应变近似:

epsilon(z) = epsilon_membrane + z kappa_bending

横向剪切能:

U_shear = Integral kappa_s G h gamma_s^T gamma_s dA

其中剪切修正系数:

kappa_s = 5 / 6

积分策略:

  • 膜项:2x2。
  • 弯曲项:2x2。
  • 横向剪切项:选择性减缩积分。

第一版限制:

  • S4 可用于板受压力脉冲等基础动力响应。
  • S4 大转动能力有限。
  • hourglass 控制第三版完善。
  • S3、S6、S8 第二版实现。
  • 壳单元线性静力刚度第三版实现并用于 Scordelis-Lo 验证。

V4.7 壳 J2 塑性验证路径采用代表性外纤维近似:

epsilon_rep = [eps_m1 + h/2 kappa_1,
               eps_m2 + h/2 kappa_2,
               0,
               gamma_m12 + h/2 kappa_12,
               gamma_13,
               gamma_23]

其中 h 为壳厚度,eps_m 为膜应变,kappa 为弯曲曲率,gamma_13/gamma_23 为横向剪切工程应变。该代表性应变进入已有小应变 J2/J2_JC 返回映射,用于触发膜、剪切和弯曲塑性状态更新;弯矩由外纤维应力按 h^2 / 6 近似映射回 section resultant。该方法不是完整厚度方向积分,后续多层 section integration 需要替换此近似并保持 trial/rollback 语义。

S4 删除默认规则:

FRACTION_FAILED_GP, fraction = 0.5

12. 材料算法

12.1 各向同性线弹性

小应变弹性:

sigma = C epsilon

弹性矩阵由 E 和 nu 定义。

大变形 hypoelastic 模式中采用应力率形式:

objective_rate(sigma) = C : D

第一版客观率采用 Jaumann rate:

sigma_dot_J = sigma_dot - W sigma + sigma W

12.2 小应变 J2 弹塑性

小应变 J2 采用:

  • von Mises 屈服函数。
  • 关联流动法则。
  • 径向返回映射。
  • 各向同性硬化。

屈服函数:

f = sigma_eq - sigma_y(eqps, epdot, T)

等效应力:

sigma_eq = sqrt(3/2 s:s)

试应力:

sigma_trial = sigma_n + C Delta_epsilon

若 f_trial <= 0,执行弹性更新。若 f_trial > 0,执行径向返回并更新:

Delta_gamma
eqps_(n+1) = eqps_n + Delta_eqps
plastic_strain_(n+1)
sigma_(n+1)

硬化模型:

  • 理想弹塑性。
  • 线性硬化。
  • 多段塑性曲线。

12.3 大变形 J2 弹塑性

第一版大变形 J2 采用:

hypoelastic-plastic J2 + Jaumann objective rate

算法变量:

L = grad_current(v)
D = sym(L)
W = skew(L)

应力更新采用 Cauchy 应力和 Jaumann 客观率。塑性修正仍采用 J2 偏应力返回思想。

第三版或后续应补充:

F = Fe Fp

形式的有限应变塑性,并使用塑性变形梯度 Fp 作为状态变量。

12.4 Johnson-Cook 流动应力

第一版支持 Johnson-Cook 流动应力:

sigma_y = (A + B eqps^n)
          * (1 + C ln(epdot / epdot0))
          * (1 - Tstar^m)

温度归一化:

Tstar = (T - Troom) / (Tmelt - Troom)

约定:

  • epdot <= epdot0 时应对对数项做下限保护。
  • Tstar 限制在 [0, 1]。
  • 温度达到熔点附近时材料强度可降至零或触发失效,具体由材料参数控制。

12.5 Mohr-Coulomb 岩土塑性

第五版增加小应变 Mohr-Coulomb 材料点更新路径,当前用于材料点验收、 包络计算和强度折减 driver。应力仍采用受拉为正的约定,因此受压主应力 在代码中为负值。材料点内部先求主应力并按

sigma_1 >= sigma_2 >= sigma_3

排序,再以压缩正量表示三轴强度计算:

c_minor = -sigma_1
c_major = -sigma_3

其中 c_major 对应更大的压缩主应力量。剪切屈服面采用

N_phi = (1 + sin(phi)) / (1 - sin(phi))
K_phi = 2 c sqrt(N_phi)
f_shear = c_major - N_phi c_minor - K_phi

张拉截断采用最大主应力上限:

f_tension = sigma_1 - sigma_t

当 f_shear <= tol 且 f_tension <= tol 时为弹性步;仅剪切超限进入 shear return,仅张拉超限进入 tension cutoff,两者同时超限进入 mixed return。当前分支编码为:

0 elastic
1 shear
2 tension
3 mixed

状态变量布局如下:

statev(1)      equivalent / accumulated plastic measure
statev(5:10)   plastic strain components
statev(11)     Mohr-Coulomb branch id
statev(12)     final shear yield value
statev(13)     final tension cutoff value
statev(20)     plastic increment rate
statev(21)     max final yield value
statev(22)     last plastic increment magnitude
statev(26)     active strength reduction factor

材料参数包括摩擦角 phi、黏聚力 c、膨胀角 psi、张拉强度 sigma_t、残余摩擦角、残余黏聚力、残余膨胀角和当前强度折减系数。 强度折减时使用

phi_red = atan(tan(phi) / F)
c_red = c / F
psi_red = atan(tan(psi) / F)
sigma_t_red = sigma_t / F

并受残余参数下限约束。

返回映射采用工程稳健的分支式算法。剪切分支先按 Drucker-Prager 型流动 方向形成应力修正,再投影到 Mohr-Coulomb 主应力平面;张拉分支将超过 张拉强度的主应力钳制到张拉截断面;mixed 分支先执行剪切修正,再执行 张拉截断。塑性应变增量由弹性柔度对应力修正反算得到,并累计到 statev(5:10)。

当前算法切线是工程算法切线,而不是完整角点一致切线。shear/mixed 分支 使用基于当前分支法向的投影切线,tension 分支对切线进行截断缩放,目的 是支撑小规模隐式和结构 benchmark 的稳定迭代。完整棱边/角点一致切线 仍需在后续高保真结构验收中审计。

材料 driver 支持单步和路径更新,并记录 substep 数、limited 状态、各分支 计数、最终分支、最终屈服值、累计塑性增量、应力功和切线对角诊断。当前 材料点验收覆盖三轴压缩、三轴伸展、纯剪、张拉截断、mixed return 和 强度折减残余下限。

12.6 温度效应

第一版支持:

  • 初始温度。
  • 绝热塑性温升。
  • 外部温度接口预留。

第一版不做热传导。

绝热塑性温升:

Delta_T = chi sigma_eq Delta_eqps / (rho cp)

其中 chi 为 Taylor-Quinney 系数,cp 为比热。

12.7 材料失效

第一版支持两类失效:

等效塑性应变阈值失效:

failed if eqps >= eqps_fail

Johnson-Cook 损伤失效:

D_damage = Sum(Delta_eqps / eps_f)
failed if D_damage >= 1

断裂应变:

eps_f = (D1 + D2 exp(D3 sigma_star))
        * (1 + D4 ln(epdot / epdot0))
        * (1 + D5 Tstar)

其中 sigma_star 为应力三轴度相关变量。

13. 单元删除算法

材料点失效后设置对应高斯点 fail_flag。

单元删除规则:

delete_rule = ANY_FAILED_GP
delete_rule = FRACTION_FAILED_GP

默认规则:

  • C3D4:ANY_FAILED_GP。
  • C3D8:FRACTION_FAILED_GP,fraction = 0.5。
  • S4:FRACTION_FAILED_GP,fraction = 0.5。

删除单元处理:

  • 单元在内存中保留且可访问。
  • elem_status 标记为 deleted。
  • 删除单元不再贡献内力。
  • 删除单元不再接受面压力或 SPH facet 外载。
  • 删除单元质量保留在 mass_diag 中。
  • 删除单元不触发自由度重编号。
  • 输出中必须记录删除状态。

14. 压力、面力与 SPH 映射

压力面力:

t = -p n

等效节点力:

f_i += Integral_face N_i t dA

SPH facet 牵引:

t_sph = -p n + tau_s

其中 tau_s 为 SPH 传入的剪切牵引向量。

SPH 节点力输入:

f_sph(dof(node,1:3)) += force(1:3,node)

耦合步骤:

FEM exports boundary facet coordinates, velocities, normals and areas
SPH computes pressure, shear traction or nodal force
FEM maps received loads to fsph
FEM advances one explicit step
FEM updates current boundary state

15. 能量计算

第一版输出能量历史:

  • kinetic energy
  • internal energy
  • external work
  • SPH work
  • deleted element count

第二版预留:

  • hourglass energy
  • contact work
  • damping energy

动能:

E_kin = 0.5 Sum_i m_i v_i^2

内能增量:

Delta_E_int = Sum_gp sigma : Delta_epsilon volume_gp

外力功可用梯形近似:

Delta_W_ext = 0.5 (F_ext_n + F_ext_(n+1)) . Delta_u

SPH 功按 fsph 单独累计。

16. 静力与隐式算法

第二版提供隐式线弹性小变形求解最小流程:

K u = F_ext

该流程用于验证 CSR 装配、线性求解器、Dirichlet 约束和小型实体静力算例。

第三版线性静力算法正式支持实体和壳单元:

assemble K
assemble F_ext
apply Dirichlet, MPC and Robin terms
solve K u = F_ext
recover strain, stress and reaction
write static output

第三版非线性静力算法采用 Newton-Raphson:

for each load increment:
  predict u
  for each Newton iteration:
    compute F_int(u, state_trial)
    compute R = F_ext - F_int - F_contact
    assemble K_tangent
    apply constraints
    solve K_tangent Delta_u = R
    update u
    check force and displacement convergence
    commit state

当前 V3.4/V3.5 阶段实现采用 Newton 形式:

  • 残差使用当前位移下的非线性内力 F_int(u,state)。
  • 实体单元切线使用当前积分点弹性/J2 算法切线;壳单元膜内、弯曲和横向剪切 section tangent 对 J2/J2_JC 使用当前积分点算法切线映射。V4.7 中壳剪切和弯曲塑性状态由代表性外纤维应变驱动,切线仍复用当前积分点算法切线进行 section block 映射。
  • Dirichlet、CLOAD、DLOAD、Robin、MPC、SPH/contact 外力向量进入静力残差。
  • Robin、MPC、刚性平面 penalty contact 和面-面 contact pair 切线进入 Newton 切线矩阵。
  • 材料状态和单元删除标志采用增量级 trial/restore/commit;非收敛时恢复到增量起点。
  • Newton 线搜索默认启用;可选步长缩减在增量失败时回退到增量起点并缩小当前增量。

第三版隐式动力算法采用 Newmark + Newton。

有效残差方程:

R(u) = F_ext - F_int(u,state) - M a - C v
K_eff Delta_u = R

当前 V3.5 阶段实现提供线性 Newmark 和非线性 Newmark-Newton 骨架。默认参数:

beta = 1/4
gamma = 1/2

预测量:

u_pred = u_n + dt v_n + dt^2 (1/2 - beta) a_n
v_pred = v_n + dt (1 - gamma) a_n

当前线性有效方程:

a0 = 1 / (beta dt^2)
K_eff = K + a0 M
K_eff u_{n+1} = F_{n+1} + a0 M u_pred
a_{n+1} = a0 (u_{n+1} - u_pred)
v_{n+1} = v_pred + gamma dt a_{n+1}

Rayleigh 阻尼:

C = alpha_M M + beta_K K
K_eff = K + a0 M + a1 C

非线性 Newmark-Newton 骨架:

u_trial = u_pred + Delta_u
a_trial = a0 (u_trial - u_pred)
v_trial = v_pred + gamma dt a_trial
R = F_ext(t_{n+1}) - F_int(u_trial,state) - M a_trial - C v_trial
K_eff Delta_u = R

当前实现中 K_eff 使用当前实体材料算法切线、壳 section 塑性算法切线、集中质量矩阵、Rayleigh 阻尼和外部约束/接触切线形成。收敛判据使用绝对力残差和相对力残差,Dirichlet 约束自由度的位移增量残差置零。非线性 Newmark 支持线搜索;可选步长缩减在单步失败时恢复运动学量和材料 trial 状态后重试。

V4.5 起,静力和隐式求解共享最近一次收敛诊断状态:

  • increment / iteration 记录当前增量和 Newton 迭代。
  • residual_norm / relative_residual_norm / correction_norm 记录最近一次绝对力残差、相对力残差和位移修正范数。
  • contact_gap_norm 记录最近一次接触力评估中的最大 contact gap residual;面-面 contact pair 当前使用已有 gap residual/mortar 权重诊断源。
  • combined_norm 取相对力残差、位移修正范数和 contact gap residual 的最大值,作为统一多准则诊断量。
  • cutback_count / last_dt / last_accepted_time 记录累计步长缩减次数、最后尝试步长和最后有效求解时间。
  • status_code 区分 idle、iterating、converged、cutback 和 failed。
  • failure_code 区分无失败、Newton 不收敛、cutback 耗尽和运行未到终点。
  • 当前硬停止条件仍使用绝对/相对力残差;contact gap residual 先进入 diagnostics 和测试覆盖,后续可在接触算例标定后升级为可选硬准则。

当前限制:

  • Rayleigh 阻尼已在线性 Newmark 和非线性 Newmark-Newton 骨架中接入。
  • 实体 J2 非线性 Newmark 使用当前积分点算法切线,壳膜内、弯曲和横向剪切 section tangent 对 J2/J2_JC 使用当前积分点算法切线映射。
  • 材料状态和单元删除标志已具备 trial/restore/commit 机制。
  • Robin 和 MPC 的非线性动力切线已接入 K_eff。
  • 刚性平面 contact 和面-面 contact pair 的 penalty/damping 切线已接入 K_eff。
  • 主要用于验证质量矩阵、CSR 有效刚度、Dirichlet 约束和命令行流程。

第一版不装配全局刚度矩阵,不要求算法切线用于求解。

第三版应记录:

  • 每个增量的 Newton 迭代次数。
  • 初始残差、当前残差和相对残差。
  • 线性求解器迭代次数。
  • 收敛、失败和步长缩减状态。

16.4 线性求解器分发与 Krylov 算法

第四版隐式和静力路径通过统一线性求解器分发层求解 CSR 线性系统:

A x = b

分发层根据控制参数选择内部 CG、BiCGSTAB 或 GMRES 路径。第五版当前模块 不引入第三方稀疏求解器库,也不把外部求解器进程作为生产验收后端。外部 求解器 method、backend、外部进程交互和 C ABI 诊断接口已从核心中移除;旧 外部 method 数值在配置阶段按非法 method 处理,必须保持当前设置不变,不得 静默回退到内部求解器。

每次通过分发层求解时,csr_analyze 会先给 CSR 矩阵生成轻量 profile: GENERAL 表示普通矩阵,STRUCT_SYM 表示结构对称但数值不对称, SYMMETRIC 表示数值对称,SPD_CAND 表示数值对称、对角完整且无非正 对角项的正定候选。分发层同时在求解前后调用 csr_residual_norm 记录初始 残差、最终残差和最终相对残差。静力、隐式 Newmark、非线性 Newton 修正和 接触/约束切线路径只要经过 linear_solver_solve,都会更新同一组诊断字段。

预条件器当前支持 none 和 Jacobi。Jacobi 预条件器提取 CSR 对角项,求解时使用 z_i = r_i / A_ii;若对角项近零则保留未缩放残差分量,避免除零。

CG 用于对称正定系统,采用标准三项递推,收敛判据为残差范数小于调用方给定 容限。BiCGSTAB 用于非对称系统,使用固定初始影子残差,检测 rho、 alpha 和 omega breakdown,并把 breakdown 或未收敛状态写入线性求解器统计。

GMRES 用于非对称 CSR 系统。当前实现采用未重启 Arnoldi 过程,最多构造 max_iter 个 Krylov 基向量:

v_1 = M^{-1} r_0 / ||M^{-1} r_0||
w   = M^{-1} A v_j
h_ij = v_i^T w
w   = w - h_ij v_i
h_{j+1,j} = ||w||

每次扩展后形成小型 Hessenberg 最小二乘问题:

min || beta e_1 - H_k y ||
x_k = x_0 + V_k y

最小二乘当前通过正规方程 H_k^T H_k y = H_k^T beta e_1 和小规模高斯消元求解, 适用于当前小型回归与隐式 smoke。若正规方程奇异或 Arnoldi breakdown, 求解器返回明确错误状态。后续大规模 GMRES 可扩展为重启 GMRES、Givens 旋转更新和内部 ILU/SSOR 等预条件策略,但不引入第三方稀疏求解器依赖。

线性求解器统计包括最近一次 method、preconditioner、迭代数、最终残差和状态码。 静力、隐式 Newmark 和非线性 Newton 修正方程均通过该分发层,保证 C ABI 与 测试可以统一查询求解器行为。

16.5 线性屈曲和内部特征值算法

第五版增加小规模线性屈曲支撑模块,用于验证静力预载后的几何刚度和广义 特征值求解路径。线性屈曲采用如下形式:

K phi = lambda K_G phi

其中 K 是线性或切线刚度,K_G 是单位参考轴力或预载应力形成的几何刚度。 若单元几何刚度采用压缩负号约定,调用方应先通过几何刚度符号 helper 转换为 正的屈曲参考矩阵。模态向量按几何刚度归一化:

phi^T K_G phi = 1

内部广义特征值求解器只面向小规模验证矩阵。eig_generalized_spd 要求 K_G 为对称正定矩阵,先做 Cholesky 分解:

K_G = L L^T
C = L^{-1} K L^{-T}

再对对称矩阵 C 执行 Jacobi 旋转特征值求解,最后将模态回代到原始自由度并 做 K_G 归一化。模态残差按

r = K phi - lambda K_G phi
||r|| / max(1, ||K phi||, |lambda| ||K_G phi||)

输出。buckling_dense_solve 根据自由度规模扩展 Jacobi 最大旋转次数,避免 中等小矩阵因固定迭代预算过低而误报不收敛。该路径不依赖第三方特征值库或 外部求解器。

Euler pinned-pinned column 解析基准使用

P_cr = pi^2 E I / (K L)^2

其中 K 为有效长度系数。examples/euler_column_buckling 将梁弯曲刚度与 geom_beam2d_column_stiffness 生成的几何刚度装配后求解第一阶屈曲因子,并 检查解析相对误差、残差、phi^T K_G phi 归一化和端部横向位移约束。当前 8 单元参考结果为一阶临界载荷相对误差 3.27660856E-05、模态残差 1.50014805E-11。

波纹壳循环屈曲 benchmark 使用十六扇区周期化的紧凑约化模型。该模型从参考 波纹锥壳的半径、高度、厚度和材料尺度构造周期刚度与几何刚度:

K_ii     = k0 + 2 kc
K_i,i+1  = -kc
KG_ii    = g0 + 2 gc
KG_i,i+1 = -gc

并在首尾扇区周期连接。全模型通过 buckling_dense_solve 直接求解,循环扇区 等效结果按波数 m 的相位

theta_m = 2 pi m / N
lambda_m = (k0 + 2 kc (1 - cos(theta_m)))
           / (g0 + 2 gc (1 - cos(theta_m)))

计算,同时调用 cyclic_harmonic_blocks 检查 shell 6 DOF 的循环边界相位映射。 examples/buckling_corrugated_shell 的 checker 比较 selected wave 与全模型 对应特征值、检查循环边界残差、模态正交性、特征残差和 modal CSV 输出。当前 参考 selected wave 4 load 为 453.031407,critical wave 8 load 为 393.369677,循环/全模型相对误差为 1.25473461E-16。

当前限制:

  • 特征值求解器是 dense 小规模内部验证路径,不是大规模稀疏 Lanczos/Arnoldi。
  • 当前已完成 Euler 柱解析 benchmark 和波纹壳紧凑循环 benchmark;通用 *BUCKLING step、静力预载后的壳/实体几何刚度装配和完整壳 FE 高保真 波纹壳屈曲仍属于 V5.5 后续验收项。

17. 接触算法

第二版实现基础 penalty 接触。

第三版接触算法方向:

  • penalty 接触。
  • 通用接触搜索。
  • 节点-面接触。
  • 面-面接触框架。
  • 接触法向与穿透量。
  • 接触阻尼。
  • Coulomb 摩擦力和切向近似切线。
  • 静力接触和动力接触统一残差接口。
  • 接触功输出。

当前第三版阶段实现:

  • 刚性平面接触仍采用节点到平面的 penalty/damping 法向接触。
  • 面-面 contact pair 使用边界 facet 的当前构形坐标、速度、法向、面积、中心和等效半径。
  • slave facet 沿 master 法向投影到 master facet 平面,在局部二维坐标中执行多边形裁剪;裁剪面积大于零且法向间隙为负时激活。多个 master facet 同时激活时按裁剪面积贡献,且总面积不超过 slave facet 面积。
  • 0.3.2 在投影交叠多边形上做三角剖分和 Dunavant 积分,计算 int Ns dA、int Nm dA、int Ns Ns dA、int Ns Nm dA、int Nm Ns dA 和 int Nm Nm dA,用于接触力分配和切线块装配。
  • 接触法向力为 penalty * penetration * mortar_area 加可选法向阻尼项;切向力采用历史切向力 trial、Coulomb 极限和返回映射式粘滑判定。
  • 接触切线采用法向 penalty/damping 块加切向摩擦近似块,按 mortar 形函数乘积积分装配 slave-slave、slave-master、master-slave 和 master-master 四类自由度耦合。
  • 当前实现包含 master facet 均匀空间网格候选搜索、master facet BVH 宽相搜索和 facet 中心/等效半径 broad-phase 精筛;OpenMP 可用时 BVH 搜索按 slave facet 并行遍历。V4.4 增加 force/tangent 共享的跨调用 broad candidate 缓存,缓存命中只复用待检查 master facet 列表,仍重新计算当前 gap、法向速度、mortar 权重和 active 状态;当拓扑、pair 参数或 facet 运动超阈值时失效并回退 BVH 搜索。接触状态记录激活贡献数、最大穿透量、接触力范数和 0.5 * |F_contact| * penetration 形式的接触功估计。
  • 0.3.2 输出 contact pair 的 stick/slip 计数、累计滑移和切向摩擦力历史。当前仍未实现工程级 mortar 约束求解和大规模接触收敛控制。
  • 0.3.3 支持 Abaqus *SURFACE, TYPE=ELEMENT 输入子集、face label 筛选、壳 SPOS/SNEG 侧向语义和数据行式 *CONTACT PAIR 子集;这些输入语义只改变候选 facet、有效法向和接触目标匹配,不改变上述 penalty/mortar 力学离散形式。

第四版 V4.2 增强 active set 与 augmented penalty 起步路径:

  • contact pair active set 以最近一次接触力评估的激活贡献数为基础,状态分为 open、activated、maintained 和 released。
  • 法向 gap 残差采用当前 pair 内激活贡献的最大穿透量:
g_res = max(max(-g_n, 0))
  • 当前增强罚函数采用接触对级标量乘子,而不是完整 mortar 积分点 Lagrange multiplier。法向接触压力为:
p_n = k_n * max(-g_n, 0) + lambda_n
  • 每次接触力评估后,对 active pair 更新:
lambda_n <- lambda_n + alpha_aug * k_n * g_res

其中 alpha_aug 为 AUGMENT 或 AUGMENT_FACTOR 参数。released pair 自动清零 lambda_n,避免重新接触时继承已释放状态的乘子。

  • 该路径适用于刚性平面 analytical contact pair 和面-面 contact pair 的法向力;mortar 权重、V4.3 摩擦历史和切线装配沿用 contact pair 路径。
  • V4.2 的 augmented penalty 是工程增强和诊断框架,不等价于完整 augmented Lagrangian/mortar 约束求解器;完整积分点乘子、摩擦正则化和更严格收敛准则进入后续 0.4.x 阶段。

第四版 V4.3 起步增强 contact-pair 级摩擦正则化和摩擦功输出:

  • 默认 FRICTION_REGULARIZATION = 0 时,保持第三版 Coulomb 截断路径。
  • 当正则化滑移尺度 s_reg > 0 时,Coulomb 极限使用平滑因子:
F_t_limit = mu * F_n * tanh(s_eq / s_reg)
s_eq = max(|Delta s_t|, |F_t_trial| / k_t)
  • 滑移分支的摩擦耗散功估计为:
W_fric_step += max(0, -F_t . Delta s_t)
  • 当前 Delta s_t 沿用 facet 平均切向相对速度/滑移增量近似,历史变量按 mortar 积分点权重拆分保存。
  • 接触切线的切向近似块使用同一 tanh(s_eq / s_reg) 因子折减 mu,使正则化摩擦力和 pair 级切线在趋势上保持一致。当前为工程近似一致切线,完整 stick/slip 算法切线仍可在后续增强。
  • 当前摩擦历史已经从单一 contact pair 标量推进到 mortar 积分点槽,槽键为 pair + slave element/face + master element/face + point_id。每个槽保存切向力、累计滑移、累计摩擦功和 stick/slip 状态;下一步 trial 历史由同一 facet pair 下的积分点槽求和得到。

第五版 V5.6 增加刚体辊滚压运动学 helper。圆柱辊接触点的表面速度由平动和 角速度共同决定:

v_surface = v_center + omega x (x_contact - x_center)
omega = angular_speed * axis_unit
v_rel = v_body - v_surface
v_t = v_rel - (v_rel . n) n

其中 v_t 是进入滚压切向滑移、摩擦功和牵引计算的相对切向速度。roller_contact_kin 输出 gap、penetration、normal、roll direction、axial direction、relative velocity、 normal speed 和 slip speed。roller_step_velocity 将 feed rate 与 down rate 组合为辊平动速度,roller_step_eval 给出每个时间点的 feed、down、spin 和 压力控制值。

滚压 benchmark 使用正则化切向牵引:

F_t = -mu F_n tanh(|v_t| / v_ref) v_t / |v_t|

当 v_ref = 0 时退化为经典 Coulomb 牵引。该形式使角速度不仅改变滑移速度和 摩擦功,也会在小滑移范围内改变牵引幅值。examples/roll_forming 的 V5.6 kinematics benchmark 对比有/无角速度两条路径,检查 slip、traction、friction energy、pressure 和 torque。

V5.6 springback benchmark 采用紧凑多层材料点截面验证塑性成形与卸载回弹。 沿宽度布置若干 strip,厚度方向布置若干 layer,每个材料点通过生产 material_update_small_strain_dt 走 J2 小应变返回映射。成形阶段将目标曲率 按滚压压力带权重分配到各 strip:

epsilon_x(z, x) = z kappa(x)
kappa(x) = kappa_target w(x)

每个增量用横向应力为零的局部 Newton 修正求平面应力近似,再累计 statev(1) 等效塑性应变、statev(22) 最近塑性增量和 statev(21) * statev(22) * volume 形式的塑性功指标。成形后以截面弯矩

M = Sum sigma_x z A_point

作为卸载平衡量,通过二分求释放曲率 kappa_release,使卸载后残余弯矩接近 零。残余曲率和回弹位移指标为:

kappa_residual = kappa_target - kappa_release
u_formed = 0.5 kappa_target L^2
u_residual = 0.5 kappa_residual L^2
springback_ratio = (u_formed - u_residual) / u_formed

该 benchmark 同时复用刚体辊运动学、正则化牵引和 roll metrics 输出成形力、 摩擦能、压力、扭矩、塑性区和残余位移。它是 V5.6 自动验收用的紧凑工程 benchmark,不代表主 femlite 已支持完整通用滚压成形 step。

V5.7 cohesive law 使用双线性牵引-分离模型描述粘附、损伤和完全脱粘。法向 开口只取拉开部分进入有效分离,切向滑移以三维向量范数进入混合模态:

delta_eff = sqrt(max(delta_n, 0)^2 + ||delta_t||^2)
beta = ||delta_t||^2 / (max(delta_n, 0)^2 + ||delta_t||^2)

其中 beta 为 mode mixity。损伤起始分离由纯 I 型和纯 II 型起始分离插值得到:

delta_n0 = T_n0 / K_n
delta_t0 = T_t0 / K_t
delta_0(beta) = sqrt((1 - beta) delta_n0^2 + beta delta_t0^2)

混合模态断裂能使用幂指数插值:

G_c(beta) = G_I + (G_II - G_I) beta^eta
T_peak(beta) = sqrt((1 - beta) T_n0^2 + beta T_t0^2)
delta_f(beta) = 2 G_c(beta) / T_peak(beta)

损伤变量由历史最大有效分离驱动,并强制不可逆:

d_trial = 0,                                      delta_max <= delta_0
d_trial = delta_f (delta_max - delta_0)
          / (delta_max (delta_f - delta_0)),      delta_0 < delta_max < delta_f
d_trial = 1,                                      delta_max >= delta_f
d_new = max(d_old, clamp(d_trial, 0, 1))

拉开状态下 secant traction 为:

t_n = (1 - d_new) K_n delta_n
t_t = (1 - d_new) K_t delta_t

当 d_new = 1 且 delta_n >= 0 时状态为 failed,法向和切向牵引均清零;当 delta_n < 0 时使用压缩分支 K_n^c = compression_factor K_n,状态记为 compress,不通过负开口增长 cohesive 损伤。每次 trial 更新记录 delta_max = max(delta_max_old, delta_eff),能量增量采用 max(0, d_new G_c - d_old G_c) 的非负截断。fem_cohesive_state 保存 damage、 trial damage、最大法向开口、最大有效分离、cohesive 能量和状态,并提供 trial/rollback/commit 与 restart 写读;fem_cohesive_metrics 汇总 bonded、 damaging、failed、compress 数量、最大损伤、最大开口、失效面积比例和能量。

examples/ball_adhesion_decohesion 的 V5.7 compact benchmark 将球-膜粘附区 离散为 N 个同心环,每个环面积为:

A_i = pi (r_{i+1}^2 - r_i^2)

位移历史分为压入、卸载和拉脱三段。压入段给定负法向开口,拉脱段给定正开口, 边缘环通过半径系数获得更大的拉开量和切向滑移:

delta_n(r) = u + c_i u_indent (r / R_c)^2,       u < 0
delta_n(r) = u (1 + c_o (r / R_c)^2),             u >= 0
delta_t(r) = slip_ratio max(delta_n, 0) (r / R_c)

每个环使用 cohesive_state_old 读取上一 accepted 状态,调用 cohesive_trial_update 后通过 cohesive_state_store_trial 保存 damage、最大 开口、最大有效分离、能量增量和 status;每个采样点统一 commit。法向反力为

F_n = sum_i t_n(i) A_i

输出的 adhesion_history.csv 记录 force-displacement 曲线、压缩/拉脱反力、 能量、最大损伤和 failed fraction;adhesion_summary.csv 记录 peak pull-off force、min compression force、dissipated energy、hysteresis area、decohesion area 和 final failed fraction;decohesion_profile.csv 记录环级 damage、最大 开口、能量和 failed status。该 benchmark 用于验证 cohesive law/state/metrics 的粘附-脱粘闭环,不代表主 femlite 已具备完整通用球-膜 FE cohesive 接触 step。

V5.8 颗粒基础路径采用内置离散球颗粒模型。颗粒状态保存位置 x_i、速度 v_i、半径 r_i、质量 m_i 和当前外力 f_i。显式推进采用半隐式 Euler 形式:

a_i = f_i / m_i + g
v_i(n+1) = (1 - damping) (v_i(n) + dt a_i)
x_i(n+1) = x_i(n) + dt v_i(n+1)

颗粒-颗粒接触由两球中心距离给出:

n_ij = (x_j - x_i) / ||x_j - x_i||
gap_ij = ||x_j - x_i|| - (r_i + r_j)
overlap_ij = max(0, -gap_ij)
v_rel = v_j - v_i
v_n = v_rel . n_ij
v_t = v_rel - v_n n_ij

法向弹簧阻尼和正则化切向摩擦力为:

F_n = max(0, k_n overlap_ij - c_n min(0, v_n))
F_t = -min(k_t ||v_t||, mu F_n) v_t / ||v_t||

当 ||v_t|| 很小时切向力取零。墙面和 facet 接触使用同一法向弹簧阻尼思想; facet 接触先求颗粒中心到三角形或四边形 facet 的最近点和插值权重,再将 -F_particle 按权重分配到 facet 节点。

颗粒 step 诊断保存:

mass_before, mass_after
momentum_before, momentum_after
kinetic_before, kinetic_after
max_overlap
elastic_energy
dissipated_power
pair_count, wall_count

Fortran helper pstep_diag_values 将上述诊断转换为验收使用的质量、动量、 动能、步耗散能和最大重叠,其中:

dissipated_energy_step = dissipated_power * dt

颗粒-facet step 诊断保存 particle_count、contact_count、max_overlap、 elastic_energy、dissipated_power、particle_force_norm 和 node_force_norm。pfacet_force_balance 用 ||F_particle + sum_i F_node_i|| 检查节点载荷分配平衡。

动态颗粒柔性容器 benchmark 使用 staggered 双向耦合步。第 n 步的生产路径为:

clear fsph
export current FEM boundary facet coordinates and velocities
compute particle-facet contact forces
scatter -F_particle to facet nodes and add them to fsph
advance FEM explicitly with rhs = fext + fsph + fcontact - fint
advance particles with preserved facet reaction force plus pair/wall forces
record particle, contact, force, displacement and energy diagnostics

结构输入不施加 *DLOAD 压力,容器位移只来自映射节点力。benchmark 输出 grain_container_history.csv,记录 step、time、particle_count、 facet_contacts、pair_contacts、wall_contacts、max_overlap、particle_kinetic、 particle_dissipated、facet_dissipated、total_mass、container_disp_z、 total_load_z、particle_force_norm 和 node_force_norm。grain_container_summary.csv 记录最大接触数、映射步数、最大重叠、最大粒子动能、累计耗散、最终质量、最小 容器位移和最大映射载荷。checker 通过非零映射节点力和非零容器位移验证颗粒力确实 回写 FEM。

第一版不实现接触,只保留 fcontact 向量和接口位置。

18. 稳定性与误差控制

第一版必须检查:

  • dt > 0。
  • dt / dtcrit。
  • 负 Jacobian。
  • 退化单元。
  • 非法材料参数。
  • 缺失密度。
  • 删除单元比例。
  • 能量历史异常增长。

建议日志输出:

  • 最小稳定时间步。
  • 控制时间步的单元编号。
  • 最大位移。
  • 最大速度。
  • 最大等效塑性应变。
  • 删除单元数量。

19. 数值验证算例

第一版验收算例:

  • 单元 patch test。
  • 单轴拉伸。
  • 弹塑性加载卸载。
  • 弹性波传播。
  • 板受压力脉冲。
  • 简化 SPH-FEM 边界力传递接口。

第三版验收算例:

  • 实体单元线弹性静力 patch test。
  • 实体单元单轴拉伸静力。
  • 实体单元 J2 弹塑性静力加载卸载。
  • Scordelis-Lo 壳静力基准。
  • 板壳弯曲静力基准。
  • 隐式动力弹性波传播。
  • 简化接触静力压入。
  • 简化接触动力冲击。

算法专项验证:

  • 小应变 J2 单点返回映射。
  • 大变形 Jaumann 客观率刚体转动测试。
  • Johnson-Cook 应变率敏感单点测试。
  • 绝热温升单点测试。
  • 单元删除规则测试。
  • 压力符号测试。

第五版强度折减搜索采用材料参数折减、trial 稳定性分类、上/下界 bracket 更新和 二分收敛组合。每个 trial 记录折减系数、残差、位移范数、塑性区比例、综合失稳 指标、稳定标志和搜索状态;搜索状态包括 searching、bracketed、converged、 limited 和 invalid。报告层输出 trial CSV 与 summary 行,为边坡安全系数和 Mohr-Coulomb 强度折减 benchmark 提供可复现的验收指标。