Advance V5 nonlinear benchmarks and shell solver

This commit is contained in:
shenw
2026-06-27 16:43:00 +08:00
parent a2a11179d9
commit db68340aaf
84 changed files with 38720 additions and 971 deletions
+2 -2
View File
@@ -174,8 +174,8 @@
- SHOULD:线性静力学求解,方程形式为 K u = f
- SHOULD:非线性静力学求解,方程形式为 R(u) = 0
- SHOULD:隐式路径通过统一线性求解器分发层求解 CSR 方程,内部至少支持 CG、BiCGSTAB 和 GMRES。
- SHOULD:线性求解器支持 none/Jacobi 预条件选择,并可查询最近一次迭代数、残差和状态码。
- SHOULD:隐式路径通过统一线性求解器分发层求解 CSR 方程,内部至少支持 CG、BiCGSTAB、GMRES 和 dense pivoting fallback。
- SHOULD:线性求解器支持 none/Jacobi/Gauss-Seidel/ILU0 预条件选择,并可查询最近一次迭代数、残差和状态码。
- OUT OF SCOPE:当前模块不引入第三方稀疏线性求解器后端,也不提供外部求解器进程接口。
- SHOULD:隐式 Newmark + Newton 非线性动力学求解
- SHOULD:载荷步、增量步、Newton 迭代、线搜索、收敛准则、失败回退和可选步长缩减控制
+3 -2
View File
@@ -308,9 +308,10 @@ write output
第四版起,静力和隐式路径不直接绑定单一线性求解器,而是经由
`fem_linear_solver_cg.f90` 中的分发层求解 CSR 系统。分发层读取
`fem_control` 中的 method/preconditioner 设置,当前内部支持 CG、
BiCGSTAB 和 GMRES,支持 none/Jacobi 预条件,并把最近一次 method、
BiCGSTAB、GMRES 和 dense pivoting fallback,支持
none/Jacobi/Gauss-Seidel/ILU0 预条件,并把最近一次 method、
preconditioner、迭代数、残差和状态码写回控制模块供 Fortran API、C ABI
和测试查询。分发层不包含外部求解器 adapter;非 CG/BiCGSTAB/GMRES 的
和测试查询。分发层不包含外部求解器 adapter;非 CG/BiCGSTAB/GMRES/DENSE 的
method 值在配置阶段返回错误,并保持当前设置不变。
第五版起,solver 层增加小规模内部特征值和线性屈曲支撑。`fem_eigensolver`
+61 -5
View File
@@ -42,6 +42,7 @@ src/element/fem_shape_solid.f90
src/element/fem_shape_shell.f90
src/element/fem_element_solid.f90
src/element/fem_element_shell.f90
src/element/fem_shell_corotational.f90
src/element/fem_element_driver.f90
src/boundary/fem_boundary.f90
src/coupling/fem_sph_coupling.f90
@@ -557,8 +558,13 @@ end subroutine
- 不写输出文件。
- 不在材料点更新中控制结构级强度折减 bracket;结构 trial 指标应通过
`fem_strength_reduction_driver` 记录和判定。
- Mohr-Coulomb 当前提供工程算法切线;若修改角点/棱边返回映射,必须同步更新
`material_mohr_coulomb`、`material_mc_driver`、算法文档和材料点验收。
- Mohr-Coulomb 当前提供活动集算法一致切线;若修改 shear、tension 或 mixed
角点返回映射,必须同步更新 `material_mohr_coulomb`、`material_mc_driver`、
算法文档、材料点有限差分切线审计和结构 benchmark 诊断。
- `METHOD=MC_SUBSTEPPING_SEMISMOOTH` 的生产路径由材料分发层在
`MOHR_COULOMB` 更新时调用 `fem_material_mc_driver`。该路径使用 `fem_control`
中的 MC 子步控制量,并把聚合诊断写入 `statev(27:32)`;benchmark 工具只允许
读取这些诊断,不得实现替代材料积分。
## 11. 形函数与积分模块
@@ -691,6 +697,36 @@ V4.7 壳稳定与塑性验证增强:
- 壳 J2 内力路径将膜应变、横向剪切应变和 `0.5 * thickness * bending strain` 外纤维弯曲近似组合成代表性三维小应变,用于触发弯曲/剪切塑性状态更新,并将弯曲应变写入 `statev(13:15)`。
- 当前弯曲塑性是代表性外纤维近似,不是完整厚度方向 section integration;后续若引入多层壳积分点,应保持 trial/rollback 和 section tangent 接口兼容。
V5.11 S4 corotational 几何非线性基础路径:
- `fem_shell_corotational` 提供 S4 reference/current local frame、deformational
local translations 和刚体转角扣除。该模块只服务生产单元内力/刚度路径,不属于
benchmark-only 工具。
- `fem_control%shell_geometric_nonlinear` 由 `*NONLINEAR CONTINUATION` 的
`SHELL_GEOMETRIC`、`GEOMETRIC_SHELL`、`COROTATIONAL_SHELL` 或
`S4_COROTATIONAL` 布尔项控制;方法 4 也会通过
`shell4_corotational_enabled()` 选择该路径。
- `fem_element_internal` 在 S4 内力计算时使用 corotational kinematics;纯刚体运动
应产生零或近零 section strain/internal force。
- `fem_element_stiffness` 在弹性 S4 corotational 路径中通过中心有限差分生产
内力向量形成 algorithmic tangent。该切线直接近似 `dF_int/du`,不强制对称化;
非线性求解器可通过 GMRES/BiCGSTAB/dense fallback 处理非对称修正矩阵。
- 若 S4 corotational 刚度遇到 `J2`、`J2_JC` 或其他非 `ELASTIC` 壳材料,当前
生产路径返回材料错误,而不是静默回退到旧工程切线。塑性/多层壳 algorithmic
tangent 完成前,不能把这些材料组合列为 V5.11 后屈曲支持项。
- S4 corotational 几何刚度使用 prestress-delta 口径:已有独立膜应力结果量减去
当前弹性膜内力对应的膜结果量后,再加入局部 `u/v/w` 平动块的几何刚度。这样
预应力会影响几何刚度,普通弹性膜响应不会被重复计入初应力项。
- `fem_dload_tangent` 在 solver 层装配 shell `DLOAD P` 的 current-geometry
follower-pressure tangent,并由 `fem_solver_implicit` 的非线性静力/Newmark
外部切线入口调用。当前壳路径仍不等价于完整后屈曲求解链:塑性/多层壳
algorithmic tangent、完整弯曲/剪切初应力项、全部 follower-load 类型和
Riks/arc-length 增广方程仍未完成。
- 维护该路径时必须同步运行 `test_shell_internal` 的刚体对象性、小转角一致性、
algorithmic tangent 有限差分列、非弹性壳材料显式拒绝检查、`test_shell_pressure`
的 follower-pressure tangent 有限差分检查,以及 `test_implicit_inp` 的 INP
开关解析检查。
## 14. 边界与载荷模块
模块:fem_boundary.f90
@@ -972,8 +1008,25 @@ end subroutine
- Robin、MPC、刚性平面 penalty contact 和面-面 contact pair 的切线进入 Newton 有效刚度。
- 静力和非线性 Newmark 均支持线搜索;可选步长缩减在失败时恢复增量起点状态后重试。
- V4.5 起,`fem_control` 保存最近一次求解收敛快照、relative residual、contact gap residual、combined norm、cutback 诊断、最后有效时间和失败原因码,供 Fortran API、C ABI 和测试直接查询。
- V4.6 起,隐式求解器通过线性求解器分发层求解 CSR 方程;默认 CG + Jacobi,可切换 BiCGSTAB/GMRES + none/Jacobi,并记录最近一次线性求解方法、预条件器、迭代数、残差、矩阵分类和状态。
- V4.6 起,隐式求解器通过线性求解器分发层求解 CSR 方程;默认 CG + Jacobi,可切换 BiCGSTAB/GMRES/DENSE + none/Jacobi/Gauss-Seidel/ILU0,并记录最近一次线性求解方法、预条件器、迭代数、残差、矩阵分类和状态。
- V4.7 起,壳 drilling/S3 剪切锁定参数可配置并提供稳定性统计;壳 J2 剪切和代表性弯曲塑性路径纳入 trial/rollback 回归。
- V5.4 起,`*NONLINEAR CONTINUATION` 的方法选择和 NC-2/NC-3/NC-4 控制量保存在
`fem_control`,由 `fem_inp_helpers` 解析。`fem_solver_implicit` 的非线性静力
主路径负责目标 Newton 自适应步长、trust-region 修正裁剪、residual-merit
damping、trust radius 更新、直接位移控制 accepted-path 记录和 rollback/cutback
交互;benchmark 工具只能读取并输出这些生产诊断,不能实现替代求解算法。
NC-4 当前完成的是直接 prescribed-displacement continuation 路径:accepted
increment 收敛后,求解器在恢复 step 级 `load_factor` 前记录与实际边界条件一致的
`load_factor * amplitude * value`、约束残差、反力和收敛状态。完整弧长/Riks
增广未知量和约束切线仍为后续工程项。V5.11 新增的 S4 corotational 基础由
`fem_shell_corotational`、`fem_element_internal`、`fem_element_stiffness` 和
`fem_dload_tangent` 共同实现;修改 `SHELL_GEOMETRIC` 或算法切线语义时必须同步
更新 INP 解析、算法文档、用户手册、spherical-cap checker 和 shell
internal/implicit input 回归。
- V5.4 的 NC-5 路线已把 Mohr-Coulomb 局部子步接入生产材料分发;`fem_control`
保存 `MC_MIN_SUBSTEPS`、`MC_MAX_SUBSTEPS`、`MC_TARGET_STRAIN`、`MC_YIELD_TOL`
和 `MC_PLASTIC_LIMIT` 控制量,`statev(27:32)` 保存子步聚合诊断。结构级
substep 汇总和 0.75 m PDF longrun 效果证明仍为后续工程项。
- V5.5 起,`fem_eigensolver` 提供内部 dense 对称 Jacobi 特征值求解和 SPD 广义特征值变换,`fem_buckling_solver` 提供线性屈曲 dense solve、几何刚度符号处理、Euler 柱解析临界载荷和模态参与系数 helper。该路径用于小规模解析/工程 benchmark,不依赖第三方特征值库或外部求解器。`buckling_dense_solve` 的 Jacobi 迭代预算随自由度规模增长,避免小型工程矩阵被固定旋转次数误截断。
线性屈曲支撑模块:
@@ -1009,8 +1062,11 @@ V4.6 线性求解器抽象仍位于 `fem_linear_solver_cg.f90`,保留 `linear_
- `linear_solver_solve`:根据 `fem_control` 中的 `linear_solver_method / linear_precond_method` 分发。
- `linear_bicgstab_solve`:用于非对称或非正定 CSR 小系统的内部备用路径。
- `linear_gmres_solve`:用于非对称 CSR 小系统的内部 Krylov 路径,构造 Arnoldi Hessenberg 基并求解小型最小二乘修正。
- `linear_dense_solve`:用于小中型回归矩阵和非线性修正 fallback 的内部 dense
pivoting 路径,由 CSR 转换为 dense 矩阵并做部分主元高斯消元,不依赖外部库。
- `linear_solver_configure / linear_solver_get_settings / linear_solver_get_stats / linear_solver_get_diagnostics`:配置和查询当前/最近一次线性求解器状态、CSR 矩阵分类、初始残差、最终残差和最终相对残差。
- 分发层不包含外部求解器 adapter。非 CG/BiCGSTAB/GMRES 的 method 值在配置阶段返回错误,并保持当前设置不变。
- 分发层不包含外部求解器 adapter。非 CG/BiCGSTAB/GMRES/DENSE 的 method
值在配置阶段返回错误,并保持当前设置不变。
## 18. 输出模块
@@ -1115,7 +1171,7 @@ femlite input.inp --dt 1.0e-8 --time 1.0e-4 --output-interval 10
```text
femlite input.inp --static-linear
femlite input.inp --static-nonlinear --max-increment 20 --max-iter 25 --tol 1.0e-6
femlite input.inp --static-nonlinear --allow-cutback --max-newton 80 --newton-tol 1.0e-4
femlite input.inp --implicit-newmark --dt 1.0e-5 --time 1.0e-2
femlite input.inp --implicit-newmark-nonlinear --dt 1.0e-5 --time 1.0e-2
```
+226 -11
View File
@@ -407,6 +407,75 @@ epsilon_rep = [eps_m1 + h/2 kappa_1,
其中 `h` 为壳厚度,`eps_m` 为膜应变,`kappa` 为弯曲曲率,`gamma_13/gamma_23` 为横向剪切工程应变。该代表性应变进入已有小应变 J2/J2_JC 返回映射,用于触发膜、剪切和弯曲塑性状态更新;弯矩由外纤维应力按 `h^2 / 6` 近似映射回 section resultant。该方法不是完整厚度方向积分,后续多层 section integration 需要替换此近似并保持 trial/rollback 语义。
V5.11 的 S4 几何非线性基础路径采用 opt-in corotational kinematics。若输入在
`*NONLINEAR CONTINUATION` 中设置 `SHELL_GEOMETRIC=YES`,或 continuation 方法为
`ARC_LENGTH_OR_DISPLACEMENT_CONTROL`,S4 内力与刚度装配先由参考构型节点坐标
`X` 和当前构型 `x = X + u` 构造局部基:
```text
E_ref = [e1_ref, e2_ref, e3_ref]
E_cur = [e1_cur, e2_cur, e3_cur]
R_cr = E_cur E_ref^T
```
平动自由度投影到当前局部基后扣除参考局部坐标,得到 deformational local
translations;转角自由度先投影到当前局部基,再减去由 `R_cr` 提取的刚体转动向量。
因此纯刚体平移/转动不会在 S4 section 应变中产生虚假内力。弹性 S4
corotational 刚度使用生产内力向量的中心有限差分 algorithmic tangent:
```text
K_int[:, j] = (F_int(u + h_j e_j) - F_int(u - h_j e_j)) / (2 h_j)
h_j = 1.0e-7 max(1, |u_j|)
```
其中 `F_int` 使用同一 corotational 内力例程、同一 section 刚度和同一 drilling
稳定项。该切线近似当前残差导数,不进行人工对称化,因此在 finite-rotation
corotational frame 中可以是非对称矩阵。非线性求解器的线性修正路径通过
GMRES/BiCGSTAB 和内部 dense pivoting fallback 支持这种非对称切线。该
algorithmic tangent 当前只对 `ELASTIC` S4 壳材料开放;若材料为 `J2`、`J2_JC`
或其他非弹性壳模型,刚度装配返回材料错误,避免将旧工程切线误当作完整
corotational plastic tangent。
若已有膜应力结果量
```text
N = [[N_xx, N_xy],
[N_xy, N_yy]]
```
则 S4 corotational 切线还加入局部平动自由度的 prestress-delta 几何刚度。实际
进入几何刚度的是独立存储的膜结果量与当前弹性内力对应膜结果量之差:
```text
N_geo = N_stored - N_elastic(u)
K_geo,ij = integral (grad N_i)^T N_geo (grad N_j) dA
```
该项同时作用于局部 `u/v/w` 平动块,并随当前局部基变换到全局坐标。采用
prestress-delta 口径后,外部预应力会驱动几何刚度,普通弹性膜响应不会在
algorithmic tangent 之外再次被初应力项重复计入。
对于壳 `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`。当前实现已经具备弹性 S4 corotational algorithmic tangent
和壳压力 follower tangent,但仍不是完整 Shell-4/8/16 后屈曲求解链:塑性/多层
section algorithmic tangent、完整弯曲/剪切初应力项、全部 follower-load 类型、
Riks/arc-length 增广方程和 `-6.2 m` PDF 路径收敛仍需在 V5.11 后续项中完成。
S4 删除默认规则:
```text
@@ -581,6 +650,12 @@ 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`、张拉强度
@@ -596,21 +671,104 @@ 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
continuation 的生产路径记录。对每个收敛的非线性静力 accepted increment,求解器在
恢复 step 级 `load_factor` 前,用实际求解中施加的
`u_prescribed = load_factor * amplitude(t) * boundary_value` 作为控制约束目标,并记录
控制参数 `time`、控制 DOF 数、目标位移 L2/max、实际位移 L2/max、全部 Dirichlet
约束残差 L2/Linf、控制 DOF 反力和广义反力、累积广义功、Newton 迭代数、残差和状态码。
该路径用于直接位移控制 benchmark 和后处理曲线输出;完整 Riks/arc-length 增广方程
仍需后续实现扩展未知量、约束切线和非单调路径切换。
`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)`。
当前算法切线是工程算法切线,而不是完整角点一致切线。shear/mixed 分支
使用基于当前分支法向的投影切线,tension 分支对切线进行截断缩放,目的
是支撑小规模隐式和结构 benchmark 的稳定迭代。完整棱边/角点一致切线
仍需在后续高保真结构验收中审计。
Mohr-Coulomb 切线采用活动集算法一致切线。若当前状态为弹性,返回弹性
切线;若当前状态为 shear、tension 或 mixed,则固定对应活动分支并对
实际返回映射求局部 Jacobian:shear 分支沿剪切返回加 Mohr-Coulomb 平面
投影,tension 分支沿张拉截断,mixed 分支沿剪切返回后张拉截断的角点路径。
该矩阵允许非对称,适配非关联流动和角点活动集。材料点测试使用小扰动
有限差分审计 `D_alg * Delta epsilon` 对实际返回映射应力增量的预测误差。
0.75 m 文献全模型的长 continuation 仍需用该切线继续做结构级路径验收。
材料 driver 支持单步和路径更新,并记录 substep 数、limited 状态、各分支
计数、最终分支、最终屈服值、累计塑性增量、应力功和切线对角诊断。当前
材料点验收覆盖三轴压缩、三轴伸展、纯剪、张拉截断、mixed return 和
强度折减残余下限。
材料点验收覆盖三轴压缩、三轴伸展、纯剪、张拉截断、mixed return、
shear/tension/mixed 活动集切线审计和强度折减残余下限。
### 12.6 温度效应
@@ -800,9 +958,22 @@ for each load increment:
- 残差使用当前位移下的非线性内力 `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` 当前在同一生产路径内输出直接
位移控制 accepted-increment path、约束残差和反力;`METHOD=MC_SUBSTEPPING_SEMISMOOTH`
在生产材料分发内启用 Mohr-Coulomb 局部子步与活动集诊断,不依赖 benchmark-only 代码。
- `SHELL_GEOMETRIC=YES` 可在非线性静力路径中打开 S4 corotational kinematics;
方法 4 会默认使用同一 S4 路径。该开关当前包含弹性 algorithmic tangent、
prestress-delta 膜几何刚度和壳压力 follower tangent,但不代表完整 Riks/arc-length
方程、塑性/多层壳切线或 Shell-4/8/16 postbuckling 验收已经完成。
第三版隐式动力算法采用 Newmark + Newton。
@@ -856,6 +1027,18 @@ 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 迭代。
@@ -893,7 +1076,7 @@ V4.5 起,静力和隐式求解共享最近一次收敛诊断状态:
A x = b
```
分发层根据控制参数选择内部 CG、BiCGSTAB 或 GMRES 路径。第五版当前模块
分发层根据控制参数选择内部 CG、BiCGSTAB、GMRES 或 DENSE 路径。第五版当前模块
不引入第三方稀疏求解器库,也不把外部求解器进程作为生产验收后端。外部
求解器 method、backend、外部进程交互和 C ABI 诊断接口已从核心中移除;旧
外部 method 数值在配置阶段按非法 method 处理,必须保持当前设置不变,不得
@@ -906,8 +1089,10 @@ A x = b
残差、最终残差和最终相对残差。静力、隐式 Newmark、非线性 Newton 修正和
接触/约束切线路径只要经过 `linear_solver_solve`,都会更新同一组诊断字段。
预条件器当前支持 none 和 Jacobi。Jacobi 预条件器提取 CSR 对角项,求解时使用
`z_i = r_i / A_ii`;若对角项近零则保留未缩放残差分量,避免除零。
预条件器当前支持 none、Jacobi、Gauss-Seidel 和 ILU0。Jacobi 预条件器提取
CSR 对角项,求解时使用 `z_i = r_i / A_ii`;若对角项近零则保留未缩放残差
分量,避免除零。Gauss-Seidel 和 ILU0 当前用于非对称 Krylov 路径;CG 对
非对称预条件器会返回明确配置错误。DENSE 路径忽略预条件器。
CG 用于对称正定系统,采用标准三项递推,收敛判据为残差范数小于调用方给定
容限。BiCGSTAB 用于非对称系统,使用固定初始影子残差,检测 `rho`、
@@ -936,6 +1121,24 @@ x_k = x_0 + V_k y
求解器返回明确错误状态。后续大规模 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 与
测试可以统一查询求解器行为。
@@ -1401,5 +1604,17 @@ total_load_z、particle_force_norm 和 node_force_norm。`grain_container_summar
第五版强度折减搜索采用材料参数折减、trial 稳定性分类、上/下界 bracket 更新和
二分收敛组合。每个 trial 记录折减系数、残差、位移范数、塑性区比例、综合失稳
指标、稳定标志和搜索状态;搜索状态包括 searching、bracketed、converged、
limited 和 invalid。报告层输出 trial CSV 与 summary 行,为边坡安全系数和
Mohr-Coulomb 强度折减 benchmark 提供可复现的验收指标。
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 PDF 位移云图复现仍需 longrun 和 NC-5 局部材料
稳定化补强后才能列为 PASS。
+152 -4
View File
@@ -225,7 +225,118 @@ residual_friction_angle_deg, residual_cohesion, residual_dilation_angle_deg, red
`mat_mc_res_dilation` 和 `mat_mc_reduction`。材料模型名称写入
`mat_plastic_model='MOHR_COULOMB'`,由材料分发层进入 Mohr-Coulomb 更新和切线路径。
### 8.2 Benchmark 工具输入子集
### 8.2 非线性 continuation 方法选择
第五版 0.5.2 开始支持 FemLite 扩展关键字:
```inp
*NONLINEAR CONTINUATION, METHOD=value, TARGET_NEWTON=n, GROWTH=g, SHRINK=s,
TRUST_RADIUS=r, TRUST_MIN_RADIUS=rmin, TRUST_MAX_RADIUS=rmax,
TRUST_GROWTH=tg, TRUST_SHRINK=ts, TRUST_ACCEPT_RATIO=ra, TRUST_GOOD_RATIO=rg,
MC_MIN_SUBSTEPS=nmin, MC_MAX_SUBSTEPS=nmax, MC_TARGET_STRAIN=eps,
MC_YIELD_TOL=tol, MC_PLASTIC_LIMIT=dpmax, SHELL_GEOMETRIC=YES|NO
```
该关键字为 header-only 控制项,不需要数据行。若省略该关键字,
`nonlinear_continuation_method` 默认取 `1`。`METHOD` 可使用数字或符号名:
| 数字 | 符号名 | 当前接口含义 |
|---:|---|---|
| 1 | `TWO_STAGE_LOAD_STRENGTH` | 默认路线;先收敛完整外载,再固定外载推进强度折减因子。 |
| 2 | `ADAPTIVE_TARGET_NEWTON` | 目标 Newton 迭代数自适应步长控制。 |
| 3 | `TRUST_REGION_DAMPED_NEWTON` | trust-region / damping Newton 控制。 |
| 4 | `ARC_LENGTH_OR_DISPLACEMENT_CONTROL` | 当前支持直接 prescribed-displacement accepted-path 记录;完整弧长增广方程仍在后续实现。 |
| 5 | `MC_SUBSTEPPING_SEMISMOOTH` | Mohr-Coulomb substepping / semismooth 活动集路线。 |
解析器同时接受常用短名或连字符形式,例如 `LOAD_STRENGTH`、
`TARGET_NEWTON`、`TRUST_REGION`、`ARC_LENGTH`、`DISPLACEMENT_CONTROL` 和
`SUBSTEPPING_SEMISMOOTH`。非法数字或未知名称在输入读取阶段报错,且不修改已存在的
`nonlinear_continuation_method`。
可选控制项:
| 参数 | 适用方法 | 合法范围 | 含义 |
|---|---|---|---|
| `TARGET_NEWTON` 或 `TARGET` | 2 | 正整数 | 目标 Newton 迭代数。 |
| `GROWTH` 或 `GROWTH_FACTOR` | 2 | `> 1` | 低迭代接受步后的下一步增长倍率。 |
| `SHRINK` 或 `SHRINK_FACTOR` | 2 | `(0, 1)` | 高迭代、cutback 或失败后的下一步收缩倍率。 |
| `TRUST_RADIUS` 或 `RADIUS` | 3 | `>= 0` | 初始/current trust radius;0 表示由首个修正自动初始化。 |
| `TRUST_MIN_RADIUS` 或 `MIN_RADIUS` | 3 | `> 0` | trust radius 下限。 |
| `TRUST_MAX_RADIUS` 或 `MAX_RADIUS` | 3 | `0` 或 `>= TRUST_MIN_RADIUS` | trust radius 上限;0 表示不显式封顶。 |
| `TRUST_GROWTH` 或 `TRUST_GROWTH_FACTOR` | 3 | `> 1` | 高质量残差下降后的半径增长倍率。 |
| `TRUST_SHRINK` 或 `TRUST_SHRINK_FACTOR` | 3 | `(0, 1)` | 阻尼、拒绝或低质量下降后的半径收缩倍率。 |
| `TRUST_ACCEPT_RATIO` 或 `MERIT_ACCEPT_RATIO` | 3 | `[0, 1)` | 小于该 residual merit 下降率时收缩半径。 |
| `TRUST_GOOD_RATIO` 或 `MERIT_GOOD_RATIO` | 3 | `(0, 1]` 且 `>= TRUST_ACCEPT_RATIO` | 达到该下降率且无阻尼/拒绝时增长半径。 |
| `MC_MIN_SUBSTEPS` 或 `MIN_SUBSTEPS` | 5 | 正整数 | Mohr-Coulomb 局部积分最小子步数,默认 `1`。 |
| `MC_MAX_SUBSTEPS` 或 `MAX_SUBSTEPS` | 5 | 正整数且 `>= MC_MIN_SUBSTEPS` | Mohr-Coulomb 局部积分最大子步数,默认 `64`。 |
| `MC_TARGET_STRAIN` 或 `TARGET_STRAIN` | 5 | `> 0` | 按最大应变增量选择子步数的目标应变尺度,默认 `2.5e-3`。 |
| `MC_YIELD_TOL`、`MC_YIELD_TOLERANCE` 或 `YIELD_TOL` | 5 | `>= 0` | 子步返回后正屈服残差触发 limited 状态的容差,默认 `1.0e-7`。 |
| `MC_PLASTIC_LIMIT` 或 `PLASTIC_LIMIT` | 5 | `> 0` | 单子步塑性增量触发 limited 状态的上限,默认 `5.0e-2`。 |
| `SHELL_GEOMETRIC`、`GEOMETRIC_SHELL`、`COROTATIONAL_SHELL` 或 `S4_COROTATIONAL` | 4 / S4 nonlinear shell | `YES/TRUE/ON/1` 或 `NO/FALSE/OFF/0` | 显式启用/关闭 S4 corotational 几何非线性路径;方法 4 默认也会启用该路径。 |
所有非法控制值在输入读取阶段报错,且不修改此前有效的 continuation 控制状态。
当前已完成生产输入接口、默认值、非法值校验和诊断记录。方法 1 已在
strengthReduction nonlinear chain/cloud 工作流中接入两阶段 load-strength
continuation,并通过 `static_ramp_load` 让第二阶段在固定外载下使用伪时间推进材料
强度折减因子;方法 2 已接入生产目标 Newton 步长控制;方法 3 已接入生产
trust-region damped Newton 控制;方法 4 已接入直接位移控制 accepted increment
路径记录、Fortran API 查询和 `continuation_path.csv` 输出;方法 5 已接入生产
Mohr-Coulomb 材料点子步和活动集诊断,并在 strengthReduction nonlinear
chain/cloud/progress 输出中汇总结构级 MC 子步和分支状态。0.75 m 全模型长跑仍在
NC-1/SR-1 收束中。方法 4 的完整弧长/Riks 增广求解、方法 5 的 longrun 效果证明
继续按 `docs/v5_development_plan.md` 的 NC-4 至 NC-5 实现。
当 `METHOD=MC_SUBSTEPPING_SEMISMOOTH` 时,材料点状态变量额外约定:
```text
statev(27) accepted substeps
statev(28) requested substeps
statev(29) driver status, 0 OK and 1 limited
statev(30) branch mask, elastic=1, shear=2, tension=4, mixed=8
statev(31) max positive yield residual
statev(32) max plastic increment
```
strengthReduction nonlinear chain/cloud/progress CSV 的 continuation 诊断字段包括:
```text
continuation_method,target_dt,actual_dt,next_dt,adapt_adjust,
trust_radius,next_trust_radius,damping,merit_ratio,trust_rejections,trust_adjust,
mc_points,mc_updated_points,mc_substeps,mc_requested_substeps,mc_limited_points,
mc_branch_mask,mc_max_yield,mc_max_plastic_step
```
summary CSV 还记录 `target_newton`、`growth_factor`、`shrink_factor`、
`trust_radius`、`trust_min_radius`、`trust_max_radius`、`trust_growth_factor`、
`trust_shrink_factor`、`trust_accept_ratio`、`trust_good_ratio`、`last_trust_radius`、
`next_trust_radius`、`last_damping`、`last_merit_ratio`、
`last_trust_rejections`、`last_trust_adjust`、`mc_min_substeps`、
`mc_max_substeps`、`mc_target_strain`、`mc_yield_tol`、`mc_plastic_limit`
以及同名结构级 MC 聚合字段。`mc_branch_mask` 为积分点分支 bit OR 结果:
elastic=1、shear=2、tension=4、mixed=8。
当 `METHOD=ARC_LENGTH_OR_DISPLACEMENT_CONTROL` 且存在 accepted path 数据时,标准
CSV 输出目录中会新增 `continuation_path.csv`,字段为:
```text
step,time,control_parameter,control_dof_count,
prescribed_l2,prescribed_max,actual_l2,actual_max,
constraint_residual_linf,constraint_residual_l2,
control_reaction_sum,control_reaction_generalized,control_work,
iterations,residual_norm,relative_residual,correction_norm,
status_code,failure_code
```
其中 prescribed/actual 位移使用求解时实际施加的
`load_factor * amplitude(t) * boundary_value` 口径;当前 control parameter 等于
accepted increment 的伪时间。若同时设置 `SHELL_GEOMETRIC=YES`,S4 单元使用
production corotational 几何非线性路径,包含弹性 algorithmic tangent、
prestress-delta 膜几何刚度和壳压力 follower tangent。该路径当前只支持
`ELASTIC` S4 壳材料;非弹性壳材料会返回材料错误。该开关不改变实体单元,也不表示
完整弧长/Riks 方程或完整 Shell-4/8/16 后屈曲验收已经完成。完整弧长路径后续扩展
时应保持这些字段向后兼容。
### 8.3 Benchmark 工具输入子集
`tools/benchmarks` 下的程序是验收编排工具,不属于 `fem_read_inp` 的通用
Abaqus 子集。它们可以读取小型专用输入以驱动核心模块验证,但不得把专用
@@ -447,6 +558,9 @@ end subroutine
- 隐式动力接口可复用质量矩阵、阻尼矩阵、CSR 矩阵和边界条件数据库。
- `fem_solve_static_linear` 与命令行 `--static-linear` 对应。
- `--implicit-linear` 保留为 `--static-linear` 的兼容别名。
- 命令行 `--allow-cutback`、`--max-newton n` 和 `--newton-tol value` 分别写入
`allow_step_cutback`、`max_newton_iter` 和 `newton_tol_force`,用于非线性
静力与非线性 Newmark 入口。
- `fem_run_implicit_newmark` 使用输入文件中的时间控制运行到 `time_end`。
- `fem_run_newmark_nonlinear` 使用输入文件中的时间控制运行到 `time_end`,对应命令行 `--implicit-newmark-nonlinear`。
- `fem_set_rayleigh_damping` 设置 `C = alpha_mass M + beta_stiffness K`。
@@ -714,6 +828,8 @@ end subroutine
- `iteration` 为该增量内最近一次 Newton 迭代号;求解尚未开始时为 0。
- `residual_norm` 为最近一次力残差范数。
- `correction_norm` 为最近一次位移修正范数;线性路径或尚未形成修正时为 0。
对 `METHOD=TRUST_REGION_DAMPED_NEWTON`,该值为 trust radius 和 damping 处理后
实际应用的修正范数。
- `converged` 表示最近一次记录的增量是否已满足收敛准则。
- `relative_residual_norm` 为力残差相对参考外力范数的比值。
- `contact_gap_norm` 为最近一次接触力评估中的最大 contact gap residual。
@@ -725,6 +841,33 @@ end subroutine
- `failure_code` 使用 `CONV_FAIL_NONE=0`、`CONV_FAIL_NONCONVERGENCE=1`、`CONV_FAIL_CUTBACK_LIMIT=2`、`CONV_FAIL_STOPPED=3`。
- V4.5 起,非线性静力 Newton 迭代、静力 cutback 失败路径、非线性 Newmark cutback 运行和接触力评估会更新该状态;contact gap/mortar residual 当前作为 diagnostics 进入多准则统计,硬收敛判据仍以力残差为主。
第五版 0.5.2 追加直接位移控制 continuation path 查询:
```fortran
subroutine fem_get_continuation_path_count(count, ierr)
integer, intent(out) :: count
integer, intent(out) :: ierr
end subroutine
subroutine fem_get_continuation_path_row(index, step, time, control_parameter, &
control_dof_count, prescribed_l2, prescribed_max, actual_l2, actual_max, &
residual_linf, residual_l2, reaction_sum, reaction_generalized, work, &
iteration, residual_norm, relative_residual, correction_norm, status_code, &
failure_code, ierr)
integer, intent(in) :: index
integer, intent(out) :: step, control_dof_count, iteration
integer, intent(out) :: status_code, failure_code, ierr
real(rk), intent(out) :: time, control_parameter
real(rk), intent(out) :: prescribed_l2, prescribed_max, actual_l2, actual_max
real(rk), intent(out) :: residual_linf, residual_l2
real(rk), intent(out) :: reaction_sum, reaction_generalized, work
real(rk), intent(out) :: residual_norm, relative_residual, correction_norm
end subroutine
```
`index` 从 1 开始;越界返回输入错误。当前该 API 覆盖 `METHOD=4` 的直接
prescribed-displacement accepted path,完整弧长路径后续应复用同一查询接口。
### 12.6 线性求解器控制
V4.6 提供内部线性求解器配置和最近一次求解统计查询:
@@ -766,10 +909,15 @@ end subroutine
说明:
- `method` 使用 `LSOLVER_CG=1`、`LSOLVER_BICGSTAB=2`、`LSOLVER_GMRES=3`。
- `preconditioner` 使用 `LPRECOND_NONE=0`、`LPRECOND_JACOBI=1`。
- `method` 使用 `LSOLVER_CG=1`、`LSOLVER_BICGSTAB=2`、
`LSOLVER_GMRES=3`、`LSOLVER_DENSE=4`。
- `preconditioner` 使用 `LPRECOND_NONE=0`、`LPRECOND_JACOBI=1`、
`LPRECOND_GAUSS_SEIDEL=2`、`LPRECOND_ILU0=3`;`LSOLVER_DENSE`
忽略预条件器并记录实际配置值。
- `status_code` 使用 `LS_STATUS_IDLE=0`、`LS_STATUS_CONVERGED=1`、`LS_STATUS_FAILED=-1`。
- CG 主要面向对称正定系统;BiCGSTAB 和 GMRES 可用于非对称 CSR 小系统。
- CG 主要面向对称正定系统;BiCGSTAB 和 GMRES 可用于非对称 CSR 小系统;
DENSE 是内部 dense pivoting fallback,用于小中型回归矩阵或非线性修正诊断,
不是第三方 sparse-direct 后端。
- `matrix_class` 使用 `FEMLITE_CSR_CLASS_GENERAL=1`、`STRUCT_SYM=2`、
`SYMMETRIC=3`、`SPD_CAND=4`。分发层在调用内部 Krylov 求解器前
分析 CSR 图案、对角项和数值对称性,并记录初始残差、最终残差和最终相对残差。
+22 -8
View File
@@ -60,7 +60,7 @@ Python 环境约定:
- active set、gap residual 和 augmented penalty 诊断测试。
- 摩擦正则化、摩擦功和最大累计滑移输出测试。
- 接触示例 smoke 测试应覆盖刚性平面压入、两实体块面-面压缩和壳-刚性平面接触。
- 线性求解器分发测试应覆盖 CG、BiCGSTAB、GMRES、none/Jacobi 预条件、非法 method 拒绝和最近一次求解统计。
- 线性求解器分发测试应覆盖 CG、BiCGSTAB、GMRES、DENSE、none/Jacobi/Gauss-Seidel/ILU0 预条件、非法 method 拒绝和最近一次求解统计。
- 壳 V4.7 测试应覆盖 drilling 稳定参数、S3 剪切锁定折减诊断、J2 剪切/弯曲塑性、trial/rollback 和 Scordelis-Lo 静力基准 smoke。
## 4. 测试目录结构
@@ -225,13 +225,22 @@ SPH总力映射测试 relative tolerance 1.0e-10 to 1.0e-8
- 输入解析:`*MOHR COULOMB` 参数、残余参数和强度折减系数。
- 屈服包络:弹性点、剪切屈服、张拉截断和 mixed 分支分类。
- 返回映射:三轴压缩、三轴伸展、纯剪、张拉截断和 mixed return。
- 活动集算法一致切线:shear、tension 和 mixed 分支必须用小扰动有限差分
审计 `D_alg * Delta epsilon` 对实际返回映射应力增量的预测误差。
- 状态变量:`statev(11)` 分支号、`statev(12:13)` 最终屈服值、
`statev(22)` 塑性增量和 `statev(26)` 强度折减系数。
`statev(22)` 塑性增量、`statev(26)` 强度折减系数,以及方法 5 下
`statev(27:32)` 的子步数、请求子步数、driver 状态、分支 mask、最大屈服残差和
最大塑性增量。
- 强度折减:摩擦角、黏聚力、膨胀角和张拉强度折减,并检查残余参数下限。
- driver 诊断:substep 数、limited 状态、branch count、final branch、
final yield values、plastic total 和 tangent 对角诊断。
- 生产分发:`METHOD=MC_SUBSTEPPING_SEMISMOOTH` 必须让 `MOHR_COULOMB` 材料点通过
`fem_material_mc_driver` 更新;默认方法和其他方法仍保持单步更新并写一致诊断。
- 容限:返回映射后的剪切屈服值不得超过 `1.0e-7 * max(1, cohesion)`,
张拉截断不得超过材料点容限;材料点测试不得出现 substep 爆炸。
- 算例验收:`examples/mohr_coulomb_yield_surface` 必须输出屈服面 CSV、
代表性应力点 CSV 和 summary,并验证压缩/伸展包络、张拉截断、强度折减
和 elastic/shear/tension/mixed 分支覆盖。
## 10. 模块测试计划
@@ -257,6 +266,11 @@ SPH总力映射测试 relative tolerance 1.0e-10 to 1.0e-8
- S3/S4/S6/S8 线性静力刚度测试。
- S4 J2/J2_JC 膜内塑性状态更新和膜内/弯曲/剪切 section tangent 对称性测试。
- V4.7 增加 drilling 稳定参数敏感性、S3 剪切锁定诊断、S4 J2 剪切塑性、代表性外纤维弯曲塑性和 trial rollback 回归。
- V5.11 增加 opt-in S4 corotational 几何非线性基础回归:刚体转动对象性、
小转角与线性 S4 一致性、弹性 algorithmic tangent 有限差分列一致性、
非对称切线可接受性、prestress-delta 膜几何刚度激活检查、shell `DLOAD P`
follower-pressure tangent 有限差分一致性检查、非 `ELASTIC` 壳材料显式拒绝检查,
以及默认线性壳路径不被该开关回退。
- Scordelis-Lo 壳静力位移基准测试。
- 板壳弯曲静力基准测试。
@@ -322,7 +336,7 @@ SPH总力映射测试 relative tolerance 1.0e-10 to 1.0e-8
- `fem_get_contact_perf_stats` 和 C ABI `femlite_get_contact_perf_stats` 返回 contact search/force/tangent CPU 时间统计。
- `fem_get_contact_cache_stats` 和 C ABI `femlite_get_contact_cache_stats` 返回 BVH 候选缓存使用和溢出统计。
- `fem_get_convergence_status` / `fem_get_convergence_metrics` / `fem_get_convergence_diagnostics` 和 C ABI 对应包装返回最近一次求解的增量、迭代、残差、相对残差、修正范数、contact gap residual、combined norm、cutback 次数、最后步长、最后有效时间、状态码、失败原因码和收敛标志;空模型零状态、非线性静力收敛状态、contact gap 非零状态和 cutback 失败状态均需覆盖。
- `fem_set_linear_solver` / `fem_get_linear_solver_settings` / `fem_get_linear_solver_stats` 和 C ABI 对应包装返回当前线性求解器、预条件器、最近一次迭代数、残差和状态;模块测试覆盖 CG、BiCGSTAB 和 GMRES,BiCGSTAB/GMRES 使用非对称小系统,`implicit_inp` 覆盖隐式路径切换到 BiCGSTAB,C ABI 覆盖切换到 GMRES + Jacobi。
- `fem_set_linear_solver` / `fem_get_linear_solver_settings` / `fem_get_linear_solver_stats` 和 C ABI 对应包装返回当前线性求解器、预条件器、最近一次迭代数、残差和状态;模块测试覆盖 CG、BiCGSTAB、GMRES 和 DENSE,BiCGSTAB/GMRES 使用非对称小系统,DENSE 使用非正定小系统,`implicit_inp` 覆盖隐式路径切换到 BiCGSTAB,C ABI 覆盖切换到 GMRES + Jacobi。
- 删除单元状态可输出。
示例结果留存策略:
@@ -367,12 +381,12 @@ SPH总力映射测试 relative tolerance 1.0e-10 to 1.0e-8
检查 `contact_multiplier_audit`、`mortar_tan_audit_matrix`、
`contact_mult_report_summary`,并用 OpenMP 1/4 线程 contact/performance
smoke 防止接触统计在并行路径回退。
- V5.4 新增 `example_strength_reduction_benchmark`:运行 `examples/strengthReduction` 的 Mohr-Coulomb 坡体输入,并调用 checker 生成和检查安全系数 history、summary、塑性区、位移探针、VTK 和节点输出;当前参考为 `FS=1.21125`、8 个 trial、3 个 stable trial、5 个 unstable trial 和 2 个 active plastic probes。
- V5.4 新增 `example_strength_reduction_benchmark`:运行 `examples/strengthReduction` 中按 `models.geomech.strength_reduction_method.pdf` 生成的 0.75 m 网格 C3D8 Mohr-Coulomb 坡体输入,并调用 checker 生成和检查 `strength_reduction_path.csv`、`strength_reduction_cases.csv`、summary、塑性区和位移探针;checker 同时验证输入记录 `CONFORMING_INTERFACE=YES`,并检查 `z=H1`、`x>=L2` 的上下土体界面节点被 lower/upper 元素共享。当前 FOS 参考为 8 个 PDF 工况全部收敛、最大 FOS 误差 `6.9392E-03`、86 个 trial、52 个 stable trial 和 34 个 unstable trial。可选 `--nonlinear-chain` 输出会检查 `continuation_method`、`last_dt`、`accepted_time`、`correction_norm`、目标/实际/下一 continuation 步长、adaptive adjust、trust radius、damping、merit ratio、trust rejection count、线性迭代数、线性残差和线性状态列;method 1 的两阶段 load-strength continuation 通过小参数 chain/cloud smoke 验证输出路径,NC-2 目标 Newton 步长控制和 NC-3 trust-region damped Newton 已由 `solver_implicit`、`implicit_inp` 与本 example checker 覆盖,目标 cloud 的中等 0.75 m 探针仍超过 120 s,PDF 位移云图 material case 2、`alpha=45 deg`、`FOS=1.525` 的 0.3 m 量级结果尚未作为 CTest 验收项。
- V5.5 新增 `example_euler_column_buckling_benchmark`:运行 `examples/euler_column_buckling` 的 Euler pinned-pinned column 输入,并调用 checker 生成和检查 `buckling_summary.csv` 与 `buckling_mode_1.csv`;当前参考为一阶临界载荷相对误差 `3.27660856E-05`、残差 `1.50014805E-11` 和 `phi^T K_G phi = 1.0`。
- V5.5 新增 `example_buckling_corrugated_shell_benchmark`:运行 `examples/buckling_corrugated_shell` 的紧凑循环波纹壳屈曲输入,并调用 checker 生成和检查 summary、wave sweep、modal CSV 和 profile;当前参考为 selected wave 4 load `453.031407`、critical wave 8 load `393.369677`、循环/全模型相对误差 `1.25473461E-16` 和 modal residual `1.31855319E-12`。
- V5.6 新增 `example_roll_forming_kinematics_benchmark`:运行 `examples/roll_forming` 的 roller kinematics 输入,并调用 checker 生成和检查 `roller_kinematics_history.csv` 与 summary;当前参考为 mean slip `0.4` with spin vs `0.2` without spin、mean traction `289.208274` with spin vs `228.478247` without spin、max traction delta `60.7300272` 和 positive torque `14.4604137`。
- V5.6 新增 `example_roll_forming_springback_benchmark`:运行 `examples/roll_forming` 的 springback 输入,并调用 checker 生成和检查 `springback_history.csv`、`springback_summary.csv` 与 `plastic_zone.csv`;当前参考为 springback ratio `0.473154068`、residual displacement `0.0316107559`、plastic work `1.11591736e-05`、56/81 个 active plastic points 和 residual moment 绝对值 `8.92778801e-11`。
- 已接入 `example_smoke` CTest 分组:shell patch S3/S4 静力 smoke、Scordelis-Lo S3/S4 静力 smoke、clamped square plate pressure pulse S4 短步数动力 smoke、rigid sphere impact plate S3/S4 短步数动力 smoke、contact two blocks nonmatching benchmark、contact block sliding large-sliding benchmark、shell-shell contact benchmark、shell-solid contact benchmark、Mohr-Coulomb strength reduction benchmark、Euler column buckling benchmark、corrugated shell cyclic buckling benchmark、roll forming kinematics benchmark、roll forming springback benchmark、ball adhesion cohesive benchmark、dynamic grain container particle benchmark、elliptic membrane、membrane uniaxial、shell-solid connection、golf ball impact、node analytical contact、block-on-arch、cylinder roller contact、sliding wedge、roll forming friction smoke、falling objects、ball adhesion contact、dynamic grain container pressure smoke、thick plate、membrane airbag、spherical cap、blasting rock、nonlinear harmonic、layered shell、two arches、pinched hemisphere 和 stress dependent elasticity smoke;接触类 smoke 检查 active contact,摩擦滑移类 smoke 检查正摩擦耗散,壳/静力基准 smoke 通过节点位移探针检查方向和最小量级,屈曲 benchmark 检查特征值、残差和模态输出,滚压 benchmark 检查旋转对 slip/traction/energy/torque 以及 J2 塑性区/回弹指标的影响,cohesive benchmark 检查拉脱力、滞回、耗散能、损伤和脱粘面积,dynamic grain benchmark 检查粒子数、粒子-facet 接触、映射节点力、容器位移、质量守恒和能量。
- 已接入 `example_smoke`/`benchmark` CTest 分组:shell patch S3/S4 静力 smoke、Scordelis-Lo S3/S4 静力 smoke、clamped square plate pressure pulse S4 短步数动力 smoke、rigid sphere impact plate S3/S4 短步数动力 smoke、contact two blocks nonmatching benchmark、contact block sliding large-sliding benchmark、shell-shell contact benchmark、shell-solid contact benchmark、Mohr-Coulomb strength reduction PDF benchmark、Euler column buckling benchmark、corrugated shell cyclic buckling benchmark、roll forming kinematics benchmark、roll forming springback benchmark、ball adhesion cohesive benchmark、dynamic grain container particle benchmark、two arches reference-geometry benchmark、elliptic membrane、membrane uniaxial、shell-solid connection、golf ball impact、node analytical contact、block-on-arch、cylinder roller contact、sliding wedge、roll forming friction smoke、falling objects、ball adhesion contact、dynamic grain container pressure smoke、membrane airbag、spherical cap displacement-control benchmark、blasting rock、nonlinear harmonic、layered shell、pinched hemisphere 和 stress dependent elasticity benchmark;接触类 smoke 检查 active contact,摩擦滑移类 smoke 检查正摩擦耗散,壳/静力基准 smoke 通过节点位移探针检查方向和最小量级,two arches benchmark 通过 checker 验证 PDF 参考坐标、30/75 壳网格、1.2 mm 上拱中点位移和 active contact,strengthReduction benchmark 通过 checker 验证 PDF 几何、0.75 m 网格、8 工况 FOS 曲线、Davis B/关联材料单调性、塑性区和位移停止准则,但不验收 PDF 位移云图,屈曲 benchmark 检查特征值、残差和模态输出,滚压 benchmark 检查旋转对 slip/traction/energy/torque 以及 J2 塑性区/回弹指标的影响,cohesive benchmark 检查拉脱力、滞回、耗散能、损伤和脱粘面积,dynamic grain benchmark 检查粒子数、粒子-facet 接触、映射节点力、容器位移、质量守恒和能量。thick plate 作为独立 NAFEMS LE10 benchmark 接入 `benchmark` 标签,检查 D 点恢复应力、位移方向和压力反力平衡;spherical cap benchmark 检查 PDF 几何、16 段经向壳网格、`SHELL_GEOMETRIC=YES` 位移控制输入、冠点反力和无量纲曲线采样,可选 nonlinear route 还要求 post-peak load drop 与 restiffening 以防单调小应变曲线误判通过,但完整 Shell-4/8/16 postbuckling 路径仍需 V5.11 后续验收。
- rigid sphere impact plate 的长步数结果保留为示例复现实验。
## 11. 输入解析测试
@@ -391,7 +405,7 @@ SPH总力映射测试 relative tolerance 1.0e-10 to 1.0e-8
- *SHELL SECTION
- *BOUNDARY
- *CLOAD
- *DLOAD
- *DLOAD(壳面压力 `P`、实体体力 `GRAV`)
- *AMPLITUDE
- *STEP
- *DYNAMIC
@@ -662,8 +676,8 @@ V4.4 contact pair 性能 smoke:
- smoke 必须触发 BVH 搜索、active 接触和 BVH 候选缓存命中。
- `perf_contact_pair_omp_consistency` 通过 `tools/testing/check_perf_contact_pair_omp.py` 分别以 `OMP_NUM_THREADS=1/4` 运行同一性能 smoke,并要求 active、broad/active 候选、BVH 节点和缓存命中等非计时统计一致;该用例覆盖缩短后的 force 全局提交临界区和 tangent CSR 合并临界区。
- 可执行程序 `perf_contact_pair <facet_count> <do_tangent>` 可用于放大到中等规模专项测试;`facet_count` 必须大于 16 才能触发 BVH 路径。
- `linear_solver_cg` 和 `test_c_api` 覆盖内部 CG/BiCGSTAB/GMRES 设置、统计查询、CSR 矩阵分类诊断、非法 method 拒绝,以及旧外部 method 数值不改变现有设置。
- `solver_implicit` 和 `implicit_inp` 覆盖线性静力、隐式 Newmark 和非线性接触修正路径通过同一内部 dispatch 记录矩阵分类、初始残差、最终残差、相对残差和收敛状态。
- `linear_solver_cg` 和 `test_c_api` 覆盖内部 CG/BiCGSTAB/GMRES/DENSE 设置、统计查询、CSR 矩阵分类诊断、非法 method 拒绝,以及旧外部 method 数值不改变现有设置;`solver_implicit` 覆盖非线性修正内部 fallback 后恢复用户配置。
- `solver_implicit` 和 `implicit_inp` 覆盖线性静力、隐式 Newmark 和非线性接触修正路径通过同一内部 dispatch 记录矩阵分类、初始残差、最终残差、相对残差和收敛状态;`implicit_inp` 同时覆盖 `*NONLINEAR CONTINUATION, METHOD=value` 的默认 `METHOD=1`、数字 `1..5`、符号名、非法值拒绝和失败时状态保持,并覆盖 NC-2 的 `TARGET_NEWTON/GROWTH/SHRINK`、NC-3 的 trust radius/min/max、growth/shrink 和 merit ratio 参数,以及 `SHELL_GEOMETRIC`/`COROTATIONAL_SHELL` 等 S4 corotational 布尔开关。`solver_implicit` 覆盖 NC-2 自适应步长到达最终时间、NC-3 trust radius 限制实际修正范数、damping/merit/rejection 诊断和收敛结果;0.5.2 追加 NC-4 直接位移控制 accepted path 覆盖,验证每个 accepted increment 的控制 DOF、目标/实际位移、约束残差、反力、状态码和 Fortran API 查询。
- `strength_reduction_driver` 覆盖强度折减搜索状态机、trial 分类、bracket/convergence/limited 状态和历史查询;`strength_reduction_report` 覆盖 trial CSV、summary line 和报告文件写出。
- `eigensolver` 和 `buckling_support` 覆盖内部 dense 特征值、广义 SPD
特征值、模态残差、Euler 解析临界载荷和梁柱几何刚度;`example_euler_column_buckling_benchmark`
+86 -10
View File
@@ -19,7 +19,7 @@ FemLite 0.5.x 是船舶接触爆炸结构响应 FEM 软件的第五版开发线
- element/node/analytical surface 子集、contact property 子集、刚性平面接触和面-面 contact pair 阶段能力。
- contact pair active set、gap residual 和 augmented penalty 诊断输出。
- 静力/隐式求解的收敛状态和 cutback 诊断查询接口。
- 线性求解器可在内部 CG、BiCGSTAB 和 GMRES 间切换,并提供预条件和迭代/残差统计查询;核心模块不依赖第三方或外部稀疏求解器。
- 线性求解器可在内部 CG、BiCGSTAB、GMRES 和 dense pivoting fallback 间切换,并提供预条件和迭代/残差统计查询;核心模块不依赖第三方或外部稀疏求解器。
- CSV、VTK、restart 和 contact CSV 输出。
- Fortran95 原生接口、C ABI 子集和 Python 调试脚本。
@@ -118,6 +118,9 @@ build-win-gcc-16\femlite.exe input.inp [analysis-mode] [options]
|---|---|
| `--output-dir path` | 设置结果输出目录 |
| `--output-interval n` | 设置输出间隔;0 表示不输出步结果 |
| `--allow-cutback` | 允许非线性静力/非线性 Newmark 在不收敛时自动缩步 |
| `--max-newton n` | 设置非线性 Newton 最大迭代次数 |
| `--newton-tol value` | 设置非线性力残差收敛容差 |
示例:
@@ -151,6 +154,7 @@ FemLite 使用 Abaqus inp 风格输入文件的子集。0.4.8 常用支持项包
- `*STEP`
- `*DYNAMIC`
- `*STATIC`
- `*NONLINEAR CONTINUATION`
- `*SURFACE`
- `*SURFACE INTERACTION`
- `*CONTACT PROPERTY`
@@ -194,8 +198,73 @@ Mohr-Coulomb 输入示例:
第一行依次为摩擦角 degree、黏聚力、膨胀角 degree 和张拉强度;第二行依次为
残余摩擦角 degree、残余黏聚力、残余膨胀角 degree 和强度折减系数。材料点输出中
`statev(11)` 记录当前分支,`statev(12:13)` 记录剪切/张拉屈服值,`statev(22)`
记录最近一次塑性增量。当前结构级强度折减 benchmark 仍在 V5.4 后续项中推进。
`statev(11)` 记录当前分支,`statev(12:13)` 记录最终剪切/张拉屈服值,
`statev(22)` 记录最近一次塑性增量。若选择方法 5,`statev(27:32)` 还记录
Mohr-Coulomb 子步数、请求子步数、driver 状态、分支 mask、最大屈服残差和最大
塑性增量。结构级强度折减 benchmark 已在
`examples/strengthReduction` 中按 PDF 参考路线接入,通用非线性自动 trial
重求解仍作为后续增强。
非线性 continuation 方法选择:
```inp
*STEP
*NONLINEAR CONTINUATION, METHOD=TWO_STAGE_LOAD_STRENGTH
*STATIC
0.01, 1.0, 1.0e-5, 0.05
*END STEP
```
如果省略 `*NONLINEAR CONTINUATION`,默认使用 `METHOD=1`,即
`TWO_STAGE_LOAD_STRENGTH`。当前 `METHOD=1..5` 和对应符号名已可由 INP 解析并写入
非线性诊断;方法 1 已用于 strengthReduction 非线性 chain/cloud 的两阶段路线:
先在强度因子 `F=1.0` 下收敛完整外载,再固定外载并推进材料强度折减因子。方法
2 `ADAPTIVE_TARGET_NEWTON` 已可用 `TARGET_NEWTON`、`GROWTH` 和 `SHRINK` 控制
静力 continuation 步长;方法 3 `TRUST_REGION_DAMPED_NEWTON` 已可用
`TRUST_RADIUS`、`TRUST_MIN_RADIUS`、`TRUST_MAX_RADIUS`、`TRUST_GROWTH`、
`TRUST_SHRINK`、`TRUST_ACCEPT_RATIO` 和 `TRUST_GOOD_RATIO` 限制 Newton 修正、
执行 residual-merit damping 并输出 trust 诊断。方法 4
`ARC_LENGTH_OR_DISPLACEMENT_CONTROL` 当前可记录直接 prescribed-displacement
accepted path:每个收敛增量输出控制参数、目标/实际位移、约束残差、反力和收敛状态;
完整弧长/Riks 增广方程仍按 V5 计划中的 NC-4 继续完善。方法 5
`MC_SUBSTEPPING_SEMISMOOTH` 当前会在 Mohr-Coulomb 材料点启用局部子步和活动集
诊断;结构级 substep 汇总和 longrun 效果证明仍按 NC-5 继续完善。
方法 2 示例:
```inp
*NONLINEAR CONTINUATION, METHOD=ADAPTIVE_TARGET_NEWTON, TARGET_NEWTON=6, GROWTH=1.5, SHRINK=0.5
```
方法 3 示例:
```inp
*NONLINEAR CONTINUATION, METHOD=TRUST_REGION_DAMPED_NEWTON, TRUST_RADIUS=0.1, TRUST_MIN_RADIUS=1.0e-6, TRUST_MAX_RADIUS=1.0, TRUST_GROWTH=1.5, TRUST_SHRINK=0.5
```
方法 4 示例:
```inp
*NONLINEAR CONTINUATION, METHOD=ARC_LENGTH_OR_DISPLACEMENT_CONTROL, SHELL_GEOMETRIC=YES
```
当输出目录启用且有 accepted path 数据时,会生成 `continuation_path.csv`;库调用者
也可使用 `fem_get_continuation_path_count` 和 `fem_get_continuation_path_row`
查询同一数据。`SHELL_GEOMETRIC=YES` 显式请求 S4 corotational 几何非线性路径;
`GEOMETRIC_SHELL`、`COROTATIONAL_SHELL` 和 `S4_COROTATIONAL` 是等价别名。方法 4
本身也会默认使用该 S4 路径。当前该路径包含弹性 S4 algorithmic tangent、
prestress-delta 膜几何刚度和壳压力 follower tangent。若 S4 壳材料不是
`ELASTIC`,该路径会在刚度装配阶段返回材料错误;完整弧长/Riks 方程、
塑性/多层壳切线和完整 Shell-4/8/16 后屈曲验收仍属于后续 V5.11 工程项。
方法 5 示例:
```inp
*NONLINEAR CONTINUATION, METHOD=MC_SUBSTEPPING_SEMISMOOTH, MC_MIN_SUBSTEPS=2, MC_MAX_SUBSTEPS=64, MC_TARGET_STRAIN=1.0e-3, MC_YIELD_TOL=1.0e-7, MC_PLASTIC_LIMIT=5.0e-2
```
方法 5 只改变 Mohr-Coulomb 局部材料积分路径;若算例没有 `MOHR_COULOMB` 材料,
这些 MC 控制项不会改变弹性或 J2 材料更新。
## 8. 边界、载荷与接触
@@ -203,7 +272,8 @@ Mohr-Coulomb 输入示例:
- `*BOUNDARY`:节点或集合自由度约束。
- `*CLOAD`:集中节点力。
- `*DLOAD`:面压力等分布载荷子集。
- `*DLOAD`:分布载荷子集;`target, P, pressure` 用于壳面压力,
`target, GRAV, magnitude, gx, gy, gz` 用于实体重力/体力加速度。
- `*AMPLITUDE`:时间或增量相关幅值。
contact pair 支持两种输入方式。
@@ -262,7 +332,7 @@ kind,pair_id,active_count,max_penetration,force_norm,work_estimate,cumulative_wo
`search_*` 字段在 `SUMMARY` 行给出最近一次 contact pair 力评估的全局搜索统计、BVH 候选缓存使用情况和 `cpu_time` 口径秒数;逐 `PAIR` 行给出对应接触对的搜索、缓存和计时统计。`cpu_time` 是轻量趋势诊断,小算例中可能显示为 0。
Fortran95 API 可通过 `fem_get_convergence_status` 查询最近一次求解的增量、迭代、残差、位移修正范数和收敛标志,通过 `fem_get_convergence_metrics` 查询相对残差、contact gap residual 和 combined norm,通过 `fem_get_convergence_diagnostics` 查询 cutback 次数、最后步长、最后有效时间、状态码和失败原因码。`fem_set_linear_solver` 可选择 `CG`、`BiCGSTAB`、`GMRES` 与 `none/Jacobi` 预条件,`fem_get_linear_solver_stats` 查询最近一次线性求解迭代数、残差和状态,`fem_get_linsol_diagnostics` 查询 CSR 矩阵分类、初始残差、最终残差和最终相对残差;其他 method 值会返回错误且不会改变当前设置。V4.7 起,`fem_set_shell_stabilization` 可设置壳 drilling 系数、S3 剪切锁定折减系数和最小折减比例,默认分别为 `1.0e-4`、`0.0625`、`1.0e-4`;`fem_get_shell_stability_stats` 可查询最近壳刚度装配诊断。C ABI 提供同名 `femlite_get_*`/`femlite_set_*` 包装,`converged` 使用 0/1 整数返回。
Fortran95 API 可通过 `fem_get_convergence_status` 查询最近一次求解的增量、迭代、残差、位移修正范数和收敛标志;在 trust-region damped Newton 中,位移修正范数是半径限制和 damping 后实际应用的范数。通过 `fem_get_convergence_metrics` 可查询相对残差、contact gap residual 和 combined norm,通过 `fem_get_convergence_diagnostics` 查询 cutback 次数、最后步长、最后有效时间、状态码和失败原因码。`fem_set_linear_solver` 可选择 `CG`、`BiCGSTAB`、`GMRES`、`DENSE` 与 `none/Jacobi/Gauss-Seidel/ILU0` 预条件,`fem_get_linear_solver_stats` 查询最近一次线性求解迭代数、残差和状态,`fem_get_linsol_diagnostics` 查询 CSR 矩阵分类、初始残差、最终残差和最终相对残差;其他 method 值会返回错误且不会改变当前设置。非线性 Newton 修正若在配置的 CG 路径遇到非正定切线,可在内部 GMRES、BiCGSTAB 和 dense pivoting fallback 间自动重试,并在返回前恢复用户配置的求解器设置。V4.7 起,`fem_set_shell_stabilization` 可设置壳 drilling 系数、S3 剪切锁定折减系数和最小折减比例,默认分别为 `1.0e-4`、`0.0625`、`1.0e-4`;`fem_get_shell_stability_stats` 可查询最近壳刚度装配诊断。C ABI 提供同名 `femlite_get_*`/`femlite_set_*` 包装,`converged` 使用 0/1 整数返回。
建议把大型结果输出到 `examples/.../results/...` 或独立 `output/` 目录。仓库 `.gitignore` 默认忽略大规模结果文件。
@@ -291,13 +361,13 @@ Fortran95 API 可通过 `fem_get_convergence_status` 查询最近一次求解的
| `examples/cylinder_roller_contact` | 滚子-基础法向接触代表性 smoke |
| `examples/sliding_wedge` | 倾斜楔块摩擦滑移接触 smoke |
| `examples/membrane_airbag_inflation` | 膜气囊压力载荷 S4 动力/静力回归入口 |
| `examples/spherical_cap_with_central_point_load` | 球冠中心载荷 S4 壳静力回归入口 |
| `examples/two_arches` | 双拱壳-壳接触 smoke |
| `examples/spherical_cap_with_central_point_load` | 球冠中心载荷位移控制壳 benchmark;默认检查 Shell-16 小应变样本,附带 opt-in S4 corotational nonlinear diagnostic deck |
| `examples/two_arches` | 基于 `models.sme.two_arches.pdf` 几何的双拱壳-壳接触 benchmark |
| `examples/blasting_rock` | 花岗岩块爆破脉冲显式动力 smoke |
| `examples/nonlinear_harmonic` | 薄膜谐波压力响应显式动力 smoke |
| `examples/failure_prediction_in_a_layered_shell` | 四层共享节点壳拉伸回归入口 |
| `examples/pinched_hemispherical_shell` | pinched hemisphere S4 壳动力 smoke |
| `examples/stress_dependent_elasticity` | 分区弹性模量悬臂梁弯曲回归入口 |
| `examples/stress_dependent_elasticity` | 应力相关弹性悬臂梁纯弯矩 benchmark |
| `examples/roll_forming` | 滚压摩擦 smoke、roller kinematics benchmark 和 springback benchmark |
| `examples/falling_objects` | 多物体显式接触与刚性箱底代表性 smoke |
| `examples/ball_adhesion_decohesion` | 球-膜接触压入 smoke 和 compact cohesive 粘附/脱粘 benchmark |
@@ -311,7 +381,13 @@ Fortran95 API 可通过 `fem_get_convergence_status` 查询最近一次求解的
| `examples/shell_shell_contact` | S4-to-S4 shell-shell 接触 benchmark |
| `examples/shell_solid_contact` | S4-to-C3D8 shell-solid 接触 benchmark |
每个示例目录中的 `README.md` 给出几何、材料、边界、生成脚本和运行命令。新增基准测试应放在 `examples/` 下,并为每个基准案例建立独立文件夹;旧目录可为兼容保留,但新的 CTest 和文档应优先指向独立目录。包含 `.inp` 的示例目录应提供 `run_case.bat`,可在 Windows 下双击自动运行,结果默认写入该目录的 `results\auto_run`。`examples/contact_two_blocks_compression` 的检查脚本会额外生成 `pressure_profile.csv`,用于检查非匹配接触压力、gap、weighted gap、multiplier residual 和 augmented multiplier。`examples/contact_block_sliding` 的检查脚本会额外生成 `sliding_profile.csv`,用于检查多 master 大滑移摩擦、stick/slip、累计滑移、摩擦功和切向力。`examples/shell_shell_contact` 和 `examples/shell_solid_contact` 的检查脚本分别生成 shell contact profile CSV,用于检查 active contact、force、gap、augmented multiplier 和 master search。`examples/strengthReduction` 的 benchmark checker 会生成 `strength_reduction_history.csv`、`strength_reduction_summary.csv`、`plastic_zone.csv` 和 `displacement_probe.csv`,用于检查安全系数 bracket、塑性区和位移探针。`examples/euler_column_buckling` 的 benchmark checker 会生成 `buckling_summary.csv` 和 `buckling_mode_1.csv`,用于检查 Euler 临界载荷相对误差、特征残差、`phi^T K_G phi` 归一化和端部横向位移约束。`examples/buckling_corrugated_shell` 的 benchmark checker 会生成 `corrugated_buckling_summary.csv`、`corrugated_buckling_waves.csv`、`corrugated_buckling_modes.csv` 和 `corrugated_buckling_profile.csv`,用于检查循环波数、临界载荷、循环/全模型一致性、循环边界残差和模态输出。`examples/roll_forming` 的 roller kinematics checker 会生成 `roller_kinematics_history.csv` 和 `roller_kinematics_summary.csv`,用于检查辊角速度对切向滑移、正则化牵引、摩擦能、压力和扭矩的影响;springback checker 会生成 `springback_history.csv`、`springback_summary.csv` 和 `plastic_zone.csv`,用于检查 J2 塑性功、塑性区、卸载残余弯矩、残余位移和回弹比例。`examples/ball_adhesion_decohesion` 的 cohesive checker 会生成 `adhesion_history.csv`、`adhesion_summary.csv` 和 `decohesion_profile.csv`,用于检查 force-displacement 滞回、峰值拉脱力、耗散能、损伤和脱粘面积。`examples/Dynamic_Grain_Packing_of_a_Flexible_Container` 的 particle checker 会生成 `grain_container_history.csv` 和 `grain_container_summary.csv`,用于检查真实粒子-facet 接触、映射节点力、容器位移、质量守恒、重叠和能量。
每个示例目录中的 `README.md` 给出几何、材料、边界、生成脚本和运行命令。新增基准测试应放在 `examples/` 下,并为每个基准案例建立独立文件夹;旧目录可为兼容保留,但新的 CTest 和文档应优先指向独立目录。包含 `.inp` 的示例目录应提供 `run_case.bat`,可在 Windows 下双击自动运行,结果默认写入该目录的 `results\auto_run`。`examples/contact_two_blocks_compression` 的检查脚本会额外生成 `pressure_profile.csv`,用于检查非匹配接触压力、gap、weighted gap、multiplier residual 和 augmented multiplier。`examples/contact_block_sliding` 的检查脚本会额外生成 `sliding_profile.csv`,用于检查多 master 大滑移摩擦、stick/slip、累计滑移、摩擦功和切向力。`examples/shell_shell_contact` 和 `examples/shell_solid_contact` 的检查脚本分别生成 shell contact profile CSV,用于检查 active contact、force、gap、augmented multiplier 和 master search。`examples/strengthReduction` 的 benchmark checker 会生成 `strength_reduction_path.csv`、`strength_reduction_cases.csv`、`strength_reduction_summary.csv`、`plastic_zone.csv` 和 `displacement_probe.csv`,用于检查 PDF 8 工况安全系数曲线、bracket、塑性区和位移停止准则。`examples/euler_column_buckling` 的 benchmark checker 会生成 `buckling_summary.csv` 和 `buckling_mode_1.csv`,用于检查 Euler 临界载荷相对误差、特征残差、`phi^T K_G phi` 归一化和端部横向位移约束。`examples/buckling_corrugated_shell` 的 benchmark checker 会生成 `corrugated_buckling_summary.csv`、`corrugated_buckling_waves.csv`、`corrugated_buckling_modes.csv` 和 `corrugated_buckling_profile.csv`,用于检查循环波数、临界载荷、循环/全模型一致性、循环边界残差和模态输出。`examples/roll_forming` 的 roller kinematics checker 会生成 `roller_kinematics_history.csv` 和 `roller_kinematics_summary.csv`,用于检查辊角速度对切向滑移、正则化牵引、摩擦能、压力和扭矩的影响;springback checker 会生成 `springback_history.csv`、`springback_summary.csv` 和 `plastic_zone.csv`,用于检查 J2 塑性功、塑性区、卸载残余弯矩、残余位移和回弹比例。`examples/ball_adhesion_decohesion` 的 cohesive checker 会生成 `adhesion_history.csv`、`adhesion_summary.csv` 和 `decohesion_profile.csv`,用于检查 force-displacement 滞回、峰值拉脱力、耗散能、损伤和脱粘面积。`examples/Dynamic_Grain_Packing_of_a_Flexible_Container` 的 particle checker 会生成 `grain_container_history.csv` 和 `grain_container_summary.csv`,用于检查真实粒子-facet 接触、映射节点力、容器位移、质量守恒、重叠和能量。
`examples/strengthReduction` 的可选 nonlinear chain/cloud/progress 输出还会记录
`continuation_method`、target/actual/next continuation step、adaptive adjust、
trust radius、damping、merit ratio、trust rejection、MC 子步/分支聚合诊断和直接位移
控制 path 诊断;checker 会拒绝缺失或非法的 NC-2/NC-3/NC-5 字段;NC-4 path 数据由
生产 API/CSV 输出提供。
## 11. 测试
@@ -443,7 +519,7 @@ V5 当前开发态记录:
- 不完整兼容 Abaqus 全部 keyword。
- `*SURFACE` 已支持 element/node/analytical plane 子集,但尚不支持完整 Abaqus surface 语义。
- 面-面接触已具备 mortar 权重、mortar 积分点摩擦历史、正则化摩擦、摩擦功输出、BVH 搜索、active set 和 pair 级 augmented penalty 诊断,但仍不是完整工程级 mortar 约束求解器。
- Mohr-Coulomb 当前已具备材料点返回映射、driver、强度折减参数折减基础和结构级边坡安全系数 benchmark;完整结构级自动 trial 重求解、非线性失稳判据和工程切线审计仍在 V5.4 后续项中完善。
- Mohr-Coulomb 当前已具备材料点返回映射、driver、活动集算法一致切线、强度折减参数折减基础和结构级边坡安全系数 benchmark;完整结构级自动 trial 重求解、非线性失稳判据和 PDF 位移/塑性云图复现仍在 V5.4 后续项中完善。
- 线性屈曲当前已具备小规模内部 dense 特征值求解、梁柱几何刚度、Euler 柱解析 benchmark 和波纹壳紧凑循环屈曲 benchmark;通用 `*BUCKLING` step、静力预载后的壳/实体几何刚度装配、完整壳 FE 波纹壳高保真模型和循环扇区约束接入主求解流程仍在 V5.5 后续项中完善。
- 滚压成形当前已具备刚体辊平移/下压/角速度运动学、角速度参与切向相对速度和正则化牵引的 benchmark,以及基于 J2 多层材料点的塑性成形/卸载回弹 benchmark;主求解器通用滚压成形 step、完整三维工件网格滚压和 restart 驱动多 step 工艺流仍在后续完善。
- 颗粒耦合当前已具备内置离散球颗粒、颗粒-facet 映射和动态柔性容器紧凑 benchmark;它不是工业规模 DEM 长跑,也不接入外部颗粒求解器。
+45 -10
View File
@@ -76,7 +76,7 @@ src/interface C ABI 和 Fortran-C bridge
|---|---|
| `fem_precision` | 全局精度、维度、版本常量 |
| `fem_error` | 错误码和错误消息 |
| `fem_control` | 时间步、求解控制、输出控制、V4.5 收敛诊断、V4.6 线性求解器状态和 V4.7 壳稳定参数 |
| `fem_control` | 时间步、求解控制、输出控制、V4.5 收敛诊断、V4.6 线性求解器状态、V4.7 壳稳定参数和 V5 nonlinear continuation 控制/诊断 |
| `fem_api` | Fortran95 公共 API |
| `fem_inp_reader` | 两遍 INP 读取主流程 |
| `fem_inp_defs` | INP 模式常量 |
@@ -84,14 +84,16 @@ src/interface C ABI 和 Fortran-C bridge
| `fem_database` | 集中式全局数组、分配、初始化、校验和释放 |
| `fem_database_surface` | surface/contact 目标和 facet 查询 helper |
| `fem_material_j2` | J2 和 Johnson-Cook 相关材料更新 |
| `fem_material_mohr_coulomb` | Mohr-Coulomb 返回映射、张拉截断、分支状态和工程切线 |
| `fem_material_mohr_coulomb` | Mohr-Coulomb 返回映射、张拉截断、分支状态和活动集算法一致切线 |
| `fem_material_mc_driver` | Mohr-Coulomb 单点/路径 driver 和诊断汇总 |
| `fem_material_mc_envelope` | Mohr-Coulomb 包络、margin 和 safety ratio helper |
| `fem_strength_reduction*` | 强度折减参数、trial 搜索状态和报告输出 |
| `fem_element_stiffness` | 实体/壳单元静力刚度 |
| `fem_shell_corotational` | S4 reference/current local frame、刚体转动扣除和 corotational kinematics helper |
| `fem_dload_tangent` | 壳 `DLOAD P` current-geometry follower-pressure tangent 装配 |
| `fem_geometric_stiffness` | 线性屈曲几何刚度 helper,当前覆盖梁柱几何刚度 |
| `fem_element_internal` | 单元内力 |
| `fem_solver_implicit` | 静力、隐式 Newmark、非线性 Newton 主流程 |
| `fem_solver_implicit` | 静力、隐式 Newmark、非线性 Newton、目标 Newton 自适应步长和 trust-region damped Newton 主流程 |
| `fem_eigensolver` | 内部 dense 对称 Jacobi 和 SPD 广义特征值求解 |
| `fem_buckling_solver` | 线性屈曲 dense solve、几何刚度符号、Euler 解析载荷和模态 helper |
| `fem_contact` | 接触公开入口和刚性平面接触 |
@@ -232,11 +234,34 @@ fem_contact_mortar_*.f90 mortar/AL 点更新、批处理、约束、迭代、报
求解器核心文件:
- `fem_assembly_csr.f90`:DOF 获取、CSR 图案和装配。
- `fem_dload_tangent.f90`:shell pressure follower-load tangent。
- `fem_linear_solver_dispatch.f90`:线性求解器统一入口、配置、统计和 method 分发。
- `fem_linear_solver_iterative.f90`:CG、BiCGSTAB、GMRES 和 none/Jacobi 预条件。
- `fem_linear_solver_iterative.f90`:CG、BiCGSTAB、GMRES 和
none/Jacobi/Gauss-Seidel/ILU0 预条件。
- `fem_linear_solver_dense.f90`:内部 dense pivoting fallback,用于小中型回归矩阵和非线性修正诊断。
- `fem_solver_implicit.f90`:静力、隐式 Newmark、非线性 Newton。
V4.6 起,隐式求解器内部不再直调 CG,而是通过 `linear_solver_solve` 分发。当前内部支持 CG、BiCGSTAB 和 GMRES;V5 当前模块要求保持稀疏求解器无第三方依赖,不导出外部求解器 method、backend、外部进程交互或 C ABI 接口。旧外部 method 数值必须在配置边界返回错误并保持当前设置不变。分发层在每次求解前调用 CSR diagnostics 记录矩阵分类,并在求解前后记录初始残差、最终残差和最终相对残差;新增线性求解能力时优先扩展 `fem_linear_solver_iterative`、CSR 诊断和预条件器。如确需第三方 solver,必须在当前模块之外重新立项。测试工具放在 `tools/`,不要放入 `src/`。
V4.6 起,隐式求解器内部不再直调 CG,而是通过 `linear_solver_solve` 分发。当前内部支持 CG、BiCGSTAB、GMRES 和 dense pivoting fallback;V5 当前模块要求保持稀疏求解器无第三方依赖,不导出外部求解器 method、backend、外部进程交互或 C ABI 接口。旧外部 method 数值必须在配置边界返回错误并保持当前设置不变。分发层在每次求解前调用 CSR diagnostics 记录矩阵分类,并在求解前后记录初始残差、最终残差和最终相对残差;新增线性求解能力时优先扩展 `fem_linear_solver_iterative`、`fem_linear_solver_dense`、CSR 诊断和预条件器。非线性 Newton 修正可在配置 CG 失败后依次尝试内部 GMRES、BiCGSTAB、dense pivoting 和受限对角正则化 dense pivoting,并在返回前恢复用户配置。如确需第三方 solver,必须在当前模块之外重新立项。测试工具放在 `tools/`,不要放入 `src/`。
Nonlinear continuation 维护约定:`*NONLINEAR CONTINUATION` 的解析留在
`fem_inp_helpers`,控制、最近一次诊断和 accepted-increment path 表留在
`fem_control`。NC-2 目标 Newton 步长控制、NC-3 trust-region damped Newton 和
NC-4 直接位移控制 path 记录必须在 `fem_solver_implicit` 的生产非线性静力路径内
实现;`tools/benchmarks` 只能编排案例、收集 diagnostics 和写 CSV。修改
continuation 参数、诊断字段、path CSV/API 字段或接受/拒绝规则时,必须同步更新
`implicit_inp`、`solver_implicit`、strengthReduction checker、算法文档、接口文档和
用户手册。NC-3 的 `convergence_correction_norm` 必须表示实际应用的
damped/trust-limited 修正范数;NC-4 的目标位移必须使用求解时实际施加的
`load_factor * amplitude * boundary_value`,不能用未缩放的边界输入值代替。NC-5
局部 Mohr-Coulomb 子步控制量也放在 `fem_control`,解析留在 `fem_inp_helpers`;
生产材料分发通过 `fem_material_j2` 进入 `fem_material_mc_driver`,不要在
benchmark 工具里重写材料积分。
S4 几何非线性开关同样属于生产路径:`SHELL_GEOMETRIC`、`GEOMETRIC_SHELL`、
`COROTATIONAL_SHELL` 和 `S4_COROTATIONAL` 的解析在 `fem_inp_helpers`,状态在
`fem_control%shell_geometric_nonlinear`,运动学在 `fem_shell_corotational`。方法 4
会默认启用同一 S4 current-frame 路径。修改该语义时必须同步
`test_shell_internal`、`test_implicit_inp`、spherical-cap checker、算法文档、接口文档和
用户手册;不要在 `examples/` 或 `tools/` 里实现替代壳后屈曲逻辑。
强度折减相关模块分层如下:`fem_strength_reduction` 保存参数折减、bracket 更新和失稳指标;`fem_strength_reduction_driver` 保存 trial 搜索状态、上下界、收敛系数和历史记录;`fem_strength_reduction_report` 只负责 CSV/summary 输出。结构求解器接入边坡强度折减时,应把结构 trial 的残差、位移范数、塑性区比例和收敛失败标志传给 driver,不要在材料更新内部直接控制全局安全系数搜索。
@@ -268,15 +293,25 @@ V4.7 壳稳定和壳塑性维护约定:
- 壳刚度装配后的稳定性统计也放在 `fem_control`,测试中通过 `test_element_stiffness` 和 `test_c_api` 同时覆盖内部变量和外部接口。
- 当前 J2 弯曲塑性使用代表性外纤维应变近似,不是完整厚度方向积分;任何多层 section integration 扩展都必须保留 trial/rollback 的状态一致性。
- 壳 benchmark smoke 优先放在 `example_smoke` CTest 分组,长跑或网格收敛结果不提交全量 CSV/VTK。
- V5.11 S4 corotational 基础路径必须保持 opt-in:默认线性 S3/S4/S6/S8 行为不变;
`SHELL_GEOMETRIC=YES` 或方法 4 才进入 S4 reference/current frame 路径。该路径当前
完成对象性、弹性 corotational algorithmic tangent、prestress-delta 膜几何刚度和
shell `DLOAD P` follower-pressure tangent。algorithmic tangent 是生产内力的残差导数
近似,允许非对称;不要为了旧对称性假设强行平均矩阵。非 `ELASTIC` 壳材料
必须在 S4 corotational 刚度装配时显式报材料错误,不能静默回退旧工程切线。
塑性/多层壳切线、弯曲/剪切初应力项、全部 follower-load 类型和 Riks/arc-length
增广方程未完成前,不能在文档或 checker 中标为完整 postbuckling PASS。
V5.4 Mohr-Coulomb 维护约定:
- `fem_material_mohr_coulomb` 只负责材料点应力更新、张拉截断、分支编码和工程切线,不负责全局强度折减搜索。
- `fem_material_mohr_coulomb` 只负责材料点应力更新、张拉截断、分支编码和活动集算法一致切线,不负责全局强度折减搜索。
- `statev(11)` 保存分支号,`statev(12:13)` 保存最终剪切/张拉屈服值,`statev(22)` 保存最近一次塑性增量,`statev(26)` 保存当前强度折减系数。
- `fem_material_mc_driver` 负责单步和路径级诊断,包括 substeps、branch count、limited 状态、final branch、plastic total 和 tangent 对角统计。
- `statev(27:32)` 保存方法 5 的 Mohr-Coulomb 聚合诊断:accepted substeps、requested substeps、driver status、branch mask、max yield residual 和 max plastic increment。单步路径也必须写一致的单步诊断,避免方法切换后残留旧状态。
- `fem_material_mc_driver` 负责单步和路径级诊断,包括 substeps、branch count、limited 状态、final branch、plastic total 和 tangent 对角统计;当 `METHOD=MC_SUBSTEPPING_SEMISMOOTH` 时,它也是生产材料点子步入口。
- `fem_material_mc_envelope` 负责包络 margin 和 safety ratio 计算,供材料点测试、结构 benchmark checker 或报告层复用。
- 强度折减搜索继续通过 `fem_strength_reduction_driver` 接收结构 trial 指标;不要在材料更新例程中直接控制全局安全系数 bracket。
- 当前 Mohr-Coulomb 切线是工程算法切线,不是完整棱边/角点一致切线。修改返回映射时必须同步更新材料点验收、算法文档和切线限制说明。
- 当前 Mohr-Coulomb 切线固定 shear、tension 或 mixed 活动分支,并对实际返回映射求算法 Jacobian。修改返回映射时必须同步更新材料点有限差分切线审计、算法文档和结构级 nonlinear-chain 诊断。
- strengthReduction 的 nonlinear chain/cloud/progress CSV 需要保留 method、target/actual/next step、adaptive adjust、trust radius、damping、merit ratio 和 rejection count;新增字段时 checker 必须拒绝旧 schema。
## 10. 输出扩展
@@ -358,8 +393,8 @@ ctest --test-dir build-win-gcc-16 -R "^(contact|contact_omp1|contact_omp4|restar
- 示例 smoke:shell patch、Scordelis-Lo、pressure pulse、rigid sphere impact;需要专用数值指标的示例可通过 `tools/testing/run_example_smoke.py --check-script` 调用示例目录内的 Python checker。
- 性能测试:`perf_p1`、`perf_contact_pair`、`perf_contact_pair_omp_consistency`。
- Benchmark 编排工具:`tools/benchmarks/strength_reduction_benchmark.f90` 链接
`femlite_core`,用于 `examples/strengthReduction` 生成安全系数 history、
summary、塑性区和位移探针;这类测试/benchmark orchestration 不应放入
`femlite_core`,用于 `examples/strengthReduction` 生成 PDF 8 工况
path/cases、summary、塑性区和位移探针;这类测试/benchmark orchestration 不应放入
`src/`。
- Benchmark 编排工具:`tools/benchmarks/euler_column_buckling_benchmark.f90`
链接 `femlite_core`,用于 `examples/euler_column_buckling` 装配 Euler 柱
+4 -4
View File
@@ -35,7 +35,7 @@ V4.8 是第四版阶段验收收束版,重点确认 0.4.x 开发期新增的
| 线性求解器 | PASS | CG/BiCGSTAB/GMRES、Jacobi 和 C ABI 设置查询覆盖;external 仅为后续第三方库适配项 |
| 壳稳定与壳塑性 | PASS | drilling、S3 剪切锁定、S4 J2 剪切/弯曲、trial rollback 和 Scordelis-Lo smoke 覆盖 |
| 示例目录结构 | PASS | `examples_layout` 检查文档目录和双击脚本约定 |
| 文档派生示例 | PASS | elliptic membrane、membrane uniaxial、shell-solid connection、strength reduction、golf ball impact,以及 block-on-arch、roller contact、sliding wedge、airbag membrane、spherical cap、two arches、blasting rock、nonlinear harmonic、layered shell、pinched hemisphere、stress dependent elasticity、roll forming、falling objects、ball adhesion contact、corrugated shell buckling preload、dynamic grain container 和 thick plate 均接入 smoke |
| 文档派生示例 | PASS | elliptic membrane、membrane uniaxial、shell-solid connection、strength reduction、golf ball impact,以及 block-on-arch、roller contact、sliding wedge、airbag membrane、blasting rock、nonlinear harmonic、layered shell、pinched hemisphere、roll forming、falling objects、ball adhesion contact、corrugated shell buckling preload、dynamic grain container 接入 smoke;two arches 接入参考几何 benchmark;thick plate 接入 NAFEMS LE10 benchmark;spherical cap 接入位移控制壳 benchmark;stress dependent elasticity 接入应力相关弹性 benchmark |
| 源码规模门禁 | PASS | `source_size` 保持通过 |
## 4. 示例矩阵
@@ -54,13 +54,13 @@ V4.8 期间补齐或确认的示例目录:
| `examples/cylinder_roller_contact` | `run_case.bat` | 滚子-基础法向接触代表性 smoke |
| `examples/sliding_wedge` | `run_case.bat` | 倾斜接触面摩擦滑移 smoke |
| `examples/membrane_airbag_inflation` | `run_case.bat` | S4 膜片压力载荷回归入口 |
| `examples/spherical_cap_with_central_point_load` | `run_case.bat` | 球冠中心载荷 S4 静力回归入口 |
| `examples/two_arches` | `run_case.bat` | 双拱壳-壳接触代表性 smoke |
| `examples/spherical_cap_with_central_point_load` | `run_case.bat` | 球冠中心载荷位移控制壳 benchmark |
| `examples/two_arches` | `run_case.bat` | 双拱壳-壳接触参考几何 benchmark |
| `examples/blasting_rock` | `run_case.bat` | C3D8 花岗岩块爆破脉冲动力 smoke |
| `examples/nonlinear_harmonic` | `run_case.bat` | 薄膜谐波压力显式动力 smoke |
| `examples/failure_prediction_in_a_layered_shell` | `run_case.bat` | 四层共享节点壳拉伸回归入口 |
| `examples/pinched_hemispherical_shell` | `run_case.bat` | pinched hemisphere S4 壳动力 smoke |
| `examples/stress_dependent_elasticity` | `run_case.bat` | 分区弹性模量悬臂梁弯曲回归入口 |
| `examples/stress_dependent_elasticity` | `run_case.bat` | 应力相关弹性悬臂梁纯弯矩 benchmark |
| `examples/roll_forming` | `run_case.bat` | 滚压成形文档派生的压紧-摩擦牵引 smoke |
| `examples/falling_objects` | `run_case.bat` | 多物体显式接触与刚性箱底代表性 smoke |
| `examples/ball_adhesion_decohesion` | `run_case.bat` | 球-膜接触压入 smoke,粘附/脱粘本构为后续能力 |
+1 -1
View File
@@ -901,7 +901,7 @@ FemLite 0.4.x 定位为:
- `elliptic_membrane_s4_static.inp`、`membrane_uniaxial_s4_static.inp`、`shell_solid_connection_static.inp` 和 `strength_reduction_slope_static.inp` 已完成静力求解 smoke。
- `example_golf_ball_impact_smoke` 使用短步数动态输入检查接触输出,避免常规回归运行完整长跑。
- 新增 `example_node_analytical_contact_smoke`、`example_block_on_arch_contact_smoke`、`example_cylinder_roller_contact_smoke`、`example_sliding_wedge_friction_smoke`、`example_roll_forming_friction_smoke`、`example_falling_objects_contact_smoke`、`example_ball_adhesion_contact_smoke`、`example_buckling_corrugated_shell_smoke`、`example_dynamic_grain_container_smoke`、`example_thick_plate_pressure_smoke`、`example_membrane_airbag_pressure_smoke`、`example_spherical_cap_point_load_smoke`、`example_blasting_rock_pulse_smoke`、`example_nonlinear_harmonic_membrane_smoke`、`example_layered_shell_tension_smoke`、`example_two_arches_contact_smoke`、`example_pinched_hemisphere_smoke` 和 `example_stress_dependent_cantilever_smoke`,覆盖节点-解析面、壳/实体接触、摩擦滑移、多物体接触、球-膜压入、波纹锥壳静力预载、柔性容器压力-地面接触、厚板压力、压力载荷、脉冲动力、壳-壳接触、层合壳拉伸、曲壳 pinched load 和分区弹性梁弯曲路径。
- 新增 `example_node_analytical_contact_smoke`、`example_block_on_arch_contact_smoke`、`example_cylinder_roller_contact_smoke`、`example_sliding_wedge_friction_smoke`、`example_roll_forming_friction_smoke`、`example_falling_objects_contact_smoke`、`example_ball_adhesion_contact_smoke`、`example_buckling_corrugated_shell_smoke`、`example_dynamic_grain_container_smoke`、`example_thick_plate_le10_benchmark`、`example_membrane_airbag_pressure_smoke`、`example_spherical_cap_point_load_benchmark`、`example_blasting_rock_pulse_smoke`、`example_nonlinear_harmonic_membrane_smoke`、`example_layered_shell_tension_smoke`、`example_two_arches_contact_benchmark`、`example_pinched_hemisphere_smoke` 和 `example_stress_dependent_elasticity_benchmark`,覆盖节点-解析面、壳/实体接触、摩擦滑移、多物体接触、球-膜压入、波纹锥壳静力预载、柔性容器压力-地面接触、厚板压力基准、球冠位移控制、压力载荷、脉冲动力、壳-壳接触、层合壳拉伸、双拱参考几何接触、曲壳 pinched load 和应力相关弹性梁弯曲路径。
- `examples_layout` 纳入 Python CTest 分支,保护示例目录结构约定。
- Windows GCC 16 Release 构建已通过;全量 CTest 已通过,66/66 passed。
- 已手动验证 `examples/elliptic_membrane/run_case.bat` 静力入口和 `examples/clamped_square_plate_pressure_pulse/run_case.bat` 动力入口均可在 `FEMLITE_NO_PAUSE=1` 下完成。
+4 -4
View File
@@ -74,7 +74,7 @@ ctest --test-dir build-win-gcc-16 -C Release -R "^(contact_mortar_tangent|restar
|---|---|
| 内部 solver | CG、BiCGSTAB、GMRES、Jacobi/none 预条件、CSR 诊断、隐式/静力/非线性调用点和 C ABI legacy rejection 均有测试覆盖;无外部 solver 构建目标或接口。 |
| 接触 benchmark | `contact_two_blocks_compression`、`contact_block_sliding`、`shell_shell_contact`、`shell_solid_contact` 均有示例目录、输入、checker、CTest 和参考指标;0.5.1 增加 multiplier restart audit、mortar tangent matrix audit 和 report 摘要审计字段。 |
| Mohr-Coulomb | 材料点 driver/envelope 测试覆盖三轴、纯剪、张拉截断和分支诊断;`strengthReduction` 输出安全系数 history、summary、塑性区和位移探针。 |
| Mohr-Coulomb | 材料点 driver/envelope 测试覆盖三轴、纯剪、张拉截断和分支诊断;`strengthReduction` 按 PDF 路线输出 8 工况 path/cases、summary、塑性区和位移探针;PDF 参考位移云图尚未作为通过项。 |
| 屈曲和循环对称 | Euler 柱解析 benchmark、波纹壳紧凑循环屈曲 benchmark、内部 dense 特征值求解和循环映射测试已接入。 |
| 滚压 | 辊平移/下压/角速度运动学、正则化牵引、J2 多层截面成形、塑性功、塑性区和回弹指标已由示例 checker 验证。 |
| cohesive | cohesive law/state/metrics 覆盖 loading、unloading、mixed-mode damage、complete decohesion、非负耗散和 restart;ball adhesion benchmark 输出滞回、拉脱力、能量和脱粘面积。 |
@@ -87,7 +87,7 @@ ctest --test-dir build-win-gcc-16 -C Release -R "^(contact_mortar_tangent|restar
| 案例 | 当前参考 |
|---|---|
| `examples/strengthReduction` | `FS=1.21125`, 8 trials, 3 stable, 5 unstable, 2 active plastic probes |
| `examples/strengthReduction` | PDF 8 工况 FOS 曲线最大误差 `6.9392E-03`,86 trials,52 stable,34 unstable |
| `examples/euler_column_buckling` | first load relative error `3.27660856E-05`, residual `1.50014805E-11`, `phi^T K_G phi=1` |
| `examples/buckling_corrugated_shell` | selected wave 4 load `453.031407`, critical wave 8 load `393.369677`, cyclic/full relative error `1.25473461E-16` |
| `examples/roll_forming` kinematics | mean slip `0.4` with spin vs `0.2` without spin; mean traction `289.208274` vs `228.478247`; positive torque `14.4604137` |
@@ -100,7 +100,7 @@ ctest --test-dir build-win-gcc-16 -C Release -R "^(contact_mortar_tangent|restar
| 领域 | 原因 | 风险 | 用户影响 |
|---|---|---|---|
| 完整 mortar / AL 一致切线 | 当前已有 multiplier、mortar、friction、多示例 benchmark、0.5.1 multiplier restart audit 和 tangent matrix audit;完整工业级一致切线、非线性长路径和更大规模并行 benchmark 仍需收束 | 大规模非线性接触可能需要更强收敛控制 | 当前可运行紧凑接触 benchmark 和接触审计回归;不能宣称覆盖所有工业接触场景 |
| Mohr-Coulomb 结构级自动 trial 重求解 | 材料点和紧凑强度折减已完成,完整结构非线性失稳判据和工程切线仍需扩展 | 复杂边坡或三维岩土模型可能过早/过晚判稳 | 当前适合紧凑强度折减验证,不等价于完整岩土生产求解器 |
| Mohr-Coulomb 结构级自动 trial 重求解 | 材料点、活动集算法一致切线和 FOS 曲线 benchmark 已完成,完整结构非线性失稳判据和 PDF 位移/塑性云图仍需扩展 | 复杂边坡或三维岩土模型可能过早/过晚判稳 | 当前适合强度折减曲线验证,不等价于完整岩土生产求解器 |
| 通用 `*BUCKLING` step | 已有内部特征值和 benchmark 工具,主 `femlite` 输入流程尚未提供通用 buckling step | 用户需要通过 benchmark 工具验证屈曲,而非普通 INP 直接求解 | 小规模解析/紧凑循环 benchmark 可用,通用屈曲工况仍需后续版本 |
| 完整三维滚压长跑 | 当前是辊运动学和紧凑多层 J2 截面 springback benchmark | 真实工艺网格、restart 多 step 和长时间稳定性尚未验证 | 用户可验证核心算法路径,但不能直接替代工业 roll forming 工艺仿真 |
| 完整 FE cohesive 接触 step | 当前 cohesive law/state/metrics 和 ring benchmark 已完成,主接触流程切换与切线仍需集成 | 粘附/普通接触切换和 restart 长路径仍有风险 | 用户可使用 benchmark 验证 cohesive 模型,不应把它当作通用 FE cohesive 接触 |
@@ -111,7 +111,7 @@ ctest --test-dir build-win-gcc-16 -C Release -R "^(contact_mortar_tangent|restar
| 项 | 原因 | 风险 | 用户影响 |
|---|---|---|---|
| 第三方/外部稀疏求解器后端 | 用户约束要求本模块不依赖第三方库且不允许外部求解器接口 | 若未来需要更大规模求解,需另行设计可选外围项目,不应污染核心模块 | 当前核心只支持内部 CG/BiCGSTAB/GMRES;旧外部编号会被拒绝 |
| 第三方/外部稀疏求解器后端 | 用户约束要求本模块不依赖第三方库且不允许外部求解器接口 | 若未来需要更大规模求解,需另行设计可选外围项目,不应污染核心模块 | 当前核心只支持内部 CG/BiCGSTAB/GMRES 和 dense pivoting fallback;旧外部编号会被拒绝 |
| `examples/shell_solid_connection` 高保真壳-实体连接 benchmark | 当前目录仍是共享节点 smoke,不是 V5 shell-solid contact benchmark | 连接过渡区应力和接触压力还缺高保真验证 | 用户可运行 smoke;高保真连接验收应等待后续示例 |
| 工业规模颗粒 DEM 装填 | V5.8 只承诺内置离散球和紧凑 staggered 双向耦合 | 大规模性能和接触搜索尚未验收 | 当前 dynamic grain benchmark 用于算法闭环验收,不是工业 DEM 产品 |
+5 -3
View File
@@ -30,14 +30,15 @@
| V5 项 | 能力 | 目录或模块 | CTest 名称 | 参考指标 | 容差/验收条件 |
|---|---|---|---|---|---|
| V5.2 | 内部 solver 诊断、no-external-solver 策略 | `src/solver`, `tests/module`, `tests/interface` | `linear_solver_cg`, `csr_diagnostics`, `solver_implicit`, `implicit_inp`, `c_api`, CLI implicit/static tests | CG/BiCGSTAB/GMRES 迭代、残差、CSR matrix class、legacy external id rejection | 旧外部 method/backend id 被拒绝且不改变设置;静力、隐式和非线性路径通过内部 solver dispatch |
| V5.2 | 内部 solver 诊断、no-external-solver 策略 | `src/solver`, `tests/module`, `tests/interface` | `linear_solver_cg`, `csr_diagnostics`, `solver_implicit`, `implicit_inp`, `c_api`, CLI implicit/static tests | CG/BiCGSTAB/GMRES/dense pivoting、残差、CSR matrix class、legacy external id rejection、非线性修正 fallback | 旧外部 method/backend id 被拒绝且不改变设置;静力、隐式和非线性路径通过内部 solver dispatch;非线性修正可在内部求解器间 fallback 且恢复用户设置 |
| V5.3 | 非匹配实体 mortar 压缩 | `examples/contact_two_blocks_compression` | `example_contact_two_blocks_compression_benchmark` | `pressure_profile.csv`, active contact, master coverage, weighted gap, multiplier residual | 多 master facet 覆盖;weighted penetration 和 multiplier residual 在 checker 容差内;VTK 输出存在 |
| V5.3 | 大滑移 mortar-friction | `examples/contact_block_sliding` | `example_contact_block_sliding_benchmark` | `sliding_profile.csv`, stick/slip, accumulated slip, tangential force, friction work | 多 master/active candidate;累计滑移和摩擦功为正且非负耗散;VTK 输出存在 |
| V5.3 | shell-shell contact | `examples/shell_shell_contact` | `example_shell_shell_contact_benchmark` | contact profile, active contact, force norm, gap residual, augmented multiplier | active contact 大于零;gap/force/multiplier 指标通过 checker |
| V5.3 | shell-solid contact | `examples/shell_solid_contact` | `example_shell_solid_contact_benchmark` | contact profile, master search, shell-to-solid force transfer | active contact 大于零;master search 和 nodal force 指标通过 checker |
| V5.3 | 接触状态和 restart 连续性 | `tests/module` | `contact_mortar_al`, `contact_mortar_iter`, `contact_mortar_report`, `contact_mortar_tangent`, `contact_multiplier_report`, `restart` | AL multiplier, `contact_multiplier_audit`, `mortar_tan_audit_matrix`, tangent/report diagnostics, restart restored history | 接触历史、摩擦累计量和 multiplier 状态在 restart 后连续;0.5.1 覆盖 active/released/open multiplier 写读、duplicate/invalid 为零、commit/trial 差异为零,并检查 mortar tangent row/column balance、刚体平移残差、非对称量和能量 probe |
| V5.4 | Mohr-Coulomb 材料点 | `tests/unit` | `material_mohr_coulomb`, `material_mc_driver`, `material_mc_envelope` | 三轴压缩/伸展、纯剪、张拉截断、branch id、plastic multiplier | yield margin、分支号、塑性增量和 envelope safety ratio 通过测试容差 |
| V5.4 | 强度折减坡体 benchmark | `examples/strengthReduction` | `example_strength_reduction_benchmark` | `FS=1.21125`, 8 trials, 3 stable, 5 unstable, 2 active plastic probes | safety factor 在 checker 容差内;bracket 收敛;plastic zone 和 displacement probe 激活 |
| V5.4 | Mohr-Coulomb 屈服面算例 | `examples/mohr_coulomb_yield_surface` | `example_mc_yield_surface_benchmark` | `yield_surface.csv`, `yield_points.csv`, `yield_summary.csv`; 原始材料和 `F=2` 折减材料 | 压缩包络、伸展包络和张拉截断符合解析公式;强度折减降低承载力;elastic/shear/tension/mixed 分支全部被代表性应力点激活 |
| V5.4 | 强度折减坡体 PDF benchmark | `examples/strengthReduction` | `example_strength_reduction_benchmark` | 8 个 PDF 工况,最大 FOS 误差 `6.9392E-03`,86 trials,52 stable,34 unstable;`--nonlinear-chain` 可选输出真实 FE trial、cutback、accepted-time 和线性求解诊断;`--nl-write-cloud` 可选输出目标 FOS 云图 summary 与 VTK;0.75 m cloud route 支持内部 BiCGSTAB/ILU0、静力 predictor、自适应跳步和 accepted segment 后 VTK 刷新 | 0.75 m 网格和 PDF 几何记录;输入使用原生实体 `DLOAD, GRAV`;上下土体界面必须为共享节点 conforming mesh;FOS 曲线在 0.02 容差内;FOS 随坡角单调降低;关联工况不弱于 Davis B 工况;plastic zone 和 displacement probe 激活;optional nonlinear chain 不伪造 VTK;optional partial/target cloud VTK 必须含 displacement/eqps 字段且网格计数匹配;0.75 m PDF 位移云图 `accepted_time=1.0` 数值匹配仍需 longrun 证明 |
| V5.5 | Euler column 解析屈曲 | `examples/euler_column_buckling` | `example_euler_column_buckling_benchmark` | first load relative error `3.27660856E-05`, residual `1.50014805E-11`, `phi^T K_G phi=1` | 相对误差、残差和几何刚度归一化通过 checker |
| V5.5 | 波纹壳循环屈曲 benchmark | `examples/buckling_corrugated_shell` | `example_buckling_corrugated_shell_benchmark` | selected wave 4 load `453.031407`, critical wave 8 load `393.369677`, cyclic/full relative error `1.25473461E-16` | 循环边界残差、模态残差、wave sweep 和 modal CSV 通过 checker |
| V5.5 | 屈曲/循环模块 | `tests/module` | `buckling_support`, `cyclic_symmetry` | geometric stiffness helper, cyclic map residual | 内部 dense 特征值、Euler helper 和周期映射通过模块容差 |
@@ -56,7 +57,8 @@
| `examples/contact_block_sliding` | `sliding_profile.csv`, VTK | `check_contact_results.py` |
| `examples/shell_shell_contact` | shell contact profile, VTK | `check_contact_results.py` |
| `examples/shell_solid_contact` | shell-solid contact profile, VTK | `check_contact_results.py` |
| `examples/strengthReduction` | `strength_reduction_history.csv`, summary, `plastic_zone.csv`, `displacement_probe.csv` | `check_strength_reduction_results.py` |
| `examples/mohr_coulomb_yield_surface` | `yield_surface.csv`, `yield_points.csv`, `yield_summary.csv` | `check_mc_yield_surface_results.py` |
| `examples/strengthReduction` | `strength_reduction_path.csv`, `strength_reduction_cases.csv`, summary, `plastic_zone.csv`, `displacement_probe.csv`; optional `strength_reduction_nonlinear_chain.csv` and nonlinear summary when `--nonlinear-chain` is used; optional `strength_reduction_cloud_summary.csv`, progress/trace CSV and refreshed partial/target VTK when `--nl-write-cloud` is used | `check_strength_reduction_results.py` |
| `examples/euler_column_buckling` | `buckling_summary.csv`, `buckling_mode_1.csv` | `check_buckling_results.py` |
| `examples/buckling_corrugated_shell` | summary, wave sweep, modes, profile | `check_buckling_results.py` |
| `examples/roll_forming` | roller kinematics history/summary, springback history/summary, `plastic_zone.csv` | `check_roller_kinematics.py`, `check_springback_results.py` |
+118 -29
View File
@@ -51,7 +51,8 @@ FemLite 0.5.x 定位为:
- node-based surface 到 analytical rigid plane 的接触路径。
- active set、augmented penalty、接触 gap/mortar residual 诊断。
- BVH 接触搜索、候选缓存、OpenMP 并行搜索和并行一致性回归。
- 内部 CG、BiCGSTAB、GMRES 和 none/Jacobi 预条件器。
- 内部 CG、BiCGSTAB、GMRES、dense pivoting fallback 和
none/Jacobi/Gauss-Seidel/ILU0 预条件器。
- CSV、VTK、restart、C ABI、Python 调试接口和示例 smoke 矩阵。
- Windows GCC 16 下第四版阶段验收测试 66/66 通过。
@@ -69,7 +70,7 @@ FemLite 0.5.x 定位为:
| 能力 | 当前代码位置 | 当前状态 | 第五版落地要求 |
|---|---|---|---|
| 线性求解器 | `src/solver/fem_linear_solver_cg.f90`、`src/base/fem_control.f90` | 已形成 solver dispatch、CG、BiCGSTAB、GMRES、none/Jacobi 预条件、CSR 矩阵分类和残差诊断;外部求解器 method/backend 接口不保留 | V5.2 已完成,后续只在新增矩阵类型或预条件器时扩展内部诊断 |
| 线性求解器 | `src/solver/fem_linear_solver_cg.f90`、`src/solver/fem_linear_solver_dense.f90`、`src/base/fem_control.f90` | 已形成 solver dispatch、CG、BiCGSTAB、GMRES、dense pivoting fallback、none/Jacobi/Gauss-Seidel/ILU0 预条件、CSR 矩阵分类和残差诊断;外部求解器 method/backend 接口不保留 | V5.2 solver 子项已完成;0.5.2 新增 two arches 文献路线见 7.1 |
| CSR 矩阵 | `src/solver/fem_sparse_csr.f90` | 内部 CSR 支持装配、取值和 matvec | V5.2 增加只读 CSR 导出/转换层,明确 0-based/1-based 索引、对称性和矩阵类型元数据 |
| 隐式求解调用点 | `src/solver/fem_solver_implicit.f90` | 线性静力、非线性静力和 Newmark 路径均直接调用 `linear_solver_solve` | 内部求解器验收必须覆盖这些调用点,不只覆盖孤立矩阵测试 |
| 接触状态 | `src/boundary/fem_contact_state.f90`、`src/boundary/fem_contact_history.f90` | 当前有 pair 级 augmented lambda 和 mortar 积分点摩擦历史 | V5.3 新增积分点/约束级法向乘子历史,并纳入 trial/rollback/commit 和 restart |
@@ -79,7 +80,7 @@ FemLite 0.5.x 定位为:
| 输入解析 | `src/input/fem_inp_reader.f90`、`src/input/fem_inp_helpers.f90` | 已解析 J2/J2_JC、surface/contact 子集;analytical surface 当前以平面为主 | V5.4-V5.7 需要新增 Mohr-Coulomb、强度折减、圆柱/刚体辊、cohesive law 和颗粒参数输入 |
| C ABI | `include/femlite_c_api.h`、`src/interface/fem_c_api.c` | 已有内部 solver 设置/统计、contact 统计和 SPH 载荷映射接口 | V5.2-V5.8 需新增内部 solver 诊断、接触乘子/cohesive/颗粒诊断接口,并保持已发布的非外部求解器 ABI 可用 |
| 耦合接口 | `src/coupling/fem_coupling.f90`、`fsph` 全局力向量 | 当前是边界 facet 导出和外部 SPH 载荷映射,不是颗粒求解器 | V5.8 必须新增颗粒状态、邻域搜索和时间推进模块,不能把现有 SPH 载荷映射宣称为颗粒耦合完成 |
| 高保真示例 | `examples/roll_forming`、`examples/ball_adhesion_decohesion`、`examples/buckling_corrugated_shell`、`examples/Dynamic_Grain_Packing_of_a_Flexible_Container` | 均为 V4.8 可执行缩减基准或 smoke | V5.6-V5.8 必须新增或替换为真实高保真输入、检查脚本和参考指标;原 smoke 可保留为快速回归 |
| 高保真示例 | `examples/two_arches`、`examples/roll_forming`、`examples/ball_adhesion_decohesion`、`examples/buckling_corrugated_shell`、`examples/Dynamic_Grain_Packing_of_a_Flexible_Container` | `two_arches` 当前仅完成 PDF 几何、接触激活和动态 micro-step 稳定性检查;其余目录为 V4.8 可执行缩减基准或 smoke | `examples/two_arches` 在 0.5.2 必须升级为文献路线测试案例;V5.6-V5.8 必须新增或替换其他真实高保真输入、检查脚本和参考指标;原 smoke 可保留为快速回归 |
因此,第五版的第一批代码工作不应直接写大型算法,而应先完成求解器、接触、材料和耦合四条主线的接口拆分和数据结构扩展。否则后续能力会被迫写成新的局部近似,无法达到第五版“不再 mini 化”的要求。
@@ -102,7 +103,7 @@ FemLite 0.5.x 定位为:
- `0.5.0`:第五版开发起点,提升项目版本号,建立 V5 计划、首页 README 和 V4.8 验收基线说明。
- `0.5.1`:第五版架构冻结、V4 deferred 项登记和验收矩阵建立。
- `0.5.2`:内部稀疏求解器强化和 no-external-solver 策略完成。
- `0.5.2`:内部稀疏求解器强化、no-external-solver 策略完成,并实现 `examples/two_arches` 对应参考文献的静力 continuation / global equation 路线。
- `0.5.3`:完整工业级 mortar / augmented Lagrangian 接触完成。
- `0.5.4`:完整 Mohr-Coulomb 和强度折减完成。
- `0.5.5`:线性屈曲和循环对称完成。
@@ -125,7 +126,7 @@ FemLite 0.5.x 定位为:
| 阶段 | 名称 | 主要内容 | 完成标志 |
|---|---|---|---|
| V5.1 | 架构冻结与验收矩阵 | V4 deferred 项清单、接口设计、风险分级、benchmark 矩阵 | `docs/v5_development_plan.md` 和 V5 验收矩阵完成 |
| V5.2 | 内部稀疏求解强化 | dispatch/iterative solver 拆分、CSR 诊断、失败诊断、no-external-solver 策略 | CG/BiCGSTAB/GMRES 可覆盖静力、隐式和非线性修正路径,外部求解器接口不再导出且旧编号被拒绝 |
| V5.2 | 内部稀疏求解强化与 two arches 文献路线 | dispatch/iterative solver 拆分、CSR 诊断、失败诊断、no-external-solver 策略;双拱壳接触参考文献的静力 continuation/global equation 路线 | CG/BiCGSTAB/GMRES 与内部 dense pivoting fallback 可覆盖静力、隐式和非线性修正路径,外部求解器接口不再导出且旧编号被拒绝;`examples/two_arches` 不再依赖显式动力 micro-step 作为文献路线验收 |
| V5.3 | 完整 mortar 接触 | 积分点乘子、AL 更新、active set、一致切线、摩擦耦合 | 面-面大滑移接触 benchmark 收敛且压力分布可验证 |
| V5.4 | Mohr-Coulomb | 非关联流动、张拉截断、角点返回、一致切线、强度折减 | 材料点、三轴、边坡强度折减 benchmark 通过 |
| V5.5 | 屈曲与循环对称 | 几何刚度、广义特征值、模态输出、扇区边界映射 | 波纹壳屈曲和循环扇区模态 benchmark 通过 |
@@ -151,9 +152,9 @@ FemLite 0.5.x 定位为:
| 阶段 | 当前标记 | 可计入当前进度的证据 | 达到 PASS 前必须补齐 |
|---|---|---|---|
| V5.1 架构冻结与验收矩阵 | PARTIAL | 本计划、README 和 V1-V4 回归基线已建立。 | 最终验收矩阵、干净发布分支和 `docs/v5_acceptance_report.md`。 |
| V5.2 内部稀疏求解强化 | PASS | solver dispatch 记录 method、preconditioner、iteration、status、CSR matrix class、initial/final/relative residual;CG/BiCGSTAB/GMRES、线性静力、隐式 Newmark、非线性接触修正和 C ABI 诊断回归通过;外部求解器接口、工具和构建目标已移除。 | 已完成;当前 Release 全量 CTest 106/106 通过。 |
| V5.2 内部稀疏求解强化与 two arches 文献路线 | PARTIAL | solver dispatch 记录 method、preconditioner、iteration、status、CSR matrix class、initial/final/relative residual;CG/BiCGSTAB/GMRES、内部 dense pivoting fallback、线性静力、隐式 Newmark、非线性接触修正、非线性修正 CG-to-GMRES fallback 和 C ABI 诊断回归通过;外部求解器接口、工具和构建目标已移除;`examples/two_arches` 已完成 PDF 几何、30/75 壳网格、接触激活和动态 blow-up 防护 checker。 | 0.5.2 必须补齐文献路线:静力 continuation/global equation、上拱边载荷控制、`disp_upper=max_disp*para` 约束、load-displacement 路径输出和参考指标 checker;当前 micro-step 不能作为文献结果验收。 |
| V5.3 mortar / AL 接触 | PARTIAL | 已有接触乘子、mortar AL 点/批量/约束/切线/迭代/报告模块和聚焦测试;非匹配实体压力、大滑移摩擦、shell-shell 和 shell-solid benchmark 已接入 CTest;0.5.1 新增 contact multiplier restart audit 和 mortar tangent matrix audit,并扩展 restart active/released/open 场景。 | 完整工业级 AL 一致切线、更多非线性长路径和更大规模 OpenMP benchmark 仍需收束。 |
| V5.4 Mohr-Coulomb 与强度折减 | PARTIAL | 已有 Mohr-Coulomb、包络、材料 driver、强度折减 driver/report 模块和测试;材料点验收覆盖三轴压缩、三轴伸展、纯剪、张拉截断、mixed return、分支号、塑性增量和强度折减残余下限;`examples/strengthReduction` 已升级为 Mohr-Coulomb 强度折减 benchmark,输出 FS history、summary、plastic zone 和 displacement probe。 | 完整结构级自动 trial 重求解、非线性失稳判据与 Mohr-Coulomb 工程切线审计收束。 |
| V5.4 Mohr-Coulomb 与强度折减 | PARTIAL | 已有 Mohr-Coulomb、包络、材料 driver、强度折减 driver/report 模块和测试;材料点验收覆盖三轴压缩、三轴伸展、纯剪、张拉截断、mixed return、分支号、塑性增量、强度折减残余下限,以及 shear/tension/mixed 活动集算法一致切线有限差分审计;`examples/strengthReduction` 已按 `models.geomech.strength_reduction_method.pdf` 升级为 0.75 m 网格 C3D8 坡体 benchmark,覆盖 4 个坡角和 2 个材料工况,输出 path、case summary、plastic zone 和 displacement probe;0.5.2 新增 `--nonlinear-chain` 真实结构级 trial 路线和 `--nl-write-cloud` 目标 FOS 云图路线,调用 `fem_solve_static_nonlinear` 输出真实收敛/失败诊断,并可生成 `strength_reduction_cloud_summary.csv` 与 `result_00001525.vtk`;实体 `DLOAD, GRAV` 已接入生产外载装配;非线性静力 step 已按增量时间缩放全局 `load_factor`,并新增 `static_ramp_load` 控制支持固定外载伪时间求解;strengthReduction 上下土体界面已修正为共享节点的 conforming mesh;NC-1 默认 `TWO_STAGE_LOAD_STRENGTH` 已接入 nonlinear chain 和 target cloud:阶段 A 在 `F=1.0` 收敛完整重力/外载,阶段 B 固定外载 continuation 强度折减因子;0.75 m cloud 路线还具备内部 BiCGSTAB/ILU0 预条件器、静力割线位移预测器、自适应 continuation 跳步和 accepted segment 后 VTK 刷新,旧路线实测可从 `accepted_time=0.003` 跳到 `0.053` 并推进到 `0.0905`;NC-5 已将 `METHOD=MC_SUBSTEPPING_SEMISMOOTH` 接入生产 Mohr-Coulomb 材料分发,支持 INP 可配置局部子步,在 `statev(27:32)` 写入聚合诊断,并已把 MC point/substep/branch/max-yield/max-plastic 汇总到 strengthReduction nonlinear chain/cloud/progress 输出,由 checker 校验。 | NC-1 已有路径但仍需降低 0.75 m 全模型长跑成本;NC-5 仍需 longrun 效果证明;最终 `FOS=1.525`、`accepted_time=1.0`、PDF 位移/eqps 云图数值复现和 Mohr-Coulomb 结构级长路径审计仍需收束。 |
| V5.5 屈曲与循环对称 | PARTIAL | 已有几何刚度、特征求解、模态输出、屈曲支持、循环对称模块/测试、Euler 柱解析屈曲 benchmark 和波纹壳紧凑循环屈曲 benchmark;相关 checker 已验证临界载荷、模态残差、`K_G` 归一化、循环边界残差和循环/全模型一致性。 | 通用 `*BUCKLING` step、静力预载后壳/实体几何刚度装配、完整壳 FE 波纹壳高保真模型和循环扇区约束接入主求解流程。 |
| V5.6 高保真滚压成形 | PARTIAL | 已有刚体圆柱/辊、运动调度、滚压指标、roller kinematics benchmark 和紧凑多层 J2 springback benchmark;示例输出 slip、traction、friction energy、pressure、torque、plastic work、plastic zone、residual displacement 和 springback ratio。 | 主求解器通用滚压成形 step、完整三维工件网格滚压、restart 驱动多 step 工艺流和更大规模长跑。 |
| V5.7 cohesive 粘附/脱粘 | PARTIAL | 已有 cohesive law/state/metrics 模块;`test_cohesive_contact` 覆盖单积分点 bonded loading、mixed-mode damage、unloading、reload、complete decohesion、非负耗散、损伤不可逆和 restart 状态保持;`examples/ball_adhesion_decohesion` 已新增 compact cohesive ring benchmark,输出力-位移、耗散能和脱粘面积。 | 主求解器通用 cohesive contact 切换、切线、restart 段和完整球-膜 FE 长跑。 |
@@ -170,7 +171,9 @@ V5 benchmark 示例当前标记:
| `examples/shell_shell_contact` | PASS | S4-to-S4 shell-shell contact benchmark;检查脚本生成 `shell_shell_contact_profile.csv` 并验证 active contact、force、gap、augmented multiplier、master search 和 VTK 输出。 |
| `examples/shell_solid_contact` | PASS | S4 shell slave 对 C3D8 solid master top face 的 shell-solid contact benchmark;检查脚本生成 `shell_solid_contact_profile.csv` 并验证 active contact、force、gap、augmented multiplier、master search 和 VTK 输出。 |
| `examples/shell_solid_connection` | DEFERRED | 当前是共享节点 smoke;尚不是高保真壳-实体接触 benchmark。 |
| `examples/strengthReduction` | PASS | Mohr-Coulomb 强度折减 benchmark;输入使用 `*MOHR COULOMB`,checker 生成并验证 `strength_reduction_history.csv`、summary、安全系数 bracket、plastic zone、displacement probe、VTK 和节点输出。 |
| `examples/two_arches` | PARTIAL / 0.5.2 TARGET | 对应 `models.sme.two_arches.pdf` 的双拱壳-壳接触测试案例。当前输入仅验证参考几何、壳网格、接触面绑定、1.2 mm 上拱中点位移和显式 micro-step 稳定性;0.5.2 必须将其升级为静力 continuation/global equation 文献路线,输出 load-displacement 路径并由 checker 对比参考指标。 |
| `examples/mohr_coulomb_yield_surface` | PASS | Mohr-Coulomb 本构屈服面验证算例;调用生产 `fem_material_mc_envelope` 和 `material_mc_yield_values` 生成原始材料与 `F=2` 折减材料的压缩包络、伸展包络、张拉截断和代表性应力点分类,checker 复核解析公式、强度折减、elastic/shear/tension/mixed 分支覆盖和 summary。 |
| `examples/strengthReduction` | PARTIAL / FOS PASS / NL CLOUD ROUTE | 对应 `models.geomech.strength_reduction_method.pdf` 的 Mohr-Coulomb 强度折减 benchmark;输入记录 `L1=85 m`、`L2=20 m`、`H1=20 m`、`H2=10 m`、默认 `alpha=45 deg`、0.75 m 网格和 `CONFORMING_INTERFACE=YES`,checker 生成并验证 `strength_reduction_path.csv`、`strength_reduction_cases.csv`、summary、安全系数 bracket、plastic zone、displacement probe 和上下土体界面共享节点。0.5.2 已新增显式 `--nonlinear-chain`,对当前输入执行真实 FE 非线性 trial 并输出 `strength_reduction_nonlinear_chain.csv`/summary;新增 `--nl-write-cloud --nl-cloud-factor 1.525 --nl-cloud-step 1525` 目标云图路线,输出 `strength_reduction_cloud_summary.csv` 和含 displacement/eqps 字段的 `result_00001525.vtk`,checker 会在该 summary 存在时验证云图文件结构和网格计数。cloud 路线可用 `--nl-preconditioner ilu0 --nl-no-line-search --nl-tol 1.0e-3` 运行 0.75 m 全模型,已验证 partial VTK 中含 13776 nodes、6645 elements、displacement 和 eqps 字段;12 m 粗网格 probe 在 `--nl-increments 100 --nl-max-newton 80` 下形成过真实 bracket(下界 1.728、上界 2.0736)。当前仍需用 0.75 m 全模型长跑证明 material case 2、`alpha=45 deg`、`FOS=1.525` 的约 0.3 m PDF 位移云图完整数值复现;此前线性静力 VTK 位移约 196 m,不得作为参考结果。 |
| `examples/euler_column_buckling` | PASS | Euler pinned-pinned column 线性屈曲解析 benchmark;checker 验证一阶临界载荷相对误差、特征残差、`phi^T K_G phi` 归一化、端部位移约束和模态 CSV 输出。 |
| `examples/buckling_corrugated_shell` | PARTIAL | 已从静力 preload smoke 升级为紧凑循环线性屈曲 benchmark;checker 验证 selected wave、critical load、循环/全模型相对误差、循环边界残差、modal CSV 和 profile 输出。它仍不是完整壳 FE 预载屈曲高保真模型。 |
| `examples/roll_forming` | PARTIAL | 已新增 roller kinematics benchmark 和紧凑 J2 springback benchmark,验证平移、下压、角速度、正则化牵引、摩擦能、压力、扭矩、塑性功、塑性区、残余位移和回弹比例;原 friction smoke 保留。它已不再只是弹性接触 surrogate,但仍不是完整三维工件滚压长跑模型。 |
@@ -187,7 +190,7 @@ V5 benchmark 示例当前标记:
| 发布确认提交 | `9f577c0 Fix clean release verification inputs` |
| 发布确认标签 | `v0.5.0-v5-acceptance-checkpoint`,annotated tag,指向 `9f577c0` |
| 正式 0.5.0 标签 | `v0.5.0`,annotated tag,指向 `78dc4a6 Complete V5 documentation governance` |
| TODO 状态 | `todo.md` 中 V5.2 至 V5.10 所有事项均已用 `[x]` 标记完成 |
| TODO 状态 | `todo.md` 中原 V5.2 至 V5.10 事项均已用 `[x]` 标记完成;0.5.2 新增 `examples/two_arches` 文献路线需在后续 todo 中补项 |
| 默认回归 | 本地原工作树和 clean clone 均记录为 `ctest --test-dir build-win-gcc-16 -C Release --output-on-failure` 106/106 passed |
| V5 验收子集 | 本地原工作树和 clean clone 均记录为 `ctest --test-dir build-win-gcc-16 -C Release -L v5_acceptance --output-on-failure` 35/35 passed |
| WSL 多平台复测 | Ubuntu 24.04 / GNU Fortran 13.3.0 / GNU C 13.3.0 / CMake 3.28.3,`build-wsl-gfortran-v5-20-2` 默认 CTest 106/106 passed,`v5_acceptance` 35/35 passed |
@@ -195,14 +198,14 @@ V5 benchmark 示例当前标记:
| OpenMP smoke | `contact_omp1`、`contact_omp4` 和 `perf_contact_pair_omp_consistency` 通过;`perf_contact_pair.exe 64 1` 在 1/4 线程下非计时统计一致 |
| 发布卫生 | 根目录生成结果文件已清理;`v0.5.0` 正式标签已推送;`main` 后续开发版本提升至 `0.5.1` |
| 验收文档 | 新增 `docs/v5_acceptance_report.md` 和 `docs/v5_benchmark_matrix.md` |
| solver 边界 | 第三方/外部求解器接口、工具和测试已移除;内部 CG/BiCGSTAB/GMRES 为当前生产 solver 路径 |
| solver 边界 | 第三方/外部求解器接口、工具和测试已移除;内部 CG/BiCGSTAB/GMRES 与 dense pivoting fallback 为当前生产 solver 路径 |
| 示例边界 | benchmark 编排工具位于 `tools/benchmarks`,示例输入和 checker 位于对应 `examples/<case>/` 目录,不进入 `src` |
当前可明确计入完成范围的能力:
- V5.2 内部 solver 诊断和 no-external-solver 策略。
- V5.2 内部 solver 诊断和 no-external-solver 策略已完成;0.5.2 新增的 `examples/two_arches` 文献路线仍待实现,不计入当前完成范围。
- V5.3 非匹配实体接触、大滑移摩擦、shell-shell 和 shell-solid benchmark。
- V5.4 Mohr-Coulomb 材料点验收和强度折减 benchmark。
- V5.4 Mohr-Coulomb 材料点验收和 PDF 强度折减 benchmark。
- V5.5 Euler 柱解析屈曲、波纹壳紧凑循环屈曲和循环对称验证。
- V5.6 辊运动学、正则化牵引和紧凑 J2 springback benchmark。
- V5.7 cohesive 单积分点和 ball adhesion/decohesion compact benchmark。
@@ -234,7 +237,7 @@ V5 benchmark 示例当前标记:
- 颗粒耦合外力和接触映射接口。
3. 明确 fallback 策略:
- V4 penalty/mortar 权重路径保留为 debug fallback。
- 内部 CG/BiCGSTAB/GMRES 是本模块唯一可接受的生产稀疏线性求解路径。
- 内部 CG/BiCGSTAB/GMRES 与 dense pivoting fallback 是本模块唯一可接受的生产线性求解路径。
- V4 缩减示例保留为 smoke,但不得作为 V5 完成依据。
4. 建立测试等级:
- `smoke`:小规模可执行路径检查。
@@ -256,7 +259,7 @@ V5 benchmark 示例当前标记:
- 完成 `src/solver`、`src/boundary`、`src/material`、`src/coupling`、`src/input` 和 `include` 的 V5 代码落点清单。
- `ctest` 中保留 V1-V4 已验收测试且无回退。
## 7. V5.2 内部稀疏求解器强化
## 7. V5.2 内部稀疏求解器强化与 two arches 文献路线
目标:
@@ -271,7 +274,8 @@ V5 benchmark 示例当前标记:
- `fem_linear_solver_cg.f90` 当前模块名已不能准确表达职责。V5.2 应优先拆分为:
- `fem_linear_solver_dispatch`:保留 `linear_solver_solve/configure/get_stats` 对外入口。
- `fem_linear_solver_iterative`:承载 CG、BiCGSTAB、GMRES 和预条件器。
- 不保留线性求解外部 adapter、外部进程交互、内置直接求解 adapter 或第三方后端注册表;这些路径若重新需要,应在当前模块之外重新立项。
- `fem_linear_solver_dense`:承载内部 dense pivoting fallback,用于小中型非线性修正或回归矩阵,不作为外部 sparse-direct 后端。
- 不保留线性求解外部 adapter、外部进程交互或第三方后端注册表;这些路径若重新需要,应在当前模块之外重新立项。
- 旧外部 method 数值和已删除的 backend 概念必须在配置边界被拒绝,并确认失败时不修改解向量、不触发 fallback solve。
- `fem_solver_implicit` 中所有 `linear_solver_solve` 调用都必须保持无需知道具体后端。
@@ -279,6 +283,7 @@ V5 benchmark 示例当前标记:
- CG 用于对称正定系统,默认配合 none/Jacobi 预条件器。
- BiCGSTAB 用于非对称系统,必须记录 breakdown、未收敛和残差状态。
- GMRES 用于非对称或病态小中型回归系统,必须记录 Arnoldi/最小二乘失败状态。
- DENSE 用于内部小中型 fallback 和诊断,不作为第三方 sparse-direct 后端。
- 旧外部 method 数值只返回配置错误,不进入求解分发。
2. CSR 诊断:
- 支持对称、非对称、正定、不定矩阵能力声明。
@@ -291,17 +296,58 @@ V5 benchmark 示例当前标记:
4. 运行时接口:
- 支持设置 method 和 preconditioner。
- 支持查询实际 method、preconditioner、迭代统计、残差和状态。
- 非 CG/BiCGSTAB/GMRES 的 method 值必须返回配置错误,禁止静默回退。
- 非 CG/BiCGSTAB/GMRES/DENSE 的 method 值必须返回配置错误,禁止静默回退。
5. 验证:
- SPD、非对称、病态、接触切线和约束系统矩阵测试。
- 线性静力、隐式 Newmark、非线性 Newton 修正和接触/约束路径均通过内部 solver dispatch。
### 7.1 `examples/two_arches` 参考文献路线(0.5.2)
0.5.2 需要把 `examples/two_arches` 从“参考几何 + 接触激活 micro-step”升级为
`models.sme.two_arches.pdf` 对应的文献路线测试案例。该案例是 V5.2 新增的
静力/约束求解验收压力测试,不得再用显式动力短步数结果替代文献结果。
文献路线必须记录并实现以下内容:
1. 几何和网格:
- 上拱半径 `Ri_upper=80 mm`,下拱半径 `Ri_lower=100 mm`。
- 壳宽/厚度 `d=3 mm`。
- 上拱弧段 `80 deg`,下拱弧段 `100 deg`。
- 上拱 30 个 mapped shell elements,下拱 75 个 mapped shell elements。
2. 材料和约束:
- 下拱 `E=40 GPa, nu=0.2, rho=1`。
- 上拱 `E=20 GPa, nu=0.3, rho=1`。
- 所有边沿 `y` 向约束用于模拟二维平面应变并抑制面外变形。
- 下拱两端固定;上拱两端保留参考文献中的 in-plane 约束和竖向边载荷。
3. 接触:
- frictionless shell-shell contact。
- upper arch 作为 source/slave,lower arch 作为 destination/master。
- 接触面侧向、法向、active set 和 gap 输出必须由 checker 验证,不能只检查
contact CSV 存在。
4. 加载/求解路线:
- 采用静力 continuation 路线,而不是显式动力 micro-step。
- 实现或提供等价的 global equation:`disp_upper - max_disp*para = 0`。
- `disp_upper` 为上拱中点竖向位移量;`max_disp=60 mm`。
- `para` 按参考路线从 `0` 增至 `1`,首轮实现可采用 `range(0,0.02,1)`
或等价离散 continuation steps。
- 上拱端部竖向边载荷由全局方程/continuation 参数求得,不能直接把中点位移
当成最终文献路线。
5. 输出和验收:
- 输出 `two_arches_path.csv`,至少包含 `para`、`disp_upper`、边载荷因子、
active contact 数、最大 gap/penetration、残差和迭代状态。
- checker 必须验证几何坐标、30/75 网格、`disp_upper=max_disp*para` 约束残差、
接触 active set、非负/有界接触功和 load-displacement 曲线路径。
- 当前 `two_arches_benchmark.inp` 的 micro-step 只能作为几何/接触绑定回归;
它不得进入 0.5.2 文献路线 PASS 证据。
验收条件:
- 默认构建不依赖任何第三方稀疏求解器库或外部求解器进程。
- CG、BiCGSTAB 和 GMRES 的内部路径覆盖静力、隐式和非线性/contact 修正工作流。
- CG、BiCGSTAB、GMRES 和内部 dense pivoting fallback 覆盖静力、隐式和非线性/contact 修正工作流。
- 旧外部 method/backend 接口不再导出;旧 method 数值被拒绝,且不修改解向量、不触发 fallback solve。
- 文档说明 no-external-solver 策略、支持的内部 solver、预条件器和诊断字段。
- `examples/two_arches` 作为 0.5.2 对应测试案例,必须通过文献路线 checker;
micro-step 结果只能作为前置回归,不得作为文献对比结果。
风险控制:
@@ -438,10 +484,13 @@ V5 benchmark 示例当前标记:
- `tests/unit/test_material_mohr_coulomb.f90` 覆盖弹性步、剪切返回、张拉截断、mixed return、旋转剪切、三轴压缩、三轴伸展、纯剪、强度折减残余下限和 `*MOHR COULOMB` 输入解析。
- `tests/unit/test_material_mc_driver.f90` 覆盖 Mohr-Coulomb 单步/路径 driver、三轴路径、张拉路径、branch count、limited 状态、plastic total 和 tangent 诊断。
- `tests/unit/test_material_mc_envelope.f90` 覆盖 Mohr-Coulomb 包络强度、margin、safety ratio、折减材料和非法输入。
- 数学算法、详细设计、接口、测试计划、用户手册和开发者手册已记录 Mohr-Coulomb 屈服函数、张拉截断、状态变量、输入格式、driver 诊断和工程切线限制。
- 数学算法、详细设计、接口、测试计划、用户手册和开发者手册已记录 Mohr-Coulomb 屈服函数、张拉截断、状态变量、输入格式、driver 诊断和活动集算法一致切线。
- 0.5.2 将 `material_mc_tangent` 从 Drucker-Prager 型工程投影切线升级为 shear/tension/mixed 活动集算法一致切线;材料点测试新增有限差分审计,验证 `D_alg * Delta epsilon` 对实际返回映射应力增量的预测误差。
- `ctest --test-dir build-win-gcc-16 -C Release -R "material_mohr_coulomb|material_mc_driver|material_mc_envelope" --output-on-failure` 作为 V5.4 材料点定向验收命令。
- `examples/strengthReduction` 已使用 `MC_SOIL` 和 `*MOHR COULOMB` 替换旧弹性 placeholder;`tools/benchmarks/strength_reduction_benchmark.f90` 调用核心 Mohr-Coulomb 与 strength-reduction driver/report 模块生成安全系数 history、summary、塑性区和位移探针。
- CTest `example_strength_reduction_benchmark` 已接入默认测试图,并在 Windows GCC 16 Release 构建中通过;当前参考结果为 `FS=1.21125`、8 个 trial、3 个 stable trial、5 个 unstable trial 和 2 个 active plastic probes。
- `examples/strengthReduction` 已按 `models.geomech.strength_reduction_method.pdf` 重建:几何为 `L1=85 m`、`L2=20 m`、`H1=20 m`、`H2=10 m`,默认 `alpha=45 deg` 输入采用 0.75 m 网格、C3D8 实体、原生 `*DLOAD, GRAV` 重力体力和 `*MOHR COULOMB`;参考 CSV 覆盖 `alpha=15/25/35/45 deg` 与非关联 Davis B、关联流动两种材料工况。
- `tools/benchmarks/strength_reduction_benchmark.f90` 调用核心 Mohr-Coulomb 与 strength-reduction driver 模块生成 `strength_reduction_path.csv`、`strength_reduction_cases.csv`、summary、塑性区和位移探针;CTest `example_strength_reduction_benchmark` 已改为专用 benchmark checker,不再生成误导性的线性静力 `result_00000001.vtk`。当前 FOS 验收为 8 个 PDF 工况全部收敛、最大 FOS 误差 `6.9392E-03`、86 个 trial、52 个 stable trial、34 个 unstable trial。
- 0.5.2 新增 `--nonlinear-chain` 真实非线性强度折减诊断路线:每个 trial 会重置结构状态、设置材料折减、调用 `fem_solve_static_nonlinear`,并输出 `strength_reduction_nonlinear_chain.csv` 与 `strength_reduction_nonlinear_summary.csv`。非线性静力现在按增量时间缩放外载 `load_factor`,并可通过 `static_ramp_load=.false.` 在伪时间中固定外载;benchmark 记录 `continuation_method`、`last_dt`、`accepted_time`、`correction_norm`、线性迭代数、线性残差和线性状态。NC-1 默认方法已把 nonlinear chain 接到两阶段 load-strength continuation:先在强度因子 `F=1.0` 收敛完整重力/外载,再保留结构状态、固定外载并把强度折减因子 continuation 到 trial 目标。
- 0.5.2 新增 `--nl-write-cloud` 目标云图路线:默认按 PDF 关联流动 `alpha=45 deg` 的 `FOS=1.525` 写出 `strength_reduction_cloud_summary.csv` 与 `result_00001525.vtk`;VTK 文件使用生产 `output_vtk_write`,包含 nodal `displacement` 和 cell `eqps` 字段。0.75 m 路线已补内部 ILU0 预条件器、静力 predictor、自适应 continuation 跳步、每个 accepted segment 后 VTK 刷新,并接入 NC-1 两阶段默认路线;`examples/strengthReduction/check_strength_reduction_results.py` 在该 summary 存在时会检查云图文件、字段和网格计数。当前小参数 method-1 chain/cloud smoke 可完成并写出 method 1 诊断;中等 0.75 m method-1 cloud 探针 `--nl-increments 10 --nl-max-newton 20 --nl-linear-iter 1000 --nl-tol 1.0e-3 --nl-preconditioner ilu0` 超过 120 s 后停止,文献全模型的 `accepted_time=1.0` 参考位移/eqps 云图数值匹配仍需后续 longrun/算法补强证明。
- `ctest --test-dir build-win-gcc-16 -C Release --output-on-failure` 在 V5.4 benchmark 接入后 100/100 passed。
## 10. V5.5 线性屈曲与循环对称
@@ -694,7 +743,7 @@ V5 benchmark 示例当前标记:
| `examples/contact_two_blocks_compression` | 非匹配网格 mortar 压缩 | 压力分布、gap、AL 乘子收敛 |
| `examples/contact_block_sliding` | 大滑移摩擦 mortar | stick/slip、摩擦功、切向反力 |
| `examples/shell_solid_connection` | 壳-实体接触/连接高保真 | 接触压力、能量、位移连续性 |
| `examples/strengthReduction` | Mohr-Coulomb 强度折减 | 安全系数、塑性区贯通 |
| `examples/strengthReduction` | Mohr-Coulomb 强度折减 PDF benchmark | 8 工况安全系数曲线、Davis B/关联材料对比、塑性区与位移停止准则 |
| `examples/buckling_corrugated_shell` | 线性屈曲和循环对称 | 临界载荷、模态形状 |
| `examples/roll_forming` | 真实滚压成形 | 成形力、塑性区、回弹量 |
| `examples/ball_adhesion_decohesion` | cohesive 粘附/脱粘 | 滞回曲线、耗散能、脱粘面积 |
@@ -806,7 +855,7 @@ ctest --test-dir build-win-gcc-16 --output-on-failure
0.5.x 阶段验收建议满足:
- 0.1.0、0.2.0、0.3.3 和 0.4.8 已验收能力无回退。
- 内部 CG/BiCGSTAB/GMRES 求解器覆盖静力、隐式、非线性修正和接触/约束回归;无第三方 solver 依赖。
- 内部 CG/BiCGSTAB/GMRES 求解器和 dense pivoting fallback 覆盖静力、隐式、非线性修正和接触/约束回归;无第三方 solver 依赖。
- 完整 mortar / augmented Lagrangian 接触通过实体、壳、摩擦和 restart benchmark。
- Mohr-Coulomb 材料通过材料点、结构和强度折减 benchmark。
- 线性屈曲特征值分析和循环对称边界通过解析或公开基准。
@@ -922,17 +971,57 @@ OpenMP contact/performance smoke 记录:
### 20.3 工程化补强优先级
1. V5.3:优先补齐完整 mortar/AL 一致切线、更多 restart 场景和 OpenMP
1. 0.5.2:优先实现 `examples/two_arches` 文献路线,补静力 continuation/global
equation、上拱边载荷控制、`disp_upper=max_disp*para` 约束、路径输出和
checker;当前 dynamic micro-step 只保留为几何/接触绑定回归。
2. V5.3:优先补齐完整 mortar/AL 一致切线、更多 restart 场景和 OpenMP
benchmark,目标是把接触主线从 benchmark 完成推进到更接近工业级约束求解。
2. V5.4:补结构级 Mohr-Coulomb 自动 trial 重求解、非线性失稳判据和工程切线
审计,使强度折减从紧凑 benchmark 走向通用结构流程。
3. V5.5:把屈曲从 benchmark 工具推进到主 `femlite` 的通用 `*BUCKLING`
3. V5.4:在已新增 `--nonlinear-chain` 真实 trial 诊断路线、`--nl-write-cloud`
目标 FOS 云图路线、实体 `DLOAD, GRAV`、静力外载增量缩放、conforming
strengthReduction 网格、Mohr-Coulomb 活动集算法一致切线、ILU0
预条件器、静力 predictor、自适应跳步和 partial VTK 刷新基础上,继续完成
0.75 m 全模型 `accepted_time=1.0` longrun、参考位移/eqps 云图数值复现和
结构级长路径审计,使强度折减从 FOS benchmark 走向通用结构流程。
0.5.2 后续待开发算法登记如下,后续实现必须通过 INP 配置文件选择。
`NC-0` 已完成生产入口 `*NONLINEAR CONTINUATION, METHOD=value`;若用户未
显式配置,默认使用 `METHOD=1`。`NC-1` 已有默认两阶段 load-strength
continuation 初版实现,但 0.75 m 全模型长跑尚未完成;`NC-2` 和 `NC-3`
已完成生产控制器和测试覆盖;`NC-4` 已完成直接位移控制 accepted-path
记录/API/CSV,但完整增广弧长方程仍未完成;后续长跑收束仍归入
`NC-1`/`SR-1`;`NC-5` 已完成生产材料点子步接入、INP 控制、
`statev(27:32)` 诊断和 strengthReduction 结构级 MC 聚合输出,但
longrun 效果证明仍未完成。
| 方法编号 | 暂定名称 | 目标用途 | 验收要求 |
|---:|---|---|---|
| 1 | `TWO_STAGE_LOAD_STRENGTH` | 先在 `F=1.0` 收敛完整重力/外载,再固定外载将强度折减因子从 `1.0` continuation 到目标 `FOS`;作为默认算法。 | `examples/strengthReduction` 默认 INP 不给 `METHOD` 时走该路线,能够推进到 `FOS=1.525` 或给出可复现失败诊断。 |
| 2 | `ADAPTIVE_TARGET_NEWTON` | 用目标 Newton 迭代数控制 continuation 步长,低迭代增长,高迭代、cutback 或失败后缩小。 | 高载荷段 cutback 数明显少于当前路线,并在 path CSV 中记录目标步长、实际步长和调整原因。 |
| 3 | `TRUST_REGION_DAMPED_NEWTON` | 对高载荷非线性段限制修正范数,并用残差 merit damping 防止 Newton 过冲。 | 相同输入下残差和位移修正范数有界,失败时输出 trust-region/damping 诊断。 |
| 4 | `ARC_LENGTH_OR_DISPLACEMENT_CONTROL` | 处理纯载荷或强度因子 continuation 无法跨越的极限点、snapback 或局部化路径。 | 至少一个结构非线性路径能输出约束方程残差、弧长/位移控制参数和反力路径。 |
| 5 | `MC_SUBSTEPPING_SEMISMOOTH` | 稳定 Mohr-Coulomb 局部积分,覆盖角点附近 substepping、活动集切换和 semismooth 分支处理。 | 材料点和结构级路径均记录 substep 数、活动分支和局部返回状态,并减少角点附近全局 cutback。 |
第一版生产入口按互斥 `METHOD=` 实现;若后续证明最佳稳定路线需要组合
`1+2+5` 一类策略,应新增明确的辅助 flags,而不是改变方法编号含义。
工程进度列表(截至 2026-06-27):
| 工程项 | 当前状态 | 已有基础/证据 | 下一步工程动作 | 完成标记 |
|---|---|---|---|---|
| NC-0:INP continuation 方法选择器 | DONE | `fem_control` 已新增 `NLC_*` 方法枚举和 `nonlinear_continuation_method` 默认值;`fem_inp_reader`/`fem_inp_helpers` 已支持 `*NONLINEAR CONTINUATION, METHOD=value`,接受 `1..5` 和稳定符号名,非法值报输入错误且不修改已有方法;`strength_reduction_benchmark` 已在 nonlinear chain/cloud/progress 输出中记录方法编号;`implicit_inp` 和 `example_strength_reduction_benchmark` 定向测试通过。 | 后续只在 NC-1 至 NC-5 实现具体算法时扩展方法语义和诊断字段。 | 省略关键字默认 `1`;`1..5` 和符号名可解析;非法值在输入阶段失败;诊断 CSV 记录方法编号;测试覆盖通过。 |
| NC-1:默认两阶段 load-strength continuation | PARTIAL | `fem_control` 新增 `static_ramp_load`,`implicit_solve_nonlinear_static` 可在第二阶段固定外载;`strength_reduction_benchmark` 的 nonlinear chain 和 target cloud 在 `METHOD=1` 时先做 `F=1.0` full-load 平衡,再保留结构状态并把强度折减因子从 `1.0` continuation 到 trial/target;chain/cloud/progress 输出继续记录 `continuation_method=1`。小参数 method-1 chain/cloud smoke 已完成;中等 0.75 m cloud 探针超过 120 s 后停止。 | 降低阶段 A/B 的 Newton、cutback 和线性求解成本;把 NC-2/NC-3/NC-5 的稳定化策略接到 method 1 或显式组合 flags;形成可重复 longrun 命令。 | `examples/strengthReduction` 默认 INP 使用方法 1;能输出明确失败诊断;尚未完成 `FOS=1.525`、`accepted_time=1.0` 和 PDF 云图数值复现。 |
| NC-2:目标 Newton 数自适应步长 | DONE | `fem_control` 已新增 `nlc_target_newton`、`nlc_growth_factor`、`nlc_shrink_factor` 和 target/actual/next increment、Newton 数、adjust reason 诊断;`fem_inp_helpers` 已解析 `METHOD=ADAPTIVE_TARGET_NEWTON`、`TARGET_NEWTON`、`GROWTH`/`GROWTH_FACTOR`、`SHRINK`/`SHRINK_FACTOR`,非法控制在修改状态前失败;`implicit_solve_nonlinear_static` 已按目标 Newton 数进行生产步长增长/保持/缩小和 cutback 后缩步;strengthReduction nonlinear chain/cloud/progress CSV 与 checker 已记录并验证自适应诊断;`solver_implicit`、`implicit_inp` 和 `example_strength_reduction_benchmark` 于 2026-06-27 通过。 | 将 NC-2 作为 NC-1/SR-1 长跑稳定化工具继续组合使用;不再把 benchmark 侧旧跳步规则作为生产控制器。 | path/progress CSV 记录目标步长、实际步长、Newton 数、cutback 数和步长调整原因;生产隐式静力路径完成自动测试覆盖。 |
| NC-3:trust-region / damping Newton | DONE | `fem_control` 已新增 trust radius/min/max、trust growth/shrink、merit accept/good ratio 和 last/next radius、damping、merit ratio、rejection count、trust adjust 诊断;`fem_inp_helpers` 已解析并验证 `TRUST_RADIUS`、`TRUST_MIN_RADIUS`、`TRUST_MAX_RADIUS`、`TRUST_GROWTH`、`TRUST_SHRINK`、`TRUST_ACCEPT_RATIO`、`TRUST_GOOD_RATIO`;`implicit_solve_nonlinear_static` 的 Newton 修正在 line search 前被 trust radius 裁剪,残差增加的 damped correction 会返回可复现 solver failure 并进入既有 cutback/rollback;半径按 merit 下降、damping 和 line-search rejection 更新;strengthReduction nonlinear chain/cloud/progress CSV 与 checker 已记录并验证 trust 诊断;`solver_implicit`、`implicit_inp` 和 `example_strength_reduction_benchmark` 于 2026-06-27 通过。 | 将 NC-3 与 NC-1/SR-1 长跑组合验证;若后续证明需要 `1+2+3+5` 组合路线,新增显式辅助 flag,不改变 `METHOD=3` 的互斥语义。 | 同一输入下修正范数被 radius 限制;失败摘要包含 trust radius、damping 因子、merit ratio 和 rejection count;生产隐式静力路径完成自动测试覆盖。 |
| NC-4:弧长或位移控制 continuation | PARTIAL | `fem_control` 已新增动态 accepted-increment path 表;`METHOD=ARC_LENGTH_OR_DISPLACEMENT_CONTROL` 在非线性静力 accepted increment 后记录直接 prescribed-displacement 路径,字段包括控制参数、控制 DOF 数、目标/实际位移范数、约束残差、反力、广义反力功、Newton 迭代和收敛状态;`fem_api` 已提供 path count/row 查询,`fem_output_csv` 可写 `continuation_path.csv`;`solver_implicit` 与 `implicit_inp` 已覆盖生产路径,定向 CTest 于 2026-06-27 通过;0.5.1 新增生产 `fem_shell_corotational`,`SHELL_GEOMETRIC`/`GEOMETRIC_SHELL`/`COROTATIONAL_SHELL`/`S4_COROTATIONAL` INP 布尔控制、S4 corotational 内力路径、刚体对象性、小转角一致性、弹性 algorithmic tangent 有限差分列回归、非对称切线接受、prestress-delta membrane geometric stiffness 回归,并在非 `ELASTIC` 壳材料请求 corotational tangent 时显式返回材料错误;`fem_dload_tangent` 已把 shell `DLOAD P` follower-pressure tangent 接入非线性静力/Newmark Newton 矩阵,并由 `test_shell_pressure` 做有限差分回归;spherical-cap checker 已校验显式开关,并在可选 nonlinear route 中要求 post-peak load drop 和 restiffening,防止单调小应变曲线被误判为后屈曲通过。`examples/spherical_cap_with_central_point_load` 已新增 PDF Shell-4 nonlinear diagnostic deck,可由 checker 在 `FEMLITE_SPHERICAL_CAP_NONLINEAR=1` 时尝试,但当前核心壳后屈曲路径仍因缺少通用 Riks/arc-length 增广方程、塑性/多层壳 algorithmic tangent、完整弯曲/剪切 prestress 项和全部 load-family follower tangent 而以 Newton 非收敛结束,默认 CTest 保持 Shell-16 小应变基线。 | 继续实现通用 load/displacement/arc-length 增广方程、扩展未知量、约束切线和路径切换;补齐塑性/多层壳 algorithmic tangent、弯曲/剪切初应力项、其他 follower-load tangent、Shell-4/8/16 spherical cap `-6.2 m` 路径收敛和非单调载荷-位移验收。 | 至少一个结构路径输出约束残差、控制参数、反力和非单调路径;不能退化为单步线性位移样本;完整弧长/Riks 能通过参考案例。 |
| NC-5:MC substepping / semismooth 活动集 | PARTIAL | Mohr-Coulomb shear/tension/mixed 活动集算法一致切线有限差分审计已完成;`fem_control` 和 `fem_inp_helpers` 已支持 `MC_MIN_SUBSTEPS`、`MC_MAX_SUBSTEPS`、`MC_TARGET_STRAIN`、`MC_YIELD_TOL` 和 `MC_PLASTIC_LIMIT`;`METHOD=MC_SUBSTEPPING_SEMISMOOTH` 已在生产材料分发中调用 `fem_material_mc_driver`,并把 accepted/requested substeps、driver status、branch mask、max yield residual 和 max plastic increment 写入 `statev(27:32)`;strengthReduction nonlinear chain/cloud/progress 已汇总 `mc_points`、`mc_updated_points`、accepted/requested substeps、limited points、branch mask、max yield residual 和 max plastic step,checker 会拒绝缺失或非法 MC 诊断;`test_material_mohr_coulomb`、`test_implicit_inp` 和 `example_strength_reduction_benchmark` 定向 CTest 通过,额外 nonlinear chain/cloud smoke 已由 checker 验证 optional MC 诊断。 | 补 0.75 m PDF cloud longrun 对比,证明局部子步能减少角点附近 cutback 或局部返回失败。 | 材料点与结构级输出均包含 substep 数、活动分支、局部返回状态;角点附近全局 cutback 减少。 |
| SR-1:0.75 m PDF 云图复现验收 | PARTIAL | 当前 0.75 m cloud route 已生成 partial VTK,含 13776 nodes、6645 elements、displacement 和 eqps;位移从 `9.7294e-4 m` 增至 `2.9383e-2 m`,但未到 PDF 目标约 `0.3 m`。 | 以 NC-1 为默认路线,逐步接入 NC-2/NC-3/NC-5,完成 material case 2、`alpha=45 deg`、`FOS=1.525` 长路径。 | `accepted_time=1.0` 或固定外载强度因子 `F=1.525` 完整达成;checker 验证位移云图量级、eqps/plastic zone 和非线性诊断。 |
4. V5.5:把屈曲从 benchmark 工具推进到主 `femlite` 的通用 `*BUCKLING`
step,接入静力预载后的壳/实体几何刚度装配和模态输出。
4. V5.6:将滚压 kinematics/springback benchmark 的核心路径整合为通用滚压工艺
5. V5.6:将滚压 kinematics/springback benchmark 的核心路径整合为通用滚压工艺
step,补三维工件网格、restart 多 step 和长跑稳定性。
5. V5.7:把 cohesive law/state/metrics 接入主接触流程,补普通接触/cohesive
6. V5.7:把 cohesive law/state/metrics 接入主接触流程,补普通接触/cohesive
状态切换、切线和 restart 长路径。
6. V5.8:扩展颗粒邻域搜索性能、大颗粒数 longrun 和能量稳定性检查,但继续保持
7. V5.8:扩展颗粒邻域搜索性能、大颗粒数 longrun 和能量稳定性检查,但继续保持
不依赖外部颗粒求解器。
0.5.1 已推进内容: