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
+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 图案、对角项和数值对称性,并记录初始残差、最终残差和最终相对残差。