Complete V4.5 convergence diagnostics
FemLite CI / build-test (push) Has been cancelled

This commit is contained in:
shenw
2026-06-25 09:33:20 +08:00
parent d2dc7ab689
commit 62f1293a9f
18 changed files with 574 additions and 44 deletions
+21 -7
View File
@@ -676,7 +676,7 @@ FemLite 0.4.x 定位为:
后续:
- 将 gap/mortar 残差接入非线性求解统计和收敛准则。
- gap/mortar 残差已在 V4.5 接入非线性求解统计;后续继续标定接触穿透硬收敛准则。
- 增强 contact tangent 对 active set 状态和增广路径的诊断输出。
- 将 pair 级 augmented penalty 乘子推进到 mortar 积分点级历史,并在后续 V4.x 中与摩擦历史统一调试输出。
@@ -775,24 +775,38 @@ FemLite 0.4.x 定位为:
## 26. 0.4.5 开发记录
### V4.5 隐式非线性收敛诊断起步
### V4.5 隐式非线性收敛诊断完善
完成状态:V4.5 起步,新增求解收敛状态查询底座;完整自适应步长、多准则收敛和失败诊断仍继续推进。
完成状态:V4.5 收敛诊断和 cutback 失败诊断已形成阶段完善基线;contact gap/mortar residual 已纳入多准则统计,硬接触穿透停止准则保留为后续标定项。
已完成:
- `fem_control` 新增最近一次收敛状态快照,记录增量号、Newton 迭代号、力残差范数、位移修正范数和收敛标志。
- `fem_control` 新增最近一次收敛状态快照,记录增量号、Newton 迭代号、力残差范数、相对力残差、位移修正范数、contact gap residual、combined norm 和收敛标志。
- `fem_control` 新增收敛状态码、失败原因码、累计 cutback 次数、最后尝试步长和最后有效时间诊断。
- 非线性静力 Newton 迭代在每次残差评估后更新收敛状态,修正方程求解后同步记录位移修正范数。
- 非线性 Newmark 单步在每次残差评估和位移修正后更新同一收敛状态快照。
- contact force 评估将 contact pair gap residual 同步到收敛 metrics。
- 新增 Fortran API `fem_get_convergence_status`,补齐接口文档中第三版已承诺的静力/隐式收敛状态查询。
- 新增 Fortran API `fem_get_convergence_metrics`,查询相对残差、contact gap residual 和 combined norm。
- 新增 Fortran API `fem_get_convergence_diagnostics`,查询 cutback 次数、最后步长、最后有效时间、状态码和失败原因码。
- C ABI 新增 `femlite_get_convergence_status`,以 `int` 形式返回 `converged` 的 0/1 状态。
- C ABI 新增 `femlite_get_convergence_metrics`。
- C ABI 新增 `femlite_get_convergence_diagnostics`。
- 静力 cutback 成功/失败路径和非线性 Newmark cutback 运行路径更新累计 cutback 诊断。
已补充测试:
- `implicit_inp` 回归在非线性静力弹性算例后查询收敛状态,检查最后增量已收敛、残差在容限内并且迭代号有效。
- `implicit_inp` 回归检查非线性静力成功路径 cutback 次数为 0、最后步长为 0.25、状态码为 converged。
- `implicit_inp` 回归检查非线性静力成功路径相对残差在容限内、contact gap residual 为 0,并且 combined norm 覆盖分项 metrics。
- `contact` 回归检查 contact pair active-set 小算例将非零 gap residual 写入 convergence metrics。
- `solver_implicit` 回归检查非线性 Newmark 线弹性算例写出非零位移修正范数。
- `solver_implicit` 回归检查非线性静力 cutback 失败路径累计 2 次 cutback、最后尝试步长为 0.25、最后有效时间保持为 0、状态码为 failed、失败原因为 cutback limit,且试算状态回滚。
- `c_api` 回归检查初始化和建模后、尚未求解时的收敛状态为零值且未收敛。
- `c_api` 回归检查初始化和建模后的收敛 diagnostics 为 idle 零值。
- `c_api` 回归检查初始化和建模后的 convergence metrics 为零值。
后续:
- 将非线性 Newmark Newton 的修正范数和失败状态接入同一查询口径。
- 在 cutback 失败路径中补充失败原因、cutback 次数和最后有效时间步诊断。
- 将 contact gap/mortar residual 纳入 V4.5 多准则收敛统计。
- 标定 contact gap residual 作为可选硬收敛准则时的量纲、容限和默认开关。
- 补充更长时间的非线性静力/非线性 Newmark 接触长跑基准。