Release FemLite 0.6.1
FemLite CI / build-test (push) Has been cancelled

This commit is contained in:
shenw
2026-07-01 22:41:16 +08:00
parent 175531e24d
commit 5e081806fb
32 changed files with 2819 additions and 238 deletions
+9 -1
View File
@@ -365,11 +365,19 @@ slave_surface, master_surface
`contact_XXXXXXXX.csv` 当前字段包含:
```text
kind,pair_id,active_count,max_penetration,force_norm,work_estimate,cumulative_work,stick_count,slip_count,accumulated_slip,friction_work,friction_work_total,friction_regularization,ftx,fty,ftz,status,activation_count,release_count,gap_residual,aug_factor,aug_lambda,search_facets,search_masters,search_candidates,search_active,search_bvh_nodes,search_cache_used,search_cache_overflow,search_cpu_time,contact_force_cpu_time,contact_tangent_cpu_time
kind,pair_id,active_count,max_penetration,force_norm,work_estimate,cumulative_work,stick_count,slip_count,accumulated_slip,slip_increment_norm,slip_residual,friction_residual,friction_work,friction_work_total,friction_regularization,ftx,fty,ftz,status,activation_count,release_count,gap_residual,gap_mean,gap_l2,failed_projection_count,active_set_flip_count,open_count,closed_stick_count,closed_slip_count,closed_restick_count,separating_count,state_failed_projection_count,aug_factor,aug_lambda,search_facets,search_masters,search_candidates,search_active,search_bvh_nodes,search_cache_used,search_cache_overflow,search_cpu_time,contact_force_cpu_time,contact_tangent_cpu_time
```
`search_*` 字段在 `SUMMARY` 行给出最近一次 contact pair 力评估的全局搜索统计、BVH 候选缓存使用情况和 `cpu_time` 口径秒数;逐 `PAIR` 行给出对应接触对的搜索、缓存和计时统计。`cpu_time` 是轻量趋势诊断,小算例中可能显示为 0。
当输出目录启用且存在非线性生命周期状态时,`nonlinear_lifecycle.csv`
记录最新 increment 的事件、失败/切回原因、残差分解、线性求解器 method、
preconditioner、迭代数、状态、残差和 fail class,以及 rollback/commit audit
计数。`continuation_path.csv` 保持旧列顺序,并在尾部追加 Riks/arc 诊断列:
`arc_mode`、`arc_predictor_consistent`、`arc_load_reversal`、
`arc_turning_point`、`arc_length`、`arc_load_delta` 和 `arc_predictor_dot`。
`arc_mode=1` 表示载荷型 Riks path,`arc_mode=2` 表示直接位移控制 path。
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` 默认忽略大规模结果文件。