Add convergence status diagnostics
FemLite CI / build-test (push) Has been cancelled

This commit is contained in:
shenw
2026-06-25 09:07:54 +08:00
parent 255c7caf4f
commit d2dc7ab689
11 changed files with 207 additions and 4 deletions
+10
View File
@@ -545,6 +545,15 @@ subroutine fem_get_convergence_status(increment, iteration, residual_norm, &
end subroutine
```
说明:
- `increment` 为最近一次静力/隐式求解尝试的实际步号或增量号。
- `iteration` 为该增量内最近一次 Newton 迭代号;求解尚未开始时为 0。
- `residual_norm` 为最近一次力残差范数。
- `correction_norm` 为最近一次位移修正范数;线性路径或尚未形成修正时为 0。
- `converged` 表示最近一次记录的增量是否已满足收敛准则。
- V4.5 起,非线性静力 Newton 迭代会实时更新该状态;后续 cutback 和多准则收敛诊断沿用同一查询口径。
### 12.6 接触状态
第三版提供接触结果查询接口:
@@ -904,4 +913,5 @@ fem_finalize
- C ABI 追加 `femlite_get_contact_search_stats`,返回 contact pair 搜索 facet/master/candidate/active/BVH 节点统计。
- C ABI 追加 `femlite_get_contact_perf_stats`,返回 contact search/force/tangent CPU 时间统计。
- C ABI 追加 `femlite_get_contact_cache_stats`,返回 BVH 候选缓存使用和溢出统计。
- C ABI 暴露 `femlite_get_convergence_status`,其中 `converged` 使用 `int` 返回 0/1。
- 上述函数只追加新符号,不改变 `femlite_get_contact_summary` 的签名和含义。
+2
View File
@@ -251,6 +251,7 @@ SPH总力映射测试 relative tolerance 1.0e-10 to 1.0e-8
- 线性静力实体 patch test。
- 线性静力壳 patch test。
- 非线性静力 Newton 收敛。
- 非线性静力收敛状态查询,检查最新增量、迭代号、残差范数、修正范数和收敛标志。
- 非线性静力步长缩减。
- 非线性静力线搜索和失败回滚测试。
- 隐式 Newmark 单步预测校正。
@@ -297,6 +298,7 @@ SPH总力映射测试 relative tolerance 1.0e-10 to 1.0e-8
- `fem_get_contact_search_stats` 和 C ABI `femlite_get_contact_search_stats` 返回 contact pair 搜索 facet/master/candidate/active/BVH 节点统计。
- `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` 和 C ABI `femlite_get_convergence_status` 返回最近一次求解的增量、迭代、残差、修正范数和收敛标志;空模型零状态和非线性静力收敛状态均需覆盖。
- 删除单元状态可输出。
示例结果留存策略:
+24
View File
@@ -772,3 +772,27 @@ FemLite 0.4.x 定位为:
- 评估按 slave facet 的线程私有力增量和历史提交边界,进一步缩短 force 路径全局提交临界区。
- 补充更大规模 OpenMP 性能测试,继续评估分块 CSR 累加或线程私有增量合并。
## 26. 0.4.5 开发记录
### V4.5 隐式非线性收敛诊断起步
完成状态:V4.5 起步,新增求解收敛状态查询底座;完整自适应步长、多准则收敛和失败诊断仍继续推进。
已完成:
- `fem_control` 新增最近一次收敛状态快照,记录增量号、Newton 迭代号、力残差范数、位移修正范数和收敛标志。
- 非线性静力 Newton 迭代在每次残差评估后更新收敛状态,修正方程求解后同步记录位移修正范数。
- 新增 Fortran API `fem_get_convergence_status`,补齐接口文档中第三版已承诺的静力/隐式收敛状态查询。
- C ABI 新增 `femlite_get_convergence_status`,以 `int` 形式返回 `converged` 的 0/1 状态。
已补充测试:
- `implicit_inp` 回归在非线性静力弹性算例后查询收敛状态,检查最后增量已收敛、残差在容限内并且迭代号有效。
- `c_api` 回归检查初始化和建模后、尚未求解时的收敛状态为零值且未收敛。
后续:
- 将非线性 Newmark Newton 的修正范数和失败状态接入同一查询口径。
- 在 cutback 失败路径中补充失败原因、cutback 次数和最后有效时间步诊断。
- 将 contact gap/mortar residual 纳入 V4.5 多准则收敛统计。