# 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. 符号与约定 节点自由度: ```text 1 UX 2 UY 3 UZ 4 RX 5 RY 6 RZ ``` 应力、应变分量顺序: ```text 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 转换。 压力符号: ```text t = -p n ``` 其中 n 为固体外法向,p > 0 表示受压,t 为作用在 FEM 边界上的面力向量。正应力仍采用受拉为正。 ## 4. 控制方程 连续体动量方程: ```text div(sigma) + b = rho a ``` 边界分解: ```text u = ubar on Gamma_u t = tbar on Gamma_t t = -p n + tau_s on Gamma_sph ``` 半离散有限元方程: ```text M a + C v + F_int(u, state) = F_ext + F_sph + F_contact ``` 线性静力方程: ```text K u = F_ext ``` 非线性静力平衡方程: ```text R(u, state) = F_ext - F_int(u, state) - F_contact(u) = 0 ``` 第一版不实现接触,故实际显式残差为: ```text F_res = F_ext + F_sph - F_int - F_damp ``` ## 5. 弱式形式 虚功形式: ```text 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 ``` 有限元离散后: ```text 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. 空间离散 位移插值: ```text u(x,t) = Sum_i N_i(x) u_i(t) ``` 实体单元应变率离散: ```text D = sym(grad(v)) ``` 小应变模式中使用增量工程应变: ```text Delta_epsilon = B Delta_u ``` 大变形模式中使用当前构形速度梯度: ```text 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. 质量矩阵与阻尼 第一版采用集中质量矩阵。 实体单元质量: ```text m_e = rho V_e ``` C3D4 和 C3D8 平动质量按节点均分: ```text m_i += m_e / nnode ``` S4 壳单元质量: ```text m_e = rho A_e h ``` S4 平动质量按节点均分。转动惯量第一版采用简化对角近似: ```text I_i += rho A_e h^3 / (12 nnode) ``` 阻尼策略: - 第一版默认无 Rayleigh 阻尼。 - 第一版支持可选线性和二次 bulk viscosity。 - 第三版在隐式动力路径中实现 Rayleigh 阻尼。 bulk viscosity 可写为等效附加压力: ```text q = rho (c1 c Lc div(v) + c2 Lc^2 div(v)^2) ``` 仅在压缩状态 div(v) < 0 时启用。 ## 8. 显式中心差分算法 第一版默认使用中心差分: ```text 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) ``` 整步速度用于输出和外部接口: ```text v_n = 0.5 * (v_(n-1/2) + v_(n+1/2)) ``` 单步流程: ```text 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. 稳定时间步 显式稳定步长采用单元临界步长估计: ```text dt_e = Lc / cd dt = safety * min(dt_e) ``` 默认安全系数: ```text safety = 0.8 ``` 弹性波速: ```text cd = sqrt((lambda + 2 mu) / rho) ``` 其中: ```text mu = E / (2(1 + nu)) lambda = E nu / ((1 + nu)(1 - 2 nu)) ``` 第一版约定: - 弹塑性、应变率和温度影响下仍使用弹性波速进行保守估计。 - 删除单元不参与后续稳定步长估计。 - 若用户指定 dt,仍应检查 dt > 0 并在日志中报告 dt / dtcrit。 ## 10. 实体单元算法 ### 10.1 C3D4 C3D4 使用一点积分: ```text F_int_e = V B^T sigma ``` 特征长度可由体积和最大面面积估计: ```text Lc = 3 V / Amax ``` 失效删除默认规则: ```text ANY_FAILED_GP ``` 即任一积分点失效则删除单元。 ### 10.2 C3D8 C3D8 使用 2x2x2 全积分: ```text F_int_e = Sum_gp B_gp^T sigma_gp detJ_gp w_gp ``` 第一版不支持 C3D8R。 失效删除默认规则: ```text FRACTION_FAILED_GP, fraction = 0.5 ``` 即失效积分点比例达到 0.5 时删除单元。 ## 11. 壳单元算法 第一版 S4 采用 Mindlin-Reissner 壳。 壳应变包括: ```text epsilon_membrane kappa_bending gamma_transverse_shear ``` 壳厚度方向应变近似: ```text epsilon(z) = epsilon_membrane + z kappa_bending ``` 横向剪切能: ```text U_shear = Integral kappa_s G h gamma_s^T gamma_s dA ``` 其中剪切修正系数: ```text kappa_s = 5 / 6 ``` 积分策略: - 膜项:2x2。 - 弯曲项:2x2。 - 横向剪切项:选择性减缩积分。 第一版限制: - S4 可用于板受压力脉冲等基础动力响应。 - S4 大转动能力有限。 - hourglass 控制第三版完善。 - S3、S6、S8 第二版实现。 - 壳单元线性静力刚度第三版实现并用于 Scordelis-Lo 验证。 V4.7 壳 J2 塑性验证路径采用代表性外纤维近似: ```text 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。该方法是 V4.7 遗留单层近似,不得作为 V5.11 多层塑性完成证据;V5.11 的多层 through-thickness integration、layer state、trial/rollback 和 algorithmic tangent 由 `fem_shell_section` 生产入口承担。 V5.11 新增弹性多层壳 section 的生产路径。输入 `*SHELL SECTION, COMPOSITE` 后,每层以 `thickness, material` 存入 `section_layer_*` 数据表;当前多层 section 只接受 `ELASTIC` 层材料,若层材料为 J2/J2_JC/Mohr-Coulomb 等塑性模型会 明确报错。层合弹性刚度采用经典 ABD/H 积分。以总厚度中面为 `z=0`,第 `l` 层上下表面坐标为 `z_l^-`、`z_l^+`,平面应力弹性矩阵为 `C_l`,剪切模量为 `G_l`: ```text A = sum_l C_l (z_l^+ - z_l^-) B = sum_l C_l ((z_l^+)^2 - (z_l^-)^2) / 2 D = sum_l C_l ((z_l^+)^3 - (z_l^-)^3) / 3 H = sum_l (5/6) G_l t_l I_2 N = A epsilon_m + B kappa M = B^T epsilon_m + D kappa Q = H gamma_s ``` `fem_shell_section` 是单层和多层 section 矩阵的唯一生产入口。线性 S3/S4/S6/S8 刚度和 finite-membrane-strain S4 路径均使用同一组 `A/B/D/H` 矩阵。因此非对称层合板的膜-弯耦合进入已有内力和刚度;旧的单层 `shell_constitutive`/`shell4_resultants` 辅助路径已删除。V5.11 已把 ELASTIC、J2、J2_JC 和 composite layer 的 section resultants、algorithmic tangent、 layer state、trial/rollback 接入统一 `shell_section_update_resultants` / `shell_section_tangent_at` 生产入口;未支持的壳层材料必须显式报错,不能回退旧外纤维 近似。 V5.11 正式几何非线性壳路线采用 Abaqus-style finite-membrane-strain S4 formulation。该路线的数学对象不是小应变壳在当前局部坐标中的简单刚体转动投影, 而是参考中面到当前中面的有限变形映射、节点 director 有限转动、 Koiter-Sanders 类曲率增量和 MITC/ANS assumed strain。 参考中面用自然坐标 `xi, eta` 描述: ```text X(xi,eta) = sum_a N_a X_a x(xi,eta) = sum_a N_a x_a A_alpha = dX/dxi_alpha a_alpha = dx/dxi_alpha ``` 节点壳转动自由度的 Newton 修正 `Delta theta_a` 通过 exponential map/quaternion 更新 committed/trial rotation,再由 rotation 生成 director: ```text R_a^{n+1} = exp(Delta theta_a) R_a^n d_a^{n+1} = R_a^{n+1} d_a^0 ``` V5.11-2 已在 `fem_shell_rotation` 中把 `R_a` 存为每节点 quaternion committed/trial 状态,并接入 element-state backup、rollback、commit 和 restart。Newton 迭代中 `shell_rotation_sync_trial` 记录每个节点已同步的旋转 DOF,并把新的 DOF 修正作为 增量旋转左乘到当前 trial rotation;trial step 失败或 cutback 时,`R_a`、DOF sync state 和由它派生的 director/曲率状态必须随单元状态一起 rollback。 V5.11-3 已在 `fem_shell_finite_kinematics` 中实现 S4 reference/current covariant basis、director interpolation、surface metric、有限膜应变、Koiter-Sanders-style 曲率增量和 MITC4 横向剪切运动学投影。该模块对外输出现有 shell section 使用的局部 工程广义应变分量,而不是把 covariant tensor 分量直接传给 section。 广义应变采用八分量口径: ```text e = [e11, e22, 2e12, k11, k22, 2k12, gamma13, gamma23] ``` 膜应变由参考和当前中面 metric 的有限变化得到: ```text E_alpha_beta = 0.5 (a_alpha . a_beta - A_alpha . A_beta) ``` 实现时可在增量格式中使用极分解 stretch 和 logarithmic strain increment,但必须与 上式的有限膜应变极限一致。曲率增量采用 Koiter-Sanders 类 director/basis 变化项, 包含 director 关于中面坐标的导数和当前/参考 surface basis 的变化。横向剪切应变由 current basis 与 director 的夹角得到,MITC4 版本在四条边 tying points 采样 covariant shear,再按自然坐标插值并投影到局部 `gamma13/gamma23`。 S4 几何非线性内力为: ```text S = shell_section(e, state) F_int = integral_A B_nl^T S dA ``` 其中 `S = [N11,N22,N12,M11,M22,M12,Q13,Q23]`,`shell_section` 返回同一积分点的 algorithmic section tangent `D_alg = dS/de`。生产 Newton 切线必须采用解析一致切线: ```text K_int = integral_A B^T D_alg B dA + K_sigma(N,M,Q) + K_rotation + K_drilling ``` `K_sigma` 必须包含膜力、弯矩和横向剪力对当前几何的几何刚度贡献;`K_rotation` 包含 finite-rotation 更新对 director、曲率和剪切项的导数;`K_drilling` 是单独的 drilling rotation 稳定化贡献。中心有限差分切线只允许作为测试审计: V5.11 的 S4 切线实现采用残差重线性化形式: ```text K = integral_A (B^T D_alg B + sum_i S_i dB_i / du) dA ``` 其中 `dB_i/du` 是以当前 Newton 迭代的增量转动参数为状态扰动、再以当前 director 重新构造虚位移列得到的算法线性化。由于有限转动增量一般不交换, 该 `dB/du` 不强制等同于同一转动向量坐标下的对称二阶能量 Hessian,最终 Newton 切线可为非对称矩阵;这与内部 GMRES/BiCGSTAB/dense fallback 的非对称 求解链相匹配。 drilling 稳定化采用与残差和刚度一致的节点势能,而不是直接对材料矩阵加人工刚度: ```text Pi_drill = 1/2 sum_a k_a (theta_a . D_a)^2 R_drill = dPi_drill / du K_drill = dR_drill / du ``` 其中 `D_a` 为参考 director,`theta_a` 为节点有限转动向量在参考 director 上的 drilling 分量,`k_a` 由膜刚度尺度、单元面积和 `shell_drilling_stiffness_factor` 确定。 测试中的有限差分切线审计必须先同步 base trial rotation,再对单个 Newton 修正列 施加正负增量,使有限差分和生产切线使用同一增量转动语义: ```text K_fd[:, j] = (F_int(u_base + h_j e_j) - F_int(u_base - h_j e_j)) / (2 h_j) ``` 不得作为 V5.11 完整生产切线。旧 S4 resultant-delta 诊断路径已经删除;可保留的结论 只有 section、状态提交和非对称线性修正链可复用。它不能作为 Shell-4/8/16 spherical-cap postbuckling 完成依据,也不能重新引入为公开输入/API/fallback 接口。 壳内力提交后仍在 `shell_resultant(1:8,gp)` 保存当前广义力: ```text shell_resultant(1:3) = [N_xx, N_yy, N_xy] shell_resultant(4:6) = [M_xx, M_yy, M_xy] shell_resultant(7:8) = [Q_x, Q_y] ``` 对于壳 `DLOAD P`,非线性 Newton 矩阵还装配当前几何压力外力的 follower tangent。外力写成 ```text F_a = -p integral N_a (t_1 x t_2) dxi deta ``` 其中 `t_1 = sum x_b dN_b/dxi`,`t_2 = sum x_b dN_b/deta`。对节点 `b` 第 `k` 个平动自由度的外力导数为 ```text dF_a/dx_bk = -p integral N_a [ (dN_b/dxi) (e_k x t_2) + (dN_b/deta) (t_1 x e_k) ] dxi deta ``` 求解器矩阵使用残差 `R = F_ext - F_int` 的符号约定,因此装配 `K_ext = -dF_ext/du`。当前可复用基础设施包括弹性多层 ABD/H section 矩阵、 `shell_resultant` 状态、内部非对称修正链和壳压力 follower tangent;旧几何非线性壳 诊断生产接口已经删除。有限转动 committed/trial 状态、S4 finite kinematics、MITC4 横向剪切运动学投影、S4 finite-strain 内力 driver、material/geometric/rotation/drilling 生产切线和多层塑性 through-thickness 状态已经进入生产路径。当前仍不是完整 Shell-4/8/16 后屈曲求解链:`examples/spherical_cap_with_central_point_load` 的 Shell-4 deck 已改为 S4-only square-disk 冠部重网格;当前 nonlinear 试跑可到达 `time=1.0 / uz=-6.2 m`,但反力曲线仍单调硬化,未出现 PDF 的 load drop 和 restiffening。因此 `-6.2 m` PDF 路径仍未通过,后续必须诊断初始曲率、曲率增量、 bending/geometric stiffness、drilling penalty 和控制反力口径。 载荷型 Riks/arc-length 增广方程已进入非线性静力生产路径,见 16.3 的 continuation 方法说明。 S4 删除默认规则: ```text FRACTION_FAILED_GP, fraction = 0.5 ``` ## 12. 材料算法 ### 12.1 各向同性线弹性 小应变弹性: ```text sigma = C epsilon ``` 弹性矩阵由 E 和 nu 定义。 大变形 hypoelastic 模式中采用应力率形式: ```text objective_rate(sigma) = C : D ``` 第一版客观率采用 Jaumann rate: ```text sigma_dot_J = sigma_dot - W sigma + sigma W ``` ### 12.2 小应变 J2 弹塑性 小应变 J2 采用: - von Mises 屈服函数。 - 关联流动法则。 - 径向返回映射。 - 各向同性硬化。 屈服函数: ```text f = sigma_eq - sigma_y(eqps, epdot, T) ``` 等效应力: ```text sigma_eq = sqrt(3/2 s:s) ``` 试应力: ```text sigma_trial = sigma_n + C Delta_epsilon ``` 若 f_trial <= 0,执行弹性更新。若 f_trial > 0,执行径向返回并更新: ```text Delta_gamma eqps_(n+1) = eqps_n + Delta_eqps plastic_strain_(n+1) sigma_(n+1) ``` 硬化模型: - 理想弹塑性。 - 线性硬化。 - 多段塑性曲线。 ### 12.3 大变形 J2 弹塑性 第一版大变形 J2 采用: ```text hypoelastic-plastic J2 + Jaumann objective rate ``` 算法变量: ```text L = grad_current(v) D = sym(L) W = skew(L) ``` 应力更新采用 Cauchy 应力和 Jaumann 客观率。塑性修正仍采用 J2 偏应力返回思想。 第三版或后续应补充: ```text F = Fe Fp ``` 形式的有限应变塑性,并使用塑性变形梯度 Fp 作为状态变量。 ### 12.4 Johnson-Cook 流动应力 第一版支持 Johnson-Cook 流动应力: ```text sigma_y = (A + B eqps^n) * (1 + C ln(epdot / epdot0)) * (1 - Tstar^m) ``` 温度归一化: ```text Tstar = (T - Troom) / (Tmelt - Troom) ``` 约定: - epdot <= epdot0 时应对对数项做下限保护。 - Tstar 限制在 [0, 1]。 - 温度达到熔点附近时材料强度可降至零或触发失效,具体由材料参数控制。 ### 12.5 Mohr-Coulomb 岩土塑性 第五版增加小应变 Mohr-Coulomb 材料点更新路径,当前用于材料点验收、 包络计算和强度折减 driver。应力仍采用受拉为正的约定,因此受压主应力 在代码中为负值。材料点内部先求主应力并按 ```text sigma_1 >= sigma_2 >= sigma_3 ``` 排序,再以压缩正量表示三轴强度计算: ```text c_minor = -sigma_1 c_major = -sigma_3 ``` 其中 `c_major` 对应更大的压缩主应力量。剪切屈服面采用 ```text 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 ``` 张拉截断采用最大主应力上限: ```text f_tension = sigma_1 - sigma_t ``` 当 `f_shear <= tol` 且 `f_tension <= tol` 时为弹性步;仅剪切超限进入 shear return,仅张拉超限进入 tension cutoff,两者同时超限进入 mixed return。当前分支编码为: ```text 0 elastic 1 shear 2 tension 3 mixed ``` 状态变量布局如下: ```text 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 statev(27) MC accepted substeps for the last material update statev(28) MC requested substeps before max-substep limiting statev(29) MC driver status, 0 OK and 1 limited statev(30) MC branch mask, elastic=1, shear=2, tension=4, mixed=8 statev(31) MC max positive yield residual over accepted substeps statev(32) MC max plastic increment over accepted substeps ``` 材料参数包括摩擦角 `phi`、黏聚力 `c`、膨胀角 `psi`、张拉强度 `sigma_t`、残余摩擦角、残余黏聚力、残余膨胀角和当前强度折减系数。 强度折减时使用 ```text phi_red = atan(tan(phi) / F) c_red = c / F psi_red = atan(tan(psi) / F) sigma_t_red = sigma_t / F ``` 并受残余参数下限约束。 `examples/strengthReduction` 对应 `models.geomech.strength_reduction_method.pdf` 的非关联材料工况使用 Davis procedure B 记录参考路线: ```text phi_F = atan(tan(phi) / F) psi_F = atan(tan(psi) / F) beta = cos(phi_F) cos(psi_F) / (1 - sin(phi_F) sin(psi_F)) c_B = beta c phi_B = atan(beta tan(phi)) psi_B = phi_B ``` 随后由强度折减 trial 搜索按 PDF 停止准则 `max displacement > Lslope / 20` 形成稳定/失稳 bracket。这里的 `psi_B = phi_B` 表示 Davis B 将原始非关联 `psi = 0` 工况映射为降低强度后的等效关联流动材料;关联材料工况使用 `psi = phi` 的常规折减路线。`tools/benchmarks/strength_reduction_benchmark.f90` 在默认验收中输出快速 FOS 曲线;使用 `--nonlinear-chain` 时,会对当前输入 执行真实结构级 Mohr-Coulomb 非线性静力 trial,并记录求解错误码、收敛状态、 cutback 次数、Newton 迭代数、最后尝试步长、最后接受时间、位移修正范数、 目标/实际/下一 continuation 步长、目标 Newton 自适应调整原因、trust radius、 damping 因子、residual merit 下降率、trust rejection 次数、线性求解迭代/残差/状态、 相对残差、直接位移控制 path 约束残差/反力、MC 子步/分支聚合诊断、最大节点位移和 塑性积分点比例。默认 `TWO_STAGE_LOAD_STRENGTH` 路线先在强度因子 `F = 1.0` 下收敛完整重力/外载, 再保留位移、应力、应变和材料状态,在固定外载下用伪时间把强度折减因子 continuation 到目标 trial 或云图因子。该结构级路线要求输入网格在上下土体界面 共享节点;`examples/strengthReduction` 的检查脚本会验证 `z = H1`、`x >= L2` 的 lower/upper 元素界面不是分离块体。 `ADAPTIVE_TARGET_NEWTON` 路线把静力伪时间增量视为控制变量。已接受步的 Newton 迭代数小于目标值的一半时按 `GROWTH` 放大下一步;迭代数超过目标值加 半目标值时按 `SHRINK` 缩小下一步;介于两者之间则保持步长。所有建议步长均受 `*STATIC` 的 initial/min/max increment 和剩余伪时间限制。cutback 或失败会记录 `NLC_ADJ_CUTBACK`/`NLC_ADJ_FAILED`,并把下一尝试步长写入诊断字段。 `TRUST_REGION_DAMPED_NEWTON` 路线在每个非线性静力 Newton 修正求出后,先用 当前 trust radius 限制 `Delta u` 的 2 范数,再进入残差 merit line search。 接受试探位移后计算 ```text rho_merit = (||R_k|| - ||R_trial||) / ||R_k|| ``` 若 `||R_trial||` 增大,则该修正被拒绝并返回可复现 solver failure,外层 cutback/rollback 机制负责缩步。若 `rho_merit` 小于 `TRUST_ACCEPT_RATIO`、line search 曾拒绝候选步或总 damping 因子小于 1,则 trust radius 按 `TRUST_SHRINK` 收缩;若 `rho_merit >= TRUST_GOOD_RATIO` 且无阻尼/拒绝,则按 `TRUST_GROWTH` 增长;否则保持。半径始终受 `TRUST_MIN_RADIUS` 和可选 `TRUST_MAX_RADIUS` 约束。该算法的诊断包括 last/next trust radius、总 damping 因子、merit ratio、line-search rejection count 和 trust adjust reason。 `ARC_LENGTH_OR_DISPLACEMENT_CONTROL` 包含两个明确分离的生产路径。 当模型没有非零 prescribed-displacement 控制、且外载向量对全局 `load_factor` 的导数非零时,非线性静力求解器使用载荷型 Riks/arc-length 增广方程。未知量为位移和载荷因子: ```text R(u, lambda) = F_ext(u, lambda) - F_int(u) = 0 g(u, lambda) = ||u - u_n||^2 + (s (lambda - lambda_n))^2 - Delta l^2 = 0 ``` 其中 `s = ARC_LOAD_SCALE`,`Delta l = ARC_LENGTH`;若未给 `ARC_LENGTH`, 当前静力增量长度作为弧长半径。参考载荷方向不是用固定 `load_factor=1` 近似,而是在当前构型上对 `load_factor` 做中心差分: ```text p = d F_ext / d lambda ``` 因此不随 `load_factor` 比例变化的接触、Robin 等外力不会被误纳入 Riks 载荷方向。每个增广 Newton 迭代用同一个约束后切线矩阵求两个方向: ```text K_t Delta u_R = R K_t Delta u_lambda = p Delta lambda = -(g + 2 (u-u_n)^T Delta u_R) /(2 ((u-u_n)^T Delta u_lambda + s^2 (lambda-lambda_n))) Delta u = Delta u_R + Delta lambda Delta u_lambda ``` 收敛要求力残差和弧长约束残差同时满足容差;失败时位移、载荷因子和材料 trial 状态回滚到增量起点。`continuation_path.csv` 的 `parameter` 字段记录 `lambda`,位移范数字段记录实际位移路径,收敛诊断记录增广修正范数和状态码。 如果模型存在非零 prescribed-displacement 控制,方法 4 走直接位移控制 accepted-path 记录:对每个收敛增量,用实际施加的 `u_prescribed = load_factor * amplitude(t) * boundary_value` 作为控制目标, 记录控制参数、控制 DOF 数、目标/实际位移范数、Dirichlet 约束残差、反力、 广义反力功、Newton 迭代数、残差和状态码。该直接位移路径不是 Riks 的简化替代, 只服务于 prescribed-displacement benchmark 和后处理曲线输出。如果模型既没有 非零 prescribed-displacement 控制,也没有非零比例载荷方向,方法 4 返回 solver 错误,不再保留旧的普通 Newton accepted-path 简化 fallback。 `MC_SUBSTEPPING_SEMISMOOTH` 当前作为生产材料点稳定化路线接入 Mohr-Coulomb 材料分发。若 `nonlinear_continuation_method = 5`,每个 `MOHR_COULOMB` 积分点更新先按 ```text n_sub = ceil(max(abs(Delta epsilon_i)) / MC_TARGET_STRAIN) n_sub = max(MC_MIN_SUBSTEPS, min(n_sub, MC_MAX_SUBSTEPS)) ``` 将总应变增量切成等子步,再逐子步调用相同的 shear/tension/mixed 活动集返回映射。 driver 汇总每个子步的最终分支、屈服残差、塑性增量和应力功,并把聚合诊断写入 `statev(27:32)`。若请求子步数超过 `MC_MAX_SUBSTEPS`、正屈服残差超过 `MC_YIELD_TOL` 或单子步塑性增量超过 `MC_PLASTIC_LIMIT`,driver status 记为 limited。`tools/benchmarks/strength_reduction_benchmark.f90` 的结构级 nonlinear chain/cloud/progress 输出会按 Mohr-Coulomb 积分点汇总 `statev(27:32)`,记录积分点数量、已更新点数、accepted/requested substeps、 limited 点数、分支 bit mask、最大屈服残差和最大塑性子步。该路线不改变结构级 continuation 方法 1 至 4 的全局方程;若后续需要 `1+2+5` 等组合,必须通过显式辅助 flag 接入。 返回映射采用工程稳健的分支式算法。剪切分支先按 Drucker-Prager 型流动 方向形成应力修正,再投影到 Mohr-Coulomb 主应力平面;张拉分支将超过 张拉强度的主应力钳制到张拉截断面;mixed 分支先执行剪切修正,再执行 张拉截断。塑性应变增量由弹性柔度对应力修正反算得到,并累计到 `statev(5:10)`。 Mohr-Coulomb 切线采用活动集算法一致切线。若当前状态为弹性,返回弹性 切线;若当前状态为 shear、tension 或 mixed,则固定对应活动分支并对 实际返回映射求局部 Jacobian:shear 分支沿剪切返回加 Mohr-Coulomb 平面 投影,tension 分支沿张拉截断,mixed 分支沿剪切返回后张拉截断的角点路径。 该矩阵允许非对称,适配非关联流动和角点活动集。材料点测试使用小扰动 有限差分审计 `D_alg * Delta epsilon` 对实际返回映射应力增量的预测误差。 0.75 m 文献全模型的长 continuation 仍需用该切线继续做结构级路径验收。 材料 driver 支持单步和路径更新,并记录 substep 数、limited 状态、各分支 计数、最终分支、最终屈服值、累计塑性增量、应力功和切线对角诊断。当前 材料点验收覆盖三轴压缩、三轴伸展、纯剪、张拉截断、mixed return、 shear/tension/mixed 活动集切线审计和强度折减残余下限。 ### 12.6 温度效应 第一版支持: - 初始温度。 - 绝热塑性温升。 - 外部温度接口预留。 第一版不做热传导。 绝热塑性温升: ```text Delta_T = chi sigma_eq Delta_eqps / (rho cp) ``` 其中 chi 为 Taylor-Quinney 系数,cp 为比热。 ### 12.7 材料失效 第一版支持两类失效: 等效塑性应变阈值失效: ```text failed if eqps >= eqps_fail ``` Johnson-Cook 损伤失效: ```text D_damage = Sum(Delta_eqps / eps_f) failed if D_damage >= 1 ``` 断裂应变: ```text eps_f = (D1 + D2 exp(D3 sigma_star)) * (1 + D4 ln(epdot / epdot0)) * (1 + D5 Tstar) ``` 其中 sigma_star 为应力三轴度相关变量。 ## 13. 单元删除算法 材料点失效后设置对应高斯点 fail_flag。 单元删除规则: ```text 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 映射 压力面力: ```text t = -p n ``` 等效节点力: ```text f_i += Integral_face N_i t dA ``` SPH facet 牵引: ```text t_sph = -p n + tau_s ``` 其中 tau_s 为 SPH 传入的剪切牵引向量。 SPH 节点力输入: ```text f_sph(dof(node,1:3)) += force(1:3,node) ``` 耦合步骤: ```text 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 动能: ```text E_kin = 0.5 Sum_i m_i v_i^2 ``` 内能增量: ```text Delta_E_int = Sum_gp sigma : Delta_epsilon volume_gp ``` 外力功可用梯形近似: ```text Delta_W_ext = 0.5 (F_ext_n + F_ext_(n+1)) . Delta_u ``` SPH 功按 fsph 单独累计。 ## 16. 静力与隐式算法 第二版提供隐式线弹性小变形求解最小流程: ```text K u = F_ext ``` 该流程用于验证 CSR 装配、线性求解器、Dirichlet 约束和小型实体静力算例。 第三版线性静力算法正式支持实体和壳单元: ```text 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: ```text 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 外力向量进入静力残差。 `DLOAD, P` 对壳单元按当前面法向积分为面压力;`DLOAD, GRAV` 对实体单元按 参考体积积分为体力,输入格式为 `target, GRAV, magnitude, gx, gy, gz`, 方向向量归一化后与材料密度、加速度幅值和单元体积相乘,形成一致节点力。 - Robin、MPC、刚性平面 penalty contact 和面-面 contact pair 切线进入 Newton 切线矩阵。 - 材料状态和单元删除标志采用增量级 trial/restore/commit;非收敛时恢复到增量起点。 - Newton 线搜索默认启用;可选步长缩减在增量失败时回退到增量起点并缩小当前增量。 - `*NONLINEAR CONTINUATION, METHOD=ADAPTIVE_TARGET_NEWTON` 可用目标 Newton 迭代数自动调整静力增量;`METHOD=TRUST_REGION_DAMPED_NEWTON` 可限制 Newton 修正范数并以残差 merit 阻尼防止过冲。二者均使用生产 `fem_solver_implicit` 路径;`METHOD=ARC_LENGTH_OR_DISPLACEMENT_CONTROL` 对载荷型问题使用 Riks/arc-length 增广方程,对非零 prescribed-displacement 控制问题输出直接位移控制 accepted-increment path、约束残差和反力;`METHOD=MC_SUBSTEPPING_SEMISMOOTH` 在生产材料分发内启用 Mohr-Coulomb 局部子步与活动集诊断,不依赖 benchmark-only 代码。 - `SHELL_GEOMETRIC=FINITE_STRAIN` 是 V5.11 finite-membrane-strain S4 的生产输入 语义;`SHELL_GEOMETRIC=LINEAR` 保持现有线性壳路径。旧布尔写法和旧 shell 几何名称已移除,当前只作为输入错误拒绝。载荷型 Riks 方程已在方法 4 中可用,但 `S3/S6/S8` 的 finite-strain 壳、全部 follower-load 类型和 Shell-4/8/16 postbuckling benchmark 仍需后续验收。 第三版隐式动力算法采用 Newmark + Newton。 有效残差方程: ```text R(u) = F_ext - F_int(u,state) - M a - C v K_eff Delta_u = R ``` 当前 V3.5 阶段实现提供线性 Newmark 和非线性 Newmark-Newton 骨架。默认参数: ```text beta = 1/4 gamma = 1/2 ``` 预测量: ```text u_pred = u_n + dt v_n + dt^2 (1/2 - beta) a_n v_pred = v_n + dt (1 - gamma) a_n ``` 当前线性有效方程: ```text 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 阻尼: ```text C = alpha_M M + beta_K K K_eff = K + a0 M + a1 C ``` 非线性 Newmark-Newton 骨架: ```text 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 状态后重试。 非线性静力 step 会在每个增量按 `load_factor = load_factor_base * (time - start_time)/(final_time - start_time)` 缩放外载,并在 step 结束或失败 返回前恢复原始 `load_factor`。因此 `*CLOAD`、`*DLOAD` 和非零 `*BOUNDARY` 幅值既保留各自 amplitude,又随静力 continuation 分步进入残差;线性静力和 动力默认 `load_factor = 1`,行为不变。 若控制量 `static_ramp_load` 关闭,非线性静力增量不再按伪时间缩放 `load_factor`,而是在每个子步使用进入求解器时的基准外载因子。该路径用于 强度折减的固定外载材料 continuation:阶段 A 使用常规外载 ramp 建立完整重力 平衡,阶段 B 保持 `load_factor = 1`,只改变材料强度折减因子并重新求平衡。 普通静力非线性输入默认保持 `static_ramp_load = .true.`。 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 线性系统: ```text A x = b ``` 分发层根据控制参数选择内部 CG、BiCGSTAB、GMRES 或 DENSE 路径。第五版当前模块 不引入第三方稀疏求解器库,也不把外部求解器进程作为生产验收后端。外部 求解器 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、Gauss-Seidel 和 ILU0。Jacobi 预条件器提取 CSR 对角项,求解时使用 `z_i = r_i / A_ii`;若对角项近零则保留未缩放残差 分量,避免除零。Gauss-Seidel 和 ILU0 当前用于非对称 Krylov 路径;CG 对 非对称预条件器会返回明确配置错误。DENSE 路径忽略预条件器。 CG 用于对称正定系统,采用标准三项递推,收敛判据为残差范数小于调用方给定 容限。BiCGSTAB 用于非对称系统,使用固定初始影子残差,检测 `rho`、 `alpha` 和 `omega` breakdown,并把 breakdown 或未收敛状态写入线性求解器统计。 GMRES 用于非对称 CSR 系统。当前实现采用未重启 Arnoldi 过程,最多构造 `max_iter` 个 Krylov 基向量: ```text 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 最小二乘问题: ```text 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 等预条件策略,但不引入第三方稀疏求解器依赖。 DENSE 是内部 fallback 直接路径,不是外部 sparse-direct 后端。它先把 CSR 矩阵转换为 dense 矩阵,再用部分主元高斯消元求解: ```text P A = L U U x = L^{-1} P b ``` 该路径主要用于小中型回归矩阵、非线性修正诊断和 Krylov breakdown 后的内部 兜底。若发现奇异主元,求解器返回失败状态而不是静默修改物理模型。 非线性 Newton 修正方程可在配置的 CG 路径失败后执行内部 fallback 链。求解器 先恢复修正向量,再依次尝试 GMRES、BiCGSTAB、DENSE;若 dense pivoting 仍因 奇异主元失败,则只在本次非线性修正矩阵上施加有界对角正则化 `K_reg = K + lambda I` 并重试 DENSE。该正则化只服务于求解修正方向,之后仍由 原非线性残差、trust/line-search 和 cutback 判据接受或拒绝增量;用户配置的 线性求解器 method/preconditioner 在 fallback 后恢复。 线性求解器统计包括最近一次 method、preconditioner、迭代数、最终残差和状态码。 静力、隐式 Newmark 和非线性 Newton 修正方程均通过该分发层,保证 C ABI 与 测试可以统一查询求解器行为。 ### 16.5 线性屈曲和内部特征值算法 第五版增加小规模线性屈曲支撑模块,用于验证静力预载后的几何刚度和广义 特征值求解路径。线性屈曲采用如下形式: ```text K phi = lambda K_G phi ``` 其中 `K` 是线性或切线刚度,`K_G` 是单位参考轴力或预载应力形成的几何刚度。 若单元几何刚度采用压缩负号约定,调用方应先通过几何刚度符号 helper 转换为 正的屈曲参考矩阵。模态向量按几何刚度归一化: ```text phi^T K_G phi = 1 ``` 内部广义特征值求解器只面向小规模验证矩阵。`eig_generalized_spd` 要求 `K_G` 为对称正定矩阵,先做 Cholesky 分解: ```text K_G = L L^T C = L^{-1} K L^{-T} ``` 再对对称矩阵 `C` 执行 Jacobi 旋转特征值求解,最后将模态回代到原始自由度并 做 `K_G` 归一化。模态残差按 ```text r = K phi - lambda K_G phi ||r|| / max(1, ||K phi||, |lambda| ||K_G phi||) ``` 输出。`buckling_dense_solve` 根据自由度规模扩展 Jacobi 最大旋转次数,避免 中等小矩阵因固定迭代预算过低而误报不收敛。该路径不依赖第三方特征值库或 外部求解器。 Euler pinned-pinned column 解析基准使用 ```text 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 使用十六扇区周期化的紧凑约化模型。该模型从参考 波纹锥壳的半径、高度、厚度和材料尺度构造周期刚度与几何刚度: ```text K_ii = k0 + 2 kc K_i,i+1 = -kc KG_ii = g0 + 2 gc KG_i,i+1 = -gc ``` 并在首尾扇区周期连接。全模型通过 `buckling_dense_solve` 直接求解,循环扇区 等效结果按波数 `m` 的相位 ```text 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 内激活贡献的最大穿透量: ```text g_res = max(max(-g_n, 0)) ``` - 当前增强罚函数采用接触对级标量乘子,而不是完整 mortar 积分点 Lagrange multiplier。法向接触压力为: ```text p_n = k_n * max(-g_n, 0) + lambda_n ``` - 每次接触力评估后,对 active pair 更新: ```text 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 极限使用平滑因子: ```text F_t_limit = mu * F_n * tanh(s_eq / s_reg) s_eq = max(|Delta s_t|, |F_t_trial| / k_t) ``` - 滑移分支的摩擦耗散功估计为: ```text 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 下的积分点槽求和得到。 第五版 0.5.1 增加 mortar/AL 工程化审计入口。`contact_multiplier_audit` 检查 contact multiplier 槽数、active/released/open 状态数、重复键、非法状态、 最大乘子、最大 trial gap 和 ```text max |lambda_trial - lambda_committed| ``` 用于确认 restart 写读和 commit 后状态一致性。`CONTACT_MULTIPLIER` restart 段 保存每个积分点乘子键、状态、已提交乘子和 trial gap;读入时恢复 `trial_lambda = lambda`,因此审计中的 commit/trial 差异应为零。 `mortar_tan_audit_matrix` 对局部 mortar tangent 执行矩阵级审计。对局部矩阵 `K_m`,先检查行和、列和的无刚体力平衡: ```text max_i |sum_j K_m(i,j)| <= tol max_j |sum_i K_m(i,j)| <= tol ``` 再对三个刚体平移向量 `u_tx/u_ty/u_tz` 检查 ```text max |K_m u_t| <= tol ``` 并记录非对称量 `max |K_m - K_m^T|` 和能量 probe `0.5 d^T K_m d`。stick 模式要求矩阵对称;slip 模式可因摩擦耦合出现非对称 切线,但仍应保持行列平衡和刚体平移残差为零量级。该审计是 0.5.1 对 一致切线工程化的可验证增量,不等价于完整工业级 augmented Lagrangian 一致切线完成。 第五版 V5.6 增加刚体辊滚压运动学 helper。圆柱辊接触点的表面速度由平动和 角速度共同决定: ```text 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 使用正则化切向牵引: ```text 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: ```text epsilon_x(z, x) = z kappa(x) kappa(x) = kappa_target w(x) ``` 每个增量用横向应力为零的局部 Newton 修正求平面应力近似,再累计 `statev(1)` 等效塑性应变、`statev(22)` 最近塑性增量和 `statev(21) * statev(22) * volume` 形式的塑性功指标。成形后以截面弯矩 ```text M = Sum sigma_x z A_point ``` 作为卸载平衡量,通过二分求释放曲率 `kappa_release`,使卸载后残余弯矩接近 零。残余曲率和回弹位移指标为: ```text 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 使用双线性牵引-分离模型描述粘附、损伤和完全脱粘。法向 开口只取拉开部分进入有效分离,切向滑移以三维向量范数进入混合模态: ```text 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 型起始分离插值得到: ```text 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) ``` 混合模态断裂能使用幂指数插值: ```text 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) ``` 损伤变量由历史最大有效分离驱动,并强制不可逆: ```text 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 为: ```text 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` 个同心环,每个环面积为: ```text A_i = pi (r_{i+1}^2 - r_i^2) ``` 位移历史分为压入、卸载和拉脱三段。压入段给定负法向开口,拉脱段给定正开口, 边缘环通过半径系数获得更大的拉开量和切向滑移: ```text 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。法向反力为 ```text 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 形式: ```text 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) ``` 颗粒-颗粒接触由两球中心距离给出: ```text 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 ``` 法向弹簧阻尼和正则化切向摩擦力为: ```text 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 诊断保存: ```text 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` 将上述诊断转换为验收使用的质量、动量、 动能、步耗散能和最大重叠,其中: ```text 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` 步的生产路径为: ```text 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 path、case summary 与总 summary,为边坡安全 系数和 Mohr-Coulomb 强度折减 benchmark 提供可复现的验收指标。PDF 坡体基准还 检查 4 个坡角、2 个材料工况的 FOS 曲线单调性、Davis B/关联材料对比、塑性区 探针和位移停止准则。真实结构级 trial 链以 `--nonlinear-chain` 显式启用, 输出 `strength_reduction_nonlinear_chain.csv` 和 `strength_reduction_nonlinear_summary.csv`。默认 method 1 采用两阶段 load-strength continuation:阶段 A 随非线性静力增量缩放外载并收敛 `F = 1.0` 完整重力状态;阶段 B 固定外载并把材料强度折减因子推进到 trial factor。该链 记录 continuation method、cutback、accepted time、位移修正、直接位移控制 path 诊断、MC 子步/分支聚合诊断和线性求解诊断。当前 该链是求解诊断和后续 continuation 验收入口。NC-2 目标 Newton 步长控制和 NC-3 trust-region damped Newton 已进入生产非线性静力路径,并在 chain/cloud/progress CSV 中输出相应诊断;0.75 m 临界失稳位移/eqps cloud 属于后续 longrun/研究验证,不作为 V5 PASS 条件。 ## 20. 0.5.3 Diagnostic Algorithms 0.5.3 adds diagnostic algorithms around existing nonlinear and contact paths: - Nonlinear failure taxonomy maps known cutback/Newton/linear-solver/contact/ material/constraint causes to stable reason ids and names while preserving existing status codes. - Residual breakdown stores total, force, contact, constraint, arc and material local-failure categories. Categories that are not assembled by a path remain zero instead of changing the older scalar residual contract. - Contact state diagnostics map current history into `open`, `closed-stick`, `closed-slip`, `closed-restick`, `separating` and `failed-projection` counts. - Contact residual diagnostics include maximum penetration, mean gap, gap L2, failed projection count, active-set flip count, slip increment/residual, friction residual, multiplier residual and augmentation/update quantities. - Tangent diagnostics remain finite-difference audits. Normal-contact, friction-stick and friction-slip branches are reported separately, with rigid translation and energy probes. This is not a complete production AL/mortar consistent tangent derivation.