Complete V4.6 linear solver interface
FemLite CI / build-test (push) Has been cancelled

This commit is contained in:
shenw
2026-06-25 09:49:03 +08:00
parent 62f1293a9f
commit c2db5f59c6
16 changed files with 745 additions and 15 deletions
+8
View File
@@ -862,6 +862,7 @@ 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 + none/Jacobi,并记录最近一次线性求解方法、预条件器、迭代数、残差和状态。
## 17. 稀疏矩阵模块
@@ -875,6 +876,13 @@ end subroutine
- dense 仅用于单元局部矩阵和调试。
- skyline 非第一优先级。
V4.6 线性求解器抽象仍位于 `fem_linear_solver_cg.f90`,保留 `linear_cg_solve` 兼容入口,同时新增:
- `linear_solver_solve`:根据 `fem_control` 中的 `linear_solver_method / linear_precond_method` 分发。
- `linear_bicgstab_solve`:用于非对称或非正定 CSR 小系统的内部备用路径。
- `linear_solver_configure / linear_solver_get_settings / linear_solver_get_stats`:配置和查询当前/最近一次线性求解器状态。
- `LSOLVER_EXTERNAL` 当前作为外部稀疏求解器占位,配置允许,实际求解返回 unsupported 状态。
## 18. 输出模块
模块:fem_output_csv.f90
+39 -1
View File
@@ -43,6 +43,7 @@
- node-based surface、analytical rigid plane surface 和 contact property 查询/输入子集。
- contact pair active-set、gap residual 和 augmented penalty 诊断接口。
- contact pair 搜索统计接口,用于 V4.4 搜索/并行性能验收。
- 线性求解器设置和最近一次线性求解统计接口,用于 V4.6 内部/外部求解路径切换验收。
## 3. 接口设计原则
@@ -581,7 +582,43 @@ 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 进入多准则统计,硬收敛判据仍以力残差为主。
### 12.6 接触状态
### 12.6 线性求解器控制
V4.6 提供内部线性求解器配置和最近一次求解统计查询:
```fortran
subroutine fem_set_linear_solver(method, preconditioner, ierr)
integer, intent(in) :: method
integer, intent(in) :: preconditioner
integer, intent(out) :: ierr
end subroutine
subroutine fem_get_linear_solver_settings(method, preconditioner, ierr)
integer, intent(out) :: method
integer, intent(out) :: preconditioner
integer, intent(out) :: ierr
end subroutine
subroutine fem_get_linear_solver_stats(method, preconditioner, iteration, &
residual_norm, status_code, ierr)
integer, intent(out) :: method
integer, intent(out) :: preconditioner
integer, intent(out) :: iteration
real(rk), intent(out) :: residual_norm
integer, intent(out) :: status_code
integer, intent(out) :: ierr
end subroutine
```
说明:
- `method` 使用 `LSOLVER_CG=1`、`LSOLVER_BICGSTAB=2`、`LSOLVER_EXTERNAL=100`。
- `preconditioner` 使用 `LPRECOND_NONE=0`、`LPRECOND_JACOBI=1`。
- `status_code` 使用 `LS_STATUS_IDLE=0`、`LS_STATUS_CONVERGED=1`、`LS_STATUS_FAILED=-1`、`LS_STATUS_UNSUPPORTED=-2`。
- `LSOLVER_EXTERNAL` 仅作为外部稀疏求解器预留路径;当前配置可记录,但实际求解返回 unsupported。
- 静力、隐式 Newmark 和非线性 Newton 修正方程均通过同一分发层求解。
### 12.7 接触状态
第三版提供接触结果查询接口:
@@ -943,4 +980,5 @@ fem_finalize
- C ABI 暴露 `femlite_get_convergence_status`,其中 `converged` 使用 `int` 返回 0/1。
- C ABI 暴露 `femlite_get_convergence_metrics`,返回相对力残差、contact gap residual 和 combined norm。
- C ABI 暴露 `femlite_get_convergence_diagnostics`,返回 cutback 次数、最后步长、最后有效时间、收敛状态码和失败原因码。
- C ABI 暴露 `femlite_set_linear_solver`、`femlite_get_linear_solver_settings` 和 `femlite_get_linear_solver_stats`,返回/设置值与 Fortran API 常量一致。
- 上述函数只追加新符号,不改变 `femlite_get_contact_summary` 的签名和含义。
+2
View File
@@ -60,6 +60,7 @@ Python 环境约定:
- active set、gap residual 和 augmented penalty 诊断测试。
- 摩擦正则化、摩擦功和最大累计滑移输出测试。
- 接触示例 smoke 测试应覆盖刚性平面压入、两实体块面-面压缩和壳-刚性平面接触。
- 线性求解器分发测试应覆盖 CG、BiCGSTAB、none/Jacobi 预条件、外部求解器占位和最近一次求解统计。
## 4. 测试目录结构
@@ -299,6 +300,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 对应包装返回当前线性求解器、预条件器、最近一次迭代数、残差和状态;模块测试覆盖 BiCGSTAB 非对称小系统,`implicit_inp` 覆盖隐式路径切换到 BiCGSTAB。
- 删除单元状态可输出。
示例结果留存策略:
+2 -1
View File
@@ -17,6 +17,7 @@ FemLite 0.4.3 是船舶接触爆炸结构响应 FEM 软件的第四版接触增
- element/node/analytical surface 子集、contact property 子集、刚性平面接触和面-面 contact pair 阶段能力。
- contact pair active set、gap residual 和 augmented penalty 诊断输出。
- 静力/隐式求解的收敛状态和 cutback 诊断查询接口。
- 内部线性求解器可在 CG 和 BiCGSTAB 间切换,并提供预条件和迭代统计查询。
- CSV、VTK、restart 和 contact CSV 输出。
- Fortran95 原生接口、C ABI 子集和 Python 调试脚本。
@@ -239,7 +240,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 次数、最后步长、最后有效时间、状态码和失败原因码。C ABI 提供同名 `femlite_get_*` 包装,`converged` 使用 0/1 整数返回。
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` 与 `none/Jacobi` 预条件,`fem_get_linear_solver_stats` 查询最近一次线性求解迭代数、残差和状态。C ABI 提供同名 `femlite_get_*`/`femlite_set_*` 包装,`converged` 使用 0/1 整数返回。
建议把大型结果输出到 `examples/.../results/...` 或独立 `output/` 目录。仓库 `.gitignore` 默认忽略大规模结果文件。
+5 -3
View File
@@ -76,7 +76,7 @@ src/interface C ABI 和 Fortran-C bridge
|---|---|
| `fem_precision` | 全局精度、维度、版本常量 |
| `fem_error` | 错误码和错误消息 |
| `fem_control` | 时间步、求解控制、输出控制和 V4.5 收敛/接触 gap 诊断快照 |
| `fem_control` | 时间步、求解控制、输出控制、V4.5 收敛诊断和 V4.6 线性求解器状态 |
| `fem_api` | Fortran95 公共 API |
| `fem_inp_reader` | 两遍 INP 读取主流程 |
| `fem_inp_defs` | INP 模式常量 |
@@ -214,9 +214,11 @@ fem_contact_output.f90 contact CSV 字段辅助
求解器核心文件:
- `fem_assembly_csr.f90`:DOF 获取、CSR 图案和装配。
- `fem_linear_solver_cg.f90`:Jacobi 预条件 CG。
- `fem_linear_solver_cg.f90`:线性求解器分发层、Jacobi/none 预条件、CG、BiCGSTAB 和外部求解器占位。
- `fem_solver_implicit.f90`:静力、隐式 Newmark、非线性 Newton。
V4.6 起,隐式求解器内部不再直调 CG,而是通过 `linear_solver_solve` 分发。新增线性求解器时应先在该分发层注册 method 常量、预条件支持、统计状态和模块测试,再接入 Fortran API / C ABI。
新增求解路径时应明确:
- 是否需要质量矩阵。
@@ -281,7 +283,7 @@ C ABI:
- 实现:`src/interface/fem_c_api.c`。
- Fortran-C bridge:`src/interface/fem_fortran_bridge.f90`。
C ABI 当前暴露初始化、读取、构建、显式推进、SPH 力、facet 查询、节点运动学、contact summary、contact diagnostics、contact friction summary、contact history stats 和 restart 子集。
C ABI 当前暴露初始化、读取、构建、显式推进、SPH 力、facet 查询、节点运动学、contact summary、contact diagnostics、contact friction summary、contact history stats、线性求解器设置/统计和 restart 子集。
Python 调试接口:
+33 -1
View File
@@ -592,7 +592,7 @@ FemLite 0.4.x 定位为:
| S9 | 壳局部平面几何近似 | B 类。用曲壳基准矩阵约束误差,补充法向、曲率和局部坐标诊断;不承诺完整有限转动壳最终形态 | V4.7 |
| S10 | 壳塑性 section tangent 基准不足 | A 类。补充弯曲/剪切塑性切线验证、卸载路径、长跑基准和 trial/rollback 回归 | V4.7 |
| S11 | 集中质量和壳转动惯量对角近似 | B 类。显式继续默认集中质量;隐式路径增加一致质量或改进转动惯量选项的设计和小算例验证 | V4.5, V4.6 |
| S12 | CG + Jacobi 单一路径 | A 类。建立线性求解器抽象,增加 BiCGSTAB/GMRES 或等价内部求解器、预条件接口和外部稀疏求解器预留 | V4.6 |
| S12 | CG + Jacobi 单一路径 | DONE。已建立线性求解器分发层,支持 CG、BiCGSTAB、none/Jacobi 预条件、统计查询和外部求解器占位 | V4.6 |
| S13 | MPC penalty 约束 | C 类。0.4.x 保留 penalty MPC,补充病态诊断和回归;严格 Lagrange multiplier 或 multiplier-augmented MPC 进入后续 | V4.5 |
| S14 | 小应变 J2/J2_JC + Jaumann 客观率 | C 类。0.4.x 重点做接触/隐式稳定性验证和文档边界;完整 `F = Fe Fp` 大变形塑性列入 0.5.0 或后续 | V4.5, V4.7 |
| S15 | restart 不保存完整模型数据库 | B 类。V4.3 已同步保存 mortar 积分点摩擦历史;0.4.x 后续继续同步新增求解状态,完整 inp 数据库级 restart 作为后续增强 | V4.3, V4.8 |
@@ -810,3 +810,35 @@ FemLite 0.4.x 定位为:
- 标定 contact gap residual 作为可选硬收敛准则时的量纲、容限和默认开关。
- 补充更长时间的非线性静力/非线性 Newmark 接触长跑基准。
## 27. 0.4.6 开发记录
### V4.6 稀疏线性求解器接口完善
完成状态:V4.6 线性求解器抽象、内部可切换求解路径、预条件选择和最近一次求解统计已形成阶段完善基线;外部稀疏求解器当前为显式 unsupported 占位。
已完成:
- `fem_control` 新增线性求解器方法、预条件方法和最近一次线性求解统计状态。
- `fem_linear_solver_cg` 保留兼容 `linear_cg_solve`,新增 `linear_solver_solve` 分发层。
- 新增 BiCGSTAB 内部求解器,覆盖非对称 CSR 小系统。
- 预条件器支持 `LPRECOND_NONE` 和 `LPRECOND_JACOBI`。
- 隐式线性静力、线性 Newmark、非线性静力 Newton 修正方程和非线性 Newmark 修正方程均改为通过分发层求解。
- `LSOLVER_EXTERNAL` 作为外部稀疏求解器预留 method;当前实际求解返回 `LS_STATUS_UNSUPPORTED`。
- 新增 Fortran API `fem_set_linear_solver`、`fem_get_linear_solver_settings` 和 `fem_get_linear_solver_stats`。
- C ABI 新增 `femlite_set_linear_solver`、`femlite_get_linear_solver_settings` 和 `femlite_get_linear_solver_stats`。
已补充测试:
- `linear_solver_cg` 回归继续覆盖原 CG 入口、零 RHS 和非收敛路径。
- `linear_solver_cg` 回归覆盖分发层 CG + none 预条件。
- `linear_solver_cg` 回归覆盖 BiCGSTAB + Jacobi 求解非对称 CSR 小系统。
- `linear_solver_cg` 回归覆盖外部求解器占位的 unsupported 状态。
- `implicit_inp` 回归将隐式线性静力路径切换到 BiCGSTAB,并检查最后一次线性求解统计。
- `c_api` 回归覆盖线性求解器默认设置、空模型统计、切换到 BiCGSTAB + none 和恢复默认。
- `source_size` 定向 CTest 已通过,新增求解器接口未触发源码规模硬阈值。
后续:
- 在 V4.6 后续或 V4.8 中补充更大规模非对称/病态矩阵求解器基准。
- 预留 ILU/SSOR 或外部库后端适配,不影响当前 CG/BiCGSTAB 默认路径。