Complete V5 acceptance milestone

This commit is contained in:
shenw
2026-06-26 12:54:40 +08:00
parent 26639d8dc2
commit a01a4fda24
105 changed files with 8694 additions and 8922 deletions
+397 -25
View File
@@ -527,7 +527,92 @@ Tstar = (T - Troom) / (Tmelt - Troom)
- Tstar 限制在 [0, 1]。
- 温度达到熔点附近时材料强度可降至零或触发失效,具体由材料参数控制。
### 12.5 温度效应
### 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
```
材料参数包括摩擦角 `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
```
并受残余参数下限约束。
返回映射采用工程稳健的分支式算法。剪切分支先按 Drucker-Prager 型流动
方向形成应力修正,再投影到 Mohr-Coulomb 主应力平面;张拉分支将超过
张拉强度的主应力钳制到张拉截断面;mixed 分支先执行剪切修正,再执行
张拉截断。塑性应变增量由弹性柔度对应力修正反算得到,并累计到
`statev(5:10)`。
当前算法切线是工程算法切线,而不是完整角点一致切线。shear/mixed 分支
使用基于当前分支法向的投影切线,tension 分支对切线进行截断缩放,目的
是支撑小规模隐式和结构 benchmark 的稳定迭代。完整棱边/角点一致切线
仍需在后续高保真结构验收中审计。
材料 driver 支持单步和路径更新,并记录 substep 数、limited 状态、各分支
计数、最终分支、最终屈服值、累计塑性增量、应力功和切线对角诊断。当前
材料点验收覆盖三轴压缩、三轴伸展、纯剪、张拉截断、mixed return 和
强度折减残余下限。
### 12.6 温度效应
第一版支持:
@@ -545,7 +630,7 @@ Delta_T = chi sigma_eq Delta_eqps / (rho cp)
其中 chi 为 Taylor-Quinney 系数,cp 为比热。
### 12.6 材料失效
### 12.7 材料失效
第一版支持两类失效:
@@ -808,29 +893,18 @@ V4.5 起,静力和隐式求解共享最近一次收敛诊断状态:
A x = b
```
分发层根据控制参数选择 CG、BiCGSTAB、GMRES 或外部求解器路径。第五版将
外部路径拆分为 request 诊断、内部参考 direct 后端和 file-exchange 后端:
分发层根据控制参数选择内部 CG、BiCGSTAB 或 GMRES 路径。第五版当前模块
不引入第三方稀疏求解器库,也不把外部求解器进程作为生产验收后端。外部
求解器 method、backend、外部进程交互和 C ABI 诊断接口已从核心中移除;旧
外部 method 数值在配置阶段按非法 method 处理,必须保持当前设置不变,不得
静默回退到内部求解器。
```text
CSR A, rhs b, initial x0
-> MatrixMarket / CSR arrays / FemLite vector / manifest
-> optional external command
-> FemLite solution vector
-> residual audit
```
file-exchange 后端使用显式 handoff 文件,不在核心库中直接依赖第三方 solver
头文件。命令模板在运行时展开,常用 token 包括 `{matrix}`、`{rhs}`、
`{solution}`、`{csr}`、`{manifest}`、`{nrow}`、`{nnz}`、`{tol}` 和
`{max_iter}`;`:q` 后缀表示对路径加双引号,例如 `{manifest:q}`。外部命令
返回非零状态、未写 solution 或 residual audit 不通过时,线性求解器返回明确
失败状态而不静默回退。
第五版的外部后端 registry 将 backend id、名称、可用性、能力位和不可用原因
集中管理。当前内置 `ref_direct` 与 `file_exchange` 后端声明 direct/general/SPD/
indefinite 能力;SuperLU、MUMPS 和 MKL Pardiso 作为未构建的第三方 adapter
占位,返回 `not_built` 而不是静默回退。registry 还提供 CSV/table 风格的诊断行,
用于后续 CLI、C ABI 和验收报告列出外部求解器状态。
每次通过分发层求解时,`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`;若对角项近零则保留未缩放残差分量,避免除零。
@@ -860,12 +934,93 @@ 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 或外部稀疏库预条件。
旋转更新和内部 ILU/SSOR 等预条件策略,但不引入第三方稀疏求解器依赖。
线性求解器统计包括最近一次 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 接触。
@@ -939,6 +1094,223 @@ W_fric_step += max(0, -F_t . Delta s_t)
- 接触切线的切向近似块使用同一 `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。圆柱辊接触点的表面速度由平动和
角速度共同决定:
```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. 稳定性与误差控制