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

This commit is contained in:
shenw
2026-07-01 18:39:18 +08:00
parent 75d4e735b1
commit 2b7962eb96
51 changed files with 3084 additions and 2175 deletions
+19
View File
@@ -1242,3 +1242,22 @@ subroutine database_allocate(ierr)
subroutine database_initialize(ierr)
subroutine database_finalize(ierr)
```
## 21. 0.5.3 Diagnostic Design Addendum
0.5.3 is a diagnostic hardening release, not a broad contact-solver rewrite.
The production boundary is:
- Nonlinear failures carry stable reason ids/names through the convergence
diagnostic path.
- Nonlinear residual storage separates total, force, contact, constraint, arc
and material-local-failure categories when those quantities are available.
- Contact summaries expose stable state counts, gap/penetration statistics,
slip/friction residuals, multiplier/augmentation diagnostics and active-set
flip counts.
- Contact restart version 4 preserves accepted-increment diagnostic state in
the optional `CONTACT_PAIR_DIAGNOSTICS` block.
- Mortar/friction tangent work in 0.5.3 is an audit interface. It splits normal,
stick and slip finite-difference errors and rigid/energy residuals; it does
not replace the production contact path with a complete industrial
AL/mortar consistent tangent.
@@ -1754,3 +1754,23 @@ load-strength continuation:阶段 A 随非线性静力增量缩放外载并收
trust-region damped Newton 已进入生产非线性静力路径,并在 chain/cloud/progress
CSV 中输出相应诊断;0.75 m 临界失稳位移/eqps cloud 属于后续
longrun/研究验证,不作为 V5 PASS 条件。
## 20. 0.5.3 Diagnostic Algorithms
0.5.3 adds diagnostic algorithms around existing nonlinear and contact paths:
- Nonlinear failure taxonomy maps known cutback/Newton/linear-solver/contact/
material/constraint causes to stable reason ids and names while preserving
existing status codes.
- Residual breakdown stores total, force, contact, constraint, arc and material
local-failure categories. Categories that are not assembled by a path remain
zero instead of changing the older scalar residual contract.
- Contact state diagnostics map current history into `open`, `closed-stick`,
`closed-slip`, `closed-restick`, `separating` and `failed-projection` counts.
- Contact residual diagnostics include maximum penetration, mean gap, gap L2,
failed projection count, active-set flip count, slip increment/residual,
friction residual, multiplier residual and augmentation/update quantities.
- Tangent diagnostics remain finite-difference audits. Normal-contact,
friction-stick and friction-slip branches are reported separately, with rigid
translation and energy probes. This is not a complete production AL/mortar
consistent tangent derivation.
+33
View File
@@ -1447,3 +1447,36 @@ fem_finalize
`femlite_get_linear_solver_stats` 和 `femlite_get_linear_solver_diagnostics`,
返回/设置值与 Fortran API 常量一致。
- 上述函数只追加新符号,不改变 `femlite_get_contact_summary` 的签名和含义。
## 18. 0.5.3 Diagnostic Interface Addendum
Fortran diagnostic API:
- `fem_get_residual_breakdown(total_residual, force_residual,
contact_residual, constraint_residual, arc_residual,
material_fail_count, ierr)` returns the latest nonlinear residual
decomposition. Missing categories are returned as zero, preserving older
scalar residual queries.
CSV/output schema:
- `continuation_path.csv` appends `residual_total`, `residual_force`,
`residual_contact`, `residual_constraint`, `residual_arc` and
`material_failure_count` before `reason_id` and `reason_name`.
- Contact CSV/report output may include stable state counts, mean/L2 gap,
maximum penetration, failed projection count, active-set flip count,
slip increment/residual, friction residual, multiplier residual,
augmentation factor/update diagnostics and augmented multiplier values.
Restart schema:
- Restart files with version 4 may include optional
`CONTACT_PAIR_DIAGNOSTICS` rows after `CONTACT_MULTIPLIER`.
- Readers still accept older restart versions and old files ending directly at
`END`; version 4 is required only to round-trip the new accepted-increment
contact diagnostic fields.
Boundary:
- 0.5.3 documents audit and diagnostic interfaces. It does not claim complete
industrial AL/mortar consistent tangent support.
+23
View File
@@ -844,3 +844,26 @@ V4.2 阶段完成条件:
- Fortran API 和 C ABI 可查询接触诊断统计。
- rigid plane indentation、two blocks compression 和 shell rigid plane contact 三个小算例可运行并生成 VTK 与接触结果。
- CTest 全量回归通过,`source_size` 无 hard-threshold 失败。
## 25. 0.5.3 Diagnostic Regression Addendum
0.5.3 targeted regression commands:
```powershell
cmake --build build-codex-gcc --parallel
ctest --test-dir build-codex-gcc -R "^(solver_implicit|implicit_inp|linear_solver_cg|restart|contact_mortar_report|contact_mortar_tangent|contact_multiplier_report|perf_contact_pair_omp_consistency)$" --output-on-failure
ctest --test-dir build-codex-gcc -R "^(example_contact_two_blocks_compression_benchmark|example_contact_block_sliding_benchmark|example_shell_shell_contact_benchmark|example_shell_solid_contact_benchmark)$" --output-on-failure
ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure
```
Acceptance criteria:
- New nonlinear failure reason ids/names are consumed by solver tests.
- Residual breakdown fields are present in API storage and path CSV output.
- Contact state, gap, slip/friction, multiplier and augmentation diagnostics
are consumed by contact tests or benchmark checkers.
- Restart preserves accepted-increment contact diagnostics.
- OpenMP contact consistency compares deterministic state/force/tangent/cache
diagnostics and ignores timing-only differences.
- Documentation must keep the explicit boundary that 0.5.3 does not deliver a
complete industrial AL/mortar consistent tangent rewrite.
+17
View File
@@ -570,3 +570,20 @@ V5 当前开发态记录:
- 颗粒耦合当前已具备内置离散球颗粒、颗粒-facet 映射和动态柔性容器紧凑 benchmark;它不是工业规模 DEM 长跑,也不接入外部颗粒求解器。
- 非线性 Newmark-Newton 和复杂壳塑性仍需要更多工程基准和长时间稳定性验证。
- 大型工程算例的并行、内存和接触收敛策略仍需后续版本完善。
## 14. 0.5.3 Diagnostic Output Notes
0.5.3 focuses on explainability. When nonlinear or contact runs fail, users
should inspect:
- nonlinear reason id/name and residual breakdown fields;
- `continuation_path.csv` residual columns:
`residual_total`, `residual_force`, `residual_contact`,
`residual_constraint`, `residual_arc`, `material_failure_count`;
- contact output fields for state counts, penetration/gap norms,
failed projections, active-set flips, slip/friction residuals, multiplier
residuals and augmentation diagnostics.
These fields are meant to separate geometry/search, normal contact, friction,
constraint, linear-solver and material-local causes. They are not a guarantee
that every large industrial AL/mortar contact path will converge in 0.5.3.
+15
View File
@@ -577,3 +577,18 @@ V4.8 起,`examples_layout` CTest 会检查 `examples/` 一级目录:有文
- 大规模接触收敛控制。
- 更多壳塑性和隐式动力长跑基准。
- 大规模性能、并行和内部稀疏求解器/预条件器强化。
## 19. 0.5.3 Developer Notes
When adding or changing diagnostic fields after 0.5.3:
- Add the storage field, public query or output column together with a module
test, checker or report audit that consumes it.
- Keep old CSV columns stable unless a versioned format change is explicitly
documented.
- Keep restart readers backward compatible; optional diagnostic blocks should
be skipped safely by older scenarios where possible.
- Treat mortar/friction tangent helpers as audit tools until the production
AL/mortar consistent tangent rewrite is explicitly scheduled.
- Do not mark compact contact benchmarks as proof of complete industrial
contact coverage.
+532
View File
@@ -0,0 +1,532 @@
我建议接下来**不要优先继续横向加功能**,而是把 FemLite 0.5.2 已有算法链条做“纵向闭环”:让非线性、接触、壳/屈曲、材料、restart、诊断在同一套算法规则下稳定运行。按投入产出比,优先级如下。
## 总体优先级
| 优先级 | 建议完善方向 | 为什么优先 |
| ------ | ------------------------------ | ----------------------------------------------------------------- |
| **P0** | 非线性求解状态机与一致诊断框架 | 这是 Riks、接触、材料塑性、Newmark-Newton、cutback 的共同地基 |
| **P1** | 接触一致切线、AL/mortar 长路径、摩擦状态算法 | 接触是最容易导致非线性求解不收敛、路径不稳定、restart 不一致的部分 |
| **P2** | 壳/实体几何刚度与预载屈曲链条 | 你已有 buckling 与 S4 finite-strain,下一步应补完整“预载 → 屈曲 → 后屈曲”算法链 |
| **P3** | Riks / continuation 泛化 | 现有 Riks 是有界路径,应扩展到更通用的 snap-through、snap-back、接触/塑性耦合路径 |
| **P4** | 材料积分一致切线与有限变形塑性 | MC、J2、壳 section plasticity 已有基础,下一步应提升为更可靠的工程本构算法库 |
| **P5** | Cohesive contact 主流程 | 你已有 cohesive 单点/compact benchmark,但还未进入通用 FE cohesive contact 主流程 |
| **P6** | 非零 harmonic cyclic symmetry | 现在 WAVE=0 已有,后续应补 harmonic wave、自动配对、结果展开 |
| **P7** | DEM/FEM 耦合的守恒性、subcycling 与规模化 | 颗粒路径已有 smoke/benchmark,下一步应先补算法守恒与稳定性,再谈大规模长跑 |
| **P8** | 线性求解器的非线性耦合适配 | 现有 Krylov/ILU0 足够支撑小中规模,但接触/约束/arc-length 会带来更复杂矩阵结构 |
---
## 1. 第一优先:统一非线性求解状态机
FemLite 现在已经有非线性静力、Newmark-Newton、cutback、线搜索、trust-region damped Newton、Riks、接触 trial/commit/rollback、材料状态更新、restart 等机制。下一步最重要的是把这些机制统一成一个清晰的算法状态机。
建议建立统一的层次:
```text
Step
└── Increment / Load step
└── Nonlinear iteration
├── trial state
├── residual assembly
├── tangent assembly
├── linear solve
├── line search / damping / trust region
├── accept / reject
└── commit / rollback
```
需要补的算法点:
1. **统一 trial/commit/rollback 协议**
材料、接触、cohesive、颗粒耦合、Newmark 状态、Riks 路径变量都应服从同一套 trial/commit/rollback 规则。否则 cutback、restart、OpenMP 并行路径很容易出现“不完全回滚”。
2. **统一残差分解**
残差不应只有全局力残差,还应分解为:
* 结构力残差;
* 接触 gap residual;
* 摩擦 slip residual;
* 约束/MPC residual;
* arc-length residual;
* Newmark 动力平衡 residual;
* 材料局部 return-mapping failure 统计。
3. **统一收敛准则**
建议至少支持:
* 力范数;
* 位移增量范数;
* 能量范数;
* 接触 gap/slip 容差;
* arc-length 约束容差;
* 材料点局部收敛容差。
4. **统一 cutback 决策表**
每次 cutback 应明确原因,例如:
* 线性求解失败;
* Newton 震荡;
* 接触 active set 反复切换;
* 材料点 return mapping 失败;
* Riks path predictor 错误;
* tangent 非正定或 pivot fallback;
* 位移增量过大;
* 接触穿透过大。
5. **统一 tangent audit**
现有 MC、mortar tangent 已经有有限差分审计。建议扩展成全局机制:
* element tangent audit;
* material tangent audit;
* contact tangent audit;
* cohesive tangent audit;
* Newmark effective tangent audit;
* Riks augmented tangent audit;
* shell finite-strain tangent audit。
这一项看似不是“新功能”,但它会显著提高后续所有高级算法的可靠性。
---
## 2. 第二优先:接触算法从 benchmark path 推进到长路径可信
你现在接触能力已经很广:面-面、analytical plane、mortar 权重、Coulomb/正则化摩擦、AL、multiplier restart、tangent audit、shell-shell、shell-solid、大滑移摩擦、OpenMP smoke。下一步应该把重点放在**一致线性化与长路径鲁棒性**。
建议完善:
### 2.1 完整 AL / mortar 一致切线
重点补:
* normal gap 对位移的几何导数;
* tangential slip 对位移的导数;
* 法向接触力与切向摩擦力耦合项;
* mortar 权重随大滑移投影变化的导数;
* 接触面法向变化导数;
* stick/slip 分支切换处的半光滑 Newton 或正则化切线;
* penalty/AL 参数自适应;
* active set 切换的滞回或稳定策略。
近期 mortar 接触文献中,AL 与 semi-smooth Newton 都是常用约束执行路线;相关工作也指出,纯 penalty 方法会带来约束满足不可直接控制和矩阵病态等问题,这正好对应 FemLite 后续应避免的问题。
### 2.2 接触状态机标准化
建议把接触状态显式分成:
```text
open
closed-stick
closed-slip
closed-restick
separating
failed-projection
```
并对每个状态定义:
* trial 更新;
* residual 贡献;
* tangent 贡献;
* 是否允许 line search;
* 是否触发 cutback;
* restart 写读字段;
* CSV 诊断字段。
### 2.3 接触 benchmark 应从“能跑”变成“能解释”
建议增加这些验收指标:
* 接触功是否非负或符合摩擦耗散;
* gap 最大值、均值、L2 范数;
* slip residual;
* active set 翻转次数;
* 每步 AL augmentation 次数;
* penalty 参数与穿透误差关系;
* tangent audit 相对误差;
* restart 前后接触力一致性;
* OpenMP 不同线程数结果差异。
**建议验收目标**:不是追求所有复杂接触都一步收敛,而是每次不收敛都能从日志中看出是 active set、投影、摩擦切线、线性求解还是材料状态导致。
---
## 3. 第三优先:补完整壳/实体几何刚度与预载屈曲链
你现在已经有:
* Euler column;
* dense generalized eigen solver;
* generic `*BUCKLING`;
* line geometric stiffness;
* 静力预载后 line `K_G`;
* C3D4/C3D8 initial-stress `K_G`;
* S4 finite-strain bounded postbuckling;
* spherical cap benchmark。
这说明 FemLite 已经有屈曲和后屈曲的骨架。下一步最应该补的是:
### 3.1 完整 shell preload-to-buckling `K_G`
这是当前缺口里最值得优先补的一个。
建议覆盖:
* 壳膜内力贡献的几何刚度;
* 弯曲应力/曲率相关几何刚度;
* transverse shear 相关项;
* director/rotation 自由度相关项;
* drilling 或伪 drilling 稳定项与 `K_G` 的关系;
* finite rotation 下的 stress stiffness;
* 多层壳 section 应力合成到几何刚度;
* 壳预载静力场到 buckling perturbation step 的状态传递。
线性特征值屈曲通常用于估计临界屈曲载荷,而后屈曲/不稳定路径则需要 Riks 或其他非线性路径跟踪方法;这正好对应 FemLite 现在应补齐的“预载屈曲 → 后屈曲 continuation”链条。([文档中心][1])
### 3.2 高阶实体几何刚度
建议补:
* C3D10 initial-stress `K_G`;
* C3D20 initial-stress `K_G`;
* reduced/full integration 下的几何刚度一致性;
* 曲边高阶几何映射对 `K_G` 的影响;
* 刚体模态污染检查。
### 3.3 屈曲结果进入后屈曲
建议实现:
```text
static preload
→ eigen buckling
→ select mode
→ imperfection injection
→ nonlinear static / Riks postbuckling
→ load-displacement path output
```
这样球冠、圆柱壳、拱、波纹壳、循环对称扇区都能用同一条算法链验证。
---
## 4. 第四优先:Riks / arc-length 从有界路径扩展为通用 continuation 框架
现在已有载荷型 Riks / arc-length continuation 和直接位移控制 path 记录。下一步建议不要只做“更多 case 能跑”,而是抽象成统一 continuation 框架。
建议补:
1. **混合控制变量**
* load control;
* displacement control;
* arc-length control;
* selected DOF control;
* generalized work control。
2. **自动弧长调整**
* 根据 Newton 迭代次数增减弧长;
* 根据 cutback 原因缩短弧长;
* 过极限点后允许载荷因子反向;
* 支持 snap-through 与 snap-back。
3. **分支检测**
* tangent singularity 指标;
* smallest pivot/eigen estimate;
* path turning point detection;
* branch switch 诊断,不一定第一步就自动切换,但要先能识别。
4. **与接触/塑性兼容**
Riks 最难的不是光滑弹性拱,而是:
* 接触 active set 变化;
* 摩擦 stick/slip 切换;
* 材料屈服面切换;
* cohesive damage softening;
* 壳后屈曲大转动。
Riks 类 arc-length 方法常用于不稳定、几何非线性塌曲或后屈曲问题,这类问题也正是 FemLite 当前 spherical cap、two arches、shell contact 等 benchmark 的自然延伸。([ABAQUS Documentation][2])
---
## 5. 第五优先:材料算法从“已有 return mapping”推进到“可组合材料内核”
材料方面,你已经有线弹性、J2、J2_JC、壳 section plasticity、Mohr-Coulomb active set、张拉截断、FD tangent audit、strength reduction。下一步建议把重点放在**一致切线、有限变形、软化正则化、壳/实体共用材料点框架**。
### 5.1 Mohr-Coulomb
建议优先完善:
* non-associated flow;
* dilation angle;
* apex/edge/corner return 的更清晰分支;
* shear/tension/mixed 分支之间的稳定切换;
* consistent elastoplastic tangent;
* softening/hardening 参数;
* 强度折减下的局部化诊断;
* 黏聚力、摩擦角、张拉强度折减的一致处理;
* plane strain / plane stress / shell section 的统一接口。
### 5.2 J2 / J2_JC
建议补:
* finite-strain J2;
* multiplicative 或 corotational finite-strain plasticity 路径;
* consistent tangent;
* 温度/应变率状态变量清晰化;
* Johnson-Cook damage 暂可后置,但状态变量框架应先留好;
* cyclic loading 下的 path/restart audit。
### 5.3 壳 section plasticity
当前是“代表性 section plasticity”,下一步建议推进到:
* layer-wise section integration;
* 每层独立材料状态;
* section stress resultant 与 material point stress 的双向输出;
* 壳厚方向塑性扩展;
* 与 ABD/H 弹性 section 的统一接口。
---
## 6. 第六优先:Cohesive 从 compact benchmark 进入通用主流程
你已经有 cohesive law、mixed-mode damage、unloading/reload、complete decohesion、非负耗散、restart 状态保持,以及 ball adhesion/decohesion benchmark。下一步要补的是**与 FE 接触/界面主流程的整合**。
建议路线:
1. **先做 cohesive interface element**
* 零厚度 interface element;
* 法向/切向开裂位移;
* mixed-mode 能量准则;
* consistent tangent;
* damage irreversibility;
* unloading/reload;
* complete failure 后刚度退化。
2. **再做 cohesive contact**
* 初始粘结;
* 损伤后压缩 re-contact;
* 失效后摩擦;
* cohesive 与 Coulomb 摩擦状态切换;
* 接触 active set 与 damage state 统一管理。
3. **最后再做通用 surface-based cohesive**
这一步复杂度最高,建议放在 interface element 稳定之后。
建议 benchmark:
* 单积分点 traction-separation;
* DCB;
* ENF;
* mixed-mode bending;
* 压缩闭合再接触;
* 剪切失效后摩擦滑移;
* restart 中途损伤状态恢复。
---
## 7. 第七优先:循环对称从 WAVE=0 扩展到非零 harmonic wave
现在已有 WAVE=0、显式 master/slave 对、solid 3-DOF、shell 6-DOF cyclic MPC、扇区旋转矩阵映射。下一步建议补:
1. **自动 cyclic 边界配对**
* 基于旋转轴;
* 角度容差;
* 半径/高度匹配;
* shell director 方向检查;
* pair quality CSV 输出。
2. **非零 harmonic wave**
有两种实现路线:
* complex DOF 形式;
* real-valued sine/cosine doubled system。
对 Fortran/C ABI 和现有 real-valued solver 来说,建议优先采用 **real block formulation**,即把一个 harmonic 的实部/虚部写成双实变量系统。
3. **cyclic buckling**
循环对称屈曲通常需要按 harmonic index 组织特征值结果,并可展开到完整 360° 模型;这说明 FemLite 后续应把 `wave_id`、buckling multiplier、mode expansion、modal CSV 统一设计。([Ansys Help][3])
4. **结果展开**
* sector result;
* full annulus result;
* selected harmonic result;
* phase angle result;
* VTK expanded output。
---
## 8. 第八优先:DEM/FEM 耦合先补守恒与时间步算法,不要急着做大规模长跑
颗粒部分现在已经有离散球状态、自由落体、墙碰撞、三颗粒堆、颗粒-facet、柔性容器映射。下一步建议先完善算法质量,而不是直接追求大规模 DEM。
建议补:
1. **时间步稳定性**
* DEM critical time step;
* FEM explicit time step;
* DEM/FEM subcycling;
* 接触刚度变化时的自动步长控制。
2. **守恒审计**
* 线动量;
* 角动量;
* 接触功;
* 摩擦耗散;
* 颗粒到 facet 节点力的合力/合矩一致性;
* 能量 drift。
3. **接触模型**
* normal spring-dashpot;
* tangential spring;
* frictional history;
* rolling resistance 可后置;
* restitution calibration。
4. **并行确定性**
* candidate pair ordering;
* force accumulation deterministic reduction;
* OpenMP 线程数一致性。
只有这些稳定之后,再做大规模颗粒长跑才有意义。
---
## 9. 第九优先:线性求解器要服务非线性,而不是单纯增加 solver 名字
目前已有 CG、BiCGSTAB、GMRES、dense pivoting fallback、CSR、Jacobi/Gauss-Seidel/ILU0。既然已经明确拒绝外部第三方 solver 后端,下一步算法重点应是**矩阵分类、缩放、块结构预条件**。
建议补:
1. **矩阵分类更细**
* SPD;
* symmetric indefinite;
* unsymmetric;
* saddle-point-like;
* contact augmented system;
* Riks augmented system;
* MPC constrained system。
2. **自动 solver 选择**
* SPD → CG;
* unsymmetric → GMRES / BiCGSTAB;
* 小规模病态 → dense pivoting fallback;
* 接触/arc-length → 优先 GMRES + scaling;
* buckling/eigen → dense generalized eigensolver 或后续 Lanczos。
3. **缩放与重排序**
* row/column scaling;
* diagonal equilibration;
* simple bandwidth reduction;
* contact rows scaling;
* constraint rows scaling。
4. **块预条件**
* displacement block;
* contact multiplier block;
* arc-length scalar block;
* MPC constraint block;
* shell rotational DOF scaling。
这部分不要急着做复杂 AMG。对 FemLite 当前阶段,更值得先把现有 Krylov 体系在非线性接触、Riks、MPC、buckling 这些场景下用稳。
---
## 10. 建议版本路线
### FemLite 0.6:算法地基版
重点目标:**非线性求解、状态管理、诊断统一化**。
建议交付:
* 统一 trial/commit/rollback;
* 统一 nonlinear residual breakdown;
* 统一 tangent audit 框架;
* restart-after-each-increment audit;
* cutback reason taxonomy;
* Newmark / static / Riks / contact 共享状态机;
* 接触 AL 参数与 gap/slip 诊断增强。
### FemLite 0.7:接触与几何刚度版
重点目标:**隐式接触长路径 + 预载屈曲可靠化**。
建议交付:
* mortar/AL consistent tangent 长路径;
* friction stick/slip tangent;
* shell-solid 接触稳定性增强;
* shell preload `K_G`;
* C3D10/C3D20 initial-stress `K_G`;
* buckling residual/modal audit 增强;
* prestress-to-buckling-to-postbuckling 工作流。
### FemLite 0.8:后屈曲、cohesive、cyclic 扩展版
重点目标:**工程非线性路径闭环**。
建议交付:
* mixed load/displacement arc-length;
* imperfection injection;
* branch/limit-point diagnostics;
* cohesive interface element;
* cohesive contact 初版;
* cyclic auto pairing;
* nonzero harmonic wave real-block formulation;
* cyclic buckling result expansion。
### FemLite 0.9:规模化与工程工艺版
重点目标:**把 compact benchmark 推向更长、更复杂路径**。
建议交付:
* roll forming 更完整工艺链;
* DEM/FEM subcycling;
* DEM 并行确定性;
* contact search scalability;
* large benchmark governance;
* solver scaling/reordering/block preconditioning;
* benchmark dashboard。
---
## 我认为最该先做的 5 个具体任务
1. **统一非线性状态机与 trial/commit/rollback**
这是最底层的稳定性工程,直接影响材料、接触、Riks、Newmark、restart。
2. **接触 AL/mortar/friction 一致切线长路径**
这是最能提升 FemLite 工程可信度的算法方向。
3. **完整 shell preload-to-buckling 几何刚度**
你已经有壳、屈曲、S4 finite-strain、球冠后屈曲;补这个会让整条壳稳定性链条成立。
4. **Riks 泛化为 mixed-control continuation**
让球冠、拱、接触失稳、cohesive softening、塑性软化都能走同一套 path-following 框架。
5. **材料一致切线与 layer-wise shell plasticity**
让 MC/J2/壳塑性不只是 benchmark 可跑,而是能稳定进入复杂非线性路径。
最不建议现在优先做的是:直接冲完整生产级 roll forming、大规模 DEM 长跑、更多单元类型、更多材料模型名字。FemLite 0.5.2 已经“广”,下一阶段应该先把核心非线性算法做“深”。
[1]: https://docs.software.vt.edu/abaqusv2024/English/?show=SIMACAEANLRefMap%2Fsimaanl-c-eigenbuckling.htm&utm_source=chatgpt.com "Eigenvalue Buckling Prediction"
[2]: https://abaqusdocs.eait.uq.edu.au/v6.11/books/usb/pt03ch06s02at03.html?utm_source=chatgpt.com "6.2.4 Unstable collapse and postbuckling analysis"
[3]: https://ansyshelp.ansys.com/public/Views/Secured/corp/v242/en/ans_cycsym/advcycbucklingans.html "4.5. Linear Buckling Cyclic Symmetry Analysis"
+279
View File
@@ -0,0 +1,279 @@
# FemLite 0.5.3 Development Plan
日期:2026-07-01
适用对象:FemLite 0.5.3 开发、评审、测试与阶段验收。
## 1. 版本定位
FemLite 0.5.3 定位为:
```text
接触与非线性诊断加固版
```
0.5.2 已经形成较宽的算法覆盖面:内部 Krylov 求解器、非线性静力/Newmark、
Riks/continuation 有界路径、Mohr-Coulomb、紧凑接触 benchmark、屈曲/循环对称
有界子集、finite-strain S4 有界路径、cohesive 单点/compact benchmark 和
颗粒-FEM 耦合 benchmark 均已有回归证据。
0.5.3 不再优先横向增加新功能名,而是把非线性、接触、restart、cutback、
线性求解失败和诊断输出做成更稳定的一套纵向闭环。核心目标是:
- 失败时能明确说明失败原因。
- 接触状态和残差能分解、记录、复现。
- restart/cutback 后 trial/commit/rollback 语义更可信。
- 接触 benchmark 从“能跑”推进到“能解释”。
## 2. 范围边界
### 2.1 0.5.3 应交付
- 统一 cutback / nonlinear failure reason 编码。
- 统一 nonlinear residual breakdown 的基础字段和输出。
- 接触状态机字段标准化。
- 接触 gap/slip/multiplier residual 诊断增强。
- contact restart-after-increment audit。
- mortar/friction tangent audit 增强。
- OpenMP 接触路径一致性增强。
- 线性求解器在非线性场景下的失败状态和矩阵分类诊断增强。
- 文档、测试、benchmark checker 同步更新。
### 2.2 0.5.3 不交付
以下内容保留为后续版本,不作为 0.5.3 阻塞项:
- 完整工业级 AL/mortar 一致切线重写。
- 完整 shell preload-to-buckling `K_G`。
- C3D10/C3D20 initial-stress `K_G`。
- 通用 mixed-control Riks/arc-length 框架。
- finite-strain J2、完整 layer-wise shell plasticity。
- cohesive contact 主流程。
- cyclic 自动配对和非零 harmonic wave。
- DEM/FEM subcycling、大规模 DEM 长跑。
- 完整 roll forming 生产工艺流。
## 3. 开发原则
- 优先做小闭环,不做跨多个主流程的大改造。
- 诊断字段必须有测试或 checker 消费,避免只写日志不验收。
- 新状态字段必须考虑 restart、cutback、trial/commit/rollback。
- 不把 compact benchmark 宣称成完整工业能力。
- 不为了 0.5.3 改写已有 V5.12 DEFERRED 决策。
## 4. 任务清单
### 4.1 NL-1:统一 cutback / failure reason taxonomy
目标:把非线性失败原因从零散状态码推进为可解释的分类。
建议新增或整理的原因类别:
- 线性求解失败。
- Newton 残差不降。
- correction norm 过大。
- line search 失败。
- trust-region reject。
- 接触 active set 震荡。
- 接触投影失败。
- 接触穿透过大。
- 摩擦 stick/slip 反复切换。
- 材料 return mapping 失败。
- Riks/arc constraint 失败。
- MPC/约束残差过大。
- step 最小步长耗尽。
验收:
- `solver_implicit` 覆盖至少 3 类 failure reason。
- `implicit_inp` 覆盖 INP 路径下 reason 字段保持稳定。
- CSV 或 summary 输出包含 reason id/name。
### 4.2 NL-2:nonlinear residual breakdown
目标:把单一 residual 扩展为可解释分量。
0.5.3 建议先覆盖:
- total residual norm。
- internal/external force residual。
- contact gap residual。
- contact slip residual。
- MPC/constraint residual。
- arc-length residual。
- material local failure count。
验收:
- 非线性静力和 Newmark-Newton 至少输出 total、constraint、contact 三类字段。
- spherical-cap / contact benchmark checker 能读取并验证字段存在。
- 字段缺失时 checker 应失败。
### 4.3 CT-1:接触状态机字段标准化
目标:为接触点或接触贡献建立稳定状态名称。
建议状态:
```text
open
closed-stick
closed-slip
closed-restick
separating
failed-projection
```
0.5.3 不要求完整状态机重写,但应做到:
- 当前接触历史能映射到上述状态或其稳定子集。
- CSV/report 输出每类状态计数。
- restart 后状态计数一致。
验收:
- `restart` 覆盖 active/open、stick/slip、released/separating 的读写一致性。
- contact benchmark summary 输出状态计数。
### 4.4 CT-2:gap / slip / multiplier residual 诊断增强
目标:让接触不收敛时能看出是法向、切向还是乘子问题。
建议字段:
- max penetration。
- mean gap。
- gap L2 norm。
- slip increment norm。
- slip residual。
- normal multiplier residual。
- tangential/friction residual。
- active set flip count。
- failed projection count。
- AL augmentation count。
验收:
- `contact_mortar_report` 或相关测试覆盖新增字段。
- `example_contact_two_blocks_compression_benchmark` 和
`example_contact_block_sliding_benchmark` 的 checker 至少消费部分字段。
### 4.5 CT-3:mortar/friction tangent audit 增强
目标:继续使用有限差分审计,而不是直接大规模重写一致切线。
建议增强:
- normal-only tangent audit。
- friction stick tangent audit。
- friction slip tangent audit。
- rigid translation residual。
- row/column balance。
- energy probe。
- relative FD error summary。
验收:
- `contact_mortar_tangent` 覆盖 normal/stick/slip 三类审计。
- 输出可区分 tangent error、rigid residual、energy residual。
### 4.6 CT-4:OpenMP 接触路径一致性增强
目标:继续确保并行路径不改变接触统计和力学结果。
建议覆盖:
- force path。
- tangent path。
- candidate cache path。
- 多 step active set path。
- 1/2/4 线程统计一致性。
验收:
- `perf_contact_pair_omp_consistency` 从 1/4 线程扩展到 1/2/4 或保留
1/4 但增加状态计数字段。
- checker 比较非计时统计、接触力、active set、gap/slip 诊断。
### 4.7 LS-1:线性求解器非线性场景诊断
目标:线性求解器服务非线性,而不是增加 solver 名字。
建议增强:
- 矩阵分类:SPD、symmetric indefinite、unsymmetric、constraint-like、
contact-augmented、Riks-augmented。
- solver selected reason。
- fallback reason。
- preconditioner breakdown reason。
- final relative residual 和 nonlinear reason 关联。
验收:
- `linear_solver_cg` 覆盖失败状态和分类字段。
- `solver_implicit` 能把线性失败映射到 nonlinear failure reason。
### 4.8 DOC-1:文档与 benchmark 矩阵同步
需要同步更新:
- `docs/v5_development_plan.md`
- `docs/v5_benchmark_matrix.md`
- `docs/v5_acceptance_report.md`
- `docs/04_mathematical_model_and_algorithms.md`
- `docs/05_interface_control_document.md`
- `docs/06_test_and_verification_plan.md`
- `docs/07_user_manual.md`
- `docs/08_developer_manual.md`
- 相关 examples README 和 checker 输出说明。
## 5. 建议执行顺序
1. NL-1:先统一 reason taxonomy,建立最小公共字段。
2. LS-1:把线性失败映射到 nonlinear failure reason。
3. CT-1:接触状态计数字段标准化。
4. CT-2:gap/slip/multiplier residual 诊断增强。
5. CT-3:mortar/friction tangent audit 增强。
6. CT-4:OpenMP 接触路径一致性增强。
7. NL-2:补 residual breakdown 到主输出和 checker。
8. DOC-1:最后统一文档、矩阵和验收报告。
## 6. 0.5.3 验收建议
最小验收命令建议:
```powershell
cmake --build build-codex-gcc --parallel
ctest --test-dir build-codex-gcc -R "^(solver_implicit|implicit_inp|linear_solver_cg|restart|contact_mortar_report|contact_mortar_tangent|contact_multiplier_report|perf_contact_pair_omp_consistency)$" --output-on-failure
ctest --test-dir build-codex-gcc -R "^(example_contact_two_blocks_compression_benchmark|example_contact_block_sliding_benchmark|example_shell_shell_contact_benchmark|example_shell_solid_contact_benchmark)$" --output-on-failure
ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure
```
通过标准:
- 0.5.2 的 V5 acceptance 子集不回退。
- 新增 nonlinear/contact 诊断字段由测试或 checker 校验。
- 接触 restart 和 OpenMP 路径统计一致。
- 失败案例能输出明确 reason,而不是只给通用 solver error。
- 文档明确说明 0.5.3 仍不宣称完整工业级 AL/mortar 一致切线。
## 7. 风险与控制
| 风险 | 控制 |
|---|---|
| 诊断字段膨胀但无人消费 | 每个新增字段必须有测试或 checker |
| 接触状态机改动过大导致主流程不稳 | 0.5.3 只做状态映射和诊断,不重写完整接触求解器 |
| 与 Riks/cohesive/DEM 混线 | 这些能力只消费公共诊断接口,不作为 0.5.3 主开发目标 |
| benchmark 指标频繁变动 | 新增字段优先检查存在性、单调性、非负性和一致性,避免过早锁死复杂数值 |
| 文档口径再次扩大 | 明确保留 DEFERRED 边界,不把完整工业能力写成 PASS |
## 8. 推荐结论
0.5.3 应优先完成:
```text
非线性失败原因可解释 + 接触状态/残差可诊断 + restart/OpenMP 路径可复现
```
这会直接提高后续 0.5.4+ 的壳预载屈曲、Riks 泛化、cohesive 主流程、
材料一致切线和 DEM/FEM 长路径开发成功率。
+12 -8
View File
@@ -99,6 +99,8 @@ ctest --test-dir build-win-ifx-v5-20-2 -C Release -L v5_acceptance --output-on-f
ctest --test-dir build-win-gcc-16 -C Release -R "contact_omp1|contact_omp4|perf_contact_pair_omp_consistency" --output-on-failure -V
ctest --test-dir build-win-gcc-16 -C Release -R "^(contact_mortar_tangent|restart|contact_multiplier_diag|contact_multiplier_report|contact_omp1|contact_omp4|perf_contact_pair_omp_consistency)$" --output-on-failure
cmake --build build-codex-gcc --parallel
ctest --test-dir build-codex-gcc -R "^(solver_implicit|implicit_inp|linear_solver_cg|restart|contact_mortar_report|contact_mortar_tangent|contact_multiplier_report|perf_contact_pair_omp_consistency)$" --output-on-failure
ctest --test-dir build-codex-gcc -R "^(example_contact_two_blocks_compression_benchmark|example_contact_block_sliding_benchmark|example_shell_shell_contact_benchmark|example_shell_solid_contact_benchmark)$" --output-on-failure
ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure
ctest --test-dir build-codex-gcc -R "^example_spherical_cap_point_load_benchmark$" --output-on-failure
$env:FEMLITE_SPHERICAL_CAP_NONLINEAR='1'
@@ -120,8 +122,10 @@ python examples\spherical_cap_with_central_point_load\check_spherical_cap_result
| `ctest --test-dir build-win-ifx-v5-20-2 -C Release -L v5_acceptance --output-on-failure` | 35/35 passed |
| `ctest --test-dir build-win-gcc-16 -C Release -R "contact_omp1|contact_omp4|perf_contact_pair_omp_consistency" --output-on-failure -V` | 3/3 passed |
| 0.5.1 V5.3 定向接触审计与 OpenMP smoke | 7/7 passed |
| `cmake --build build-codex-gcc --parallel` | passed; all missing V5 acceptance executables generated |
| `ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure` | 36/36 passed |
| `cmake --build build-codex-gcc --parallel` | passed for 0.5.3 |
| 0.5.3 targeted nonlinear/contact diagnostic regression on `build-codex-gcc` | 8/8 passed |
| 0.5.3 contact benchmark diagnostic checker subset on `build-codex-gcc` | 4/4 passed |
| `ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure` | 39/39 passed |
| `ctest --test-dir build-codex-gcc -R "^example_spherical_cap_point_load_benchmark$" --output-on-failure` | 1/1 passed |
| V5.11 bounded spherical-cap nonlinear checker, `FEMLITE_SPHERICAL_CAP_NONLINEAR=1` | passed; 54 accepted increments |
@@ -158,14 +162,14 @@ python examples\spherical_cap_with_central_point_load\check_spherical_cap_result
| 领域 | 原因 | 风险 | 用户影响 |
|---|---|---|---|
| 完整 mortar / AL 一致切线 | 当前已有 multiplier、mortar、friction、多示例 benchmark、0.5.1 multiplier restart audit 和 tangent matrix audit;0.5.2 追加摩擦历史 stick/slip restart 审计、BiCGSTAB/GMRES 失败状态诊断和 64 面片 4 步 OpenMP force/tangent/cache 路径一致性;完整工业级一致切线和真实非线性长路径仍移入后续版本 | 大规模非线性接触可能需要更强收敛控制 | 当前可运行紧凑接触 benchmark、接触审计回归和路径级并行一致性;不能宣称覆盖所有工业接触场景 |
| 完整 mortar / AL 一致切线 | 当前已有 multiplier、mortar、friction、多示例 benchmark;0.5.3 已补 nonlinear failure reason、residual breakdown、contact state/gap/slip/friction/multiplier/augmentation diagnostics、restart v4 diagnostic round-trip、normal/stick/slip tangent audit split 和 1/2/4 线程 OpenMP deterministic path consistency;完整工业级一致切线和真实非线性长路径仍移入后续版本 | 大规模非线性接触可能需要更强收敛控制 | 当前可运行紧凑接触 benchmark、接触审计回归和路径级并行一致性;不能宣称覆盖所有工业接触场景 |
| Mohr-Coulomb 结构级自动 trial 重求解 | 材料点、活动集算法一致切线和 FOS 曲线 benchmark 已完成,完整结构非线性失稳判据和 PDF 位移/塑性云图仍需扩展 | 复杂边坡或三维岩土模型可能过早/过晚判稳 | 当前适合强度折减曲线验证,不等价于完整岩土生产求解器 |
| 通用 `*BUCKLING` step | 已有内部特征值和 benchmark 工具,主 `femlite` 输入流程尚未提供通用 buckling step | 用户需要通过 benchmark 工具验证屈曲,而非普通 INP 直接求解 | 小规模解析/紧凑循环 benchmark 可用,通用屈曲工况仍需后续版本 |
| 完整三维滚压长跑 | 当前是辊运动学和紧凑多层 J2 截面 springback benchmark | 真实工艺网格、restart 多 step 和长时间稳定性尚未验证 | 用户可验证核心算法路径,但不能直接替代工业 roll forming 工艺仿真 |
| 完整 FE cohesive 接触 step | 当前 cohesive law/state/metrics 和 ring benchmark 已完成,主接触流程切换与切线仍需集成 | 粘附/普通接触切换和 restart 长路径仍有风险 | 用户可使用 benchmark 验证 cohesive 模型,不应把它当作通用 FE cohesive 接触 |
| 颗粒大规模 longrun | 当前 V5.8 限定内置离散球和紧凑柔性容器 benchmark | 大颗粒数性能、邻域搜索和长时间能量稳定性仍需验证 | 用户可验证双向映射闭环,但不能把它当作工业 DEM 装填求解器 |
| 球冠完整 PDF 全曲线 | V5.11 验收收窄为 finite-strain S4 bounded postbuckling capability;完整 `uz=-6.2 m`、Shell-4/8/16 digitized reference matching、later restiffening 和 late GMRES 性能优化移入后续版本 | 严格参考曲线复现仍需更强 continuation 与性能工作 | 用户可使用 V5.11 验证 S4 finite-strain 生产路径和 post-peak load drop,不能把它声明为完整 NAFEMS/PDF 全曲线复现 |
| 后续 longrun 发布节奏 | 正式 `v0.5.0` 标签已指向包含 20.2 多平台复测和 20.4 文档治理的节点;`main` 后续提升到 `0.5.2` | 更大规模 longrun 和 V5.3-V5.7 主流程工程化仍需后续版本继续收束 | 不影响 `v0.5.0` 阶段验收结论;后续发布应明确新的 tag/commit |
| 后续 longrun 发布节奏 | 正式 `v0.5.0` 标签已指向包含 20.2 多平台复测和 20.4 文档治理的节点;`main` 后续提升到 `0.5.3` | 更大规模 longrun 和剩余 PARTIAL 能力仍需后续版本继续收束 | 不影响 `v0.5.0` 阶段验收结论;后续发布应明确新的 tag/commit |
## 暂缓或不纳入当前模块
@@ -177,10 +181,10 @@ python examples\spherical_cap_with_central_point_load\check_spherical_cap_result
## 结论
当前 V5 开发态已经将 V5.2 和 V5.8 收束到可验收闭环,并为 V5.3-V5.7
建立了真实算法路径、紧凑 benchmark 和可复现指标。`v5_acceptance` 标签提供
当前 V5 验收子集,默认 Release CTest 保持 106/106 passed,并已完成 WSL GNU
和 Windows Intel/MSVC 多平台复测。
当前 V5 开发态已经将 V5.2 和 V5.8 收束到可验收闭环,并完成 0.5.3
nonlinear/contact explainability hardening。`v5_acceptance` 标签提供当前 V5
验收子集,`build-codex-gcc` 当前记录为 39/39 passed;历史默认 Release CTest
保持 106/106 passed,并已完成 WSL GNU 和 Windows Intel/MSVC 多平台复测。
最终 0.5.x 发布仍需完成更大规模 longrun、最终标签决策和剩余 PARTIAL 能力的
工程化收束;不得把当前紧凑 benchmark 夸大为完整工业场景全覆盖。
+15 -9
View File
@@ -37,6 +37,12 @@ Current local V5 acceptance subset evidence on `build-codex-gcc`:
`ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure` passed
39/39.
Current local 0.5.3 diagnostic evidence on `build-codex-gcc`:
- `cmake --build build-codex-gcc --parallel` passed.
- `ctest --test-dir build-codex-gcc -R "^(solver_implicit|implicit_inp|linear_solver_cg|restart|contact_mortar_report|contact_mortar_tangent|contact_multiplier_report|perf_contact_pair_omp_consistency)$" --output-on-failure` passed 8/8.
- `ctest --test-dir build-codex-gcc -R "^(example_contact_two_blocks_compression_benchmark|example_contact_block_sliding_benchmark|example_shell_shell_contact_benchmark|example_shell_solid_contact_benchmark)$" --output-on-failure` passed 4/4.
## 测试层级
| 层级 | 用途 | 推荐命令 |
@@ -63,11 +69,11 @@ Current local V5 acceptance subset evidence on `build-codex-gcc`:
| V5 项 | 能力 | 目录或模块 | CTest 名称 | 参考指标 | 容差/验收条件 |
|---|---|---|---|---|---|
| V5.2 | 内部 solver 诊断、no-external-solver 策略 | `src/solver`, `tests/module`, `tests/interface` | `linear_solver_cg`, `csr_diagnostics`, `solver_implicit`, `implicit_inp`, `c_api`, CLI implicit/static tests | CG/BiCGSTAB/GMRES/dense pivoting、残差、CSR matrix class、legacy external id rejection、非线性修正 fallback | 旧外部 method/backend id 被拒绝且不改变设置;静力、隐式和非线性路径通过内部 solver dispatch;非线性修正可在内部求解器间 fallback 且恢复用户设置 |
| V5.3 | 非匹配实体 mortar 压缩 | `examples/contact_two_blocks_compression` | `example_contact_two_blocks_compression_benchmark` | `pressure_profile.csv`, active contact, master coverage, weighted gap, multiplier residual | 多 master facet 覆盖;weighted penetration 和 multiplier residual 在 checker 容差内;VTK 输出存在 |
| V5.3 | 大滑移 mortar-friction | `examples/contact_block_sliding` | `example_contact_block_sliding_benchmark` | `sliding_profile.csv`, stick/slip, accumulated slip, tangential force, friction work | 多 master/active candidate;累计滑移和摩擦功为正且非负耗散;VTK 输出存在 |
| V5.3 | shell-shell contact | `examples/shell_shell_contact` | `example_shell_shell_contact_benchmark` | contact profile, active contact, force norm, gap residual, augmented multiplier | active contact 大于零;gap/force/multiplier 指标通过 checker |
| V5.3 | shell-solid contact | `examples/shell_solid_contact` | `example_shell_solid_contact_benchmark` | contact profile, master search, shell-to-solid force transfer | active contact 大于零;master search 和 nodal force 指标通过 checker |
| V5.3 | 接触状态、restart 和并行路径连续性 | `tests/module`, `tests/performance` | `contact_mortar_al`, `contact_mortar_iter`, `contact_mortar_report`, `contact_mortar_tangent`, `contact_multiplier_report`, `restart`, `perf_contact_pair_omp_consistency` | AL multiplier, `contact_multiplier_audit`, `mortar_tan_audit_matrix`, tangent/report diagnostics, restart restored history, 64 面片 4 步 OpenMP path stats | 接触历史、摩擦累计量、stick/slip 状态计数和 multiplier 状态在 restart 后连续;0.5.1 覆盖 active/released/open multiplier 写读、duplicate/invalid 为零、commit/trial 差异为零,并检查 mortar tangent row/column balance、刚体平移残差、非对称量和能量 probe;OpenMP 1/4 线程下 force/tangent/cache 路径非计时统计一致 |
| V5.3 | 非匹配实体 mortar 压缩 | `examples/contact_two_blocks_compression` | `example_contact_two_blocks_compression_benchmark` | `pressure_profile.csv`, active contact, master coverage, weighted gap, multiplier residual, state/status, active-set flip, gap mean/L2, augmentation diagnostics | 多 master facet 覆盖;weighted penetration、gap norm、state count、active-set flip 和 multiplier/augmentation diagnostics 在 checker 容差内;VTK 输出存在 |
| V5.3 | 大滑移 mortar-friction | `examples/contact_block_sliding` | `example_contact_block_sliding_benchmark` | `sliding_profile.csv`, stick/slip, accumulated slip, tangential force, friction work, slip/friction residuals, gap L2, augmentation diagnostics | 多 master/active candidate;累计滑移和摩擦功为正且非负耗散;slip/friction/gap/augmentation diagnostics 存在且内部一致;VTK 输出存在 |
| V5.3 | shell-shell contact | `examples/shell_shell_contact` | `example_shell_shell_contact_benchmark` | contact profile, active contact, force norm, gap residual, augmented multiplier, state/status, active-set flip, failed projection count | active contact 大于零;gap/force/multiplier/state/flip/projection 指标通过 checker |
| V5.3 | shell-solid contact | `examples/shell_solid_contact` | `example_shell_solid_contact_benchmark` | contact profile, master search, shell-to-solid force transfer, state/status, active-set flip, gap L2, failed projection count, augmentation diagnostics | active contact 大于零;master search、nodal force 和 shared diagnostic 指标通过 checker |
| V5.3 | 接触状态、restart、非线性诊断和并行路径连续性 | `tests/module`, `tests/performance` | `contact_mortar_al`, `contact_mortar_iter`, `contact_mortar_report`, `contact_mortar_tangent`, `contact_multiplier_report`, `restart`, `solver_implicit`, `implicit_inp`, `linear_solver_cg`, `perf_contact_pair_omp_consistency` | failure reason taxonomy, residual breakdown API/path CSV, AL multiplier, tangent audit split, contact report diagnostics, restart v4 restored diagnostics, 64 面片 4 步 OpenMP path stats | nonlinear/contact failure reason 与 residual breakdown 被测试消费;contact state/gap/slip/friction/multiplier/augmentation diagnostics 在 report/checker 中消费;restart 后接触诊断连续;normal/stick/slip tangent audit 分开报告;OpenMP 1/2/4 线程下 force/tangent/cache/state/residual 路径非计时统计一致 |
| V5.4 | Mohr-Coulomb 材料点 | `tests/unit` | `material_mohr_coulomb`, `material_mc_driver`, `material_mc_envelope` | 三轴压缩/伸展、纯剪、张拉截断、branch id、plastic multiplier | yield margin、分支号、塑性增量和 envelope safety ratio 通过测试容差 |
| V5.4 | Mohr-Coulomb 屈服面算例 | `examples/mohr_coulomb_yield_surface` | `example_mc_yield_surface_benchmark` | `yield_surface.csv`, `yield_points.csv`, `yield_summary.csv`; 原始材料和 `F=2` 折减材料 | 压缩包络、伸展包络和张拉截断符合解析公式;强度折减降低承载力;elastic/shear/tension/mixed 分支全部被代表性应力点激活 |
| V5.4 | Mohr-Coulomb 边坡强度折减 benchmark | `examples/strengthReduction` | `example_strength_reduction_benchmark` | 8 个参考工况,最大 FOS 误差 `6.9392E-03`,86 trials,52 stable,34 unstable;`--nonlinear-chain` 可选输出真实 FE trial、cutback、accepted-time 和线性求解诊断;`--nl-write-cloud` 可选输出目标 FOS 云图 summary 与 VTK;0.75 m cloud route 支持内部 BiCGSTAB/ILU0、静力 predictor、自适应跳步和 accepted segment 后 VTK 刷新 | 0.75 m 网格和参考几何记录;输入使用原生实体 `DLOAD, GRAV`;上下土体界面必须为共享节点 conforming mesh;FOS 曲线在 0.02 容差内;FOS 随坡角单调降低;关联工况不弱于 Davis B 工况;plastic zone 和 displacement probe 激活;optional nonlinear chain 不伪造 VTK;optional partial/target cloud VTK 必须含 displacement/eqps 字段且网格计数匹配;0.75 m 临界失稳位移/eqps 云图属于后续 longrun/研究验证,不作为 V5 交付验收项 |
@@ -87,10 +93,10 @@ Current local V5 acceptance subset evidence on `build-codex-gcc`:
| 示例目录 | 主要输出 | checker |
|---|---|---|
| `examples/contact_two_blocks_compression` | `pressure_profile.csv`, VTK | `check_contact_results.py` |
| `examples/contact_block_sliding` | `sliding_profile.csv`, VTK | `check_contact_results.py` |
| `examples/shell_shell_contact` | shell contact profile, VTK | `check_contact_results.py` |
| `examples/shell_solid_contact` | shell-solid contact profile, VTK | `check_contact_results.py` |
| `examples/contact_two_blocks_compression` | `pressure_profile.csv`, VTK, 0.5.3 contact state/gap/augmentation diagnostics | `check_contact_results.py` |
| `examples/contact_block_sliding` | `sliding_profile.csv`, VTK, 0.5.3 slip/friction/gap/augmentation diagnostics | `check_contact_results.py` |
| `examples/shell_shell_contact` | shell contact profile, VTK, 0.5.3 shared contact diagnostics | `check_contact_results.py` |
| `examples/shell_solid_contact` | shell-solid contact profile, VTK, 0.5.3 shared contact diagnostics | `check_contact_results.py` |
| `examples/mohr_coulomb_yield_surface` | `yield_surface.csv`, `yield_points.csv`, `yield_summary.csv` | `check_mc_yield_surface_results.py` |
| `examples/strengthReduction` | `strength_reduction_path.csv`, `strength_reduction_cases.csv`, summary, `plastic_zone.csv`, `displacement_probe.csv`; optional `strength_reduction_nonlinear_chain.csv` and nonlinear summary when `--nonlinear-chain` is used; optional `strength_reduction_cloud_summary.csv`, progress/trace CSV and refreshed partial/target VTK when `--nl-write-cloud` is used | `check_strength_reduction_results.py` |
| `examples/euler_column_buckling` | `buckling_summary.csv`, `buckling_mode_1.csv` | `check_buckling_results.py` |
+8 -8
View File
@@ -126,8 +126,8 @@ FemLite 0.5.x 定位为:
- `0.5.0`:第五版开发起点,提升项目版本号,建立 V5 计划、首页 README 和 V4.8 验收基线说明。
- `0.5.1`:第五版架构冻结、V4 deferred 项登记和验收矩阵建立。
- `0.5.2`:内部稀疏求解器强化、no-external-solver 策略完成,并收束 `examples/two_arches` 对应参考文献的单个选定工况;V5 不引入 COMSOL 参数化扫描。
- `0.5.3`:V5 范围内的 mortar / augmented Lagrangian 接触补强完成;
完整工业级一致切线和真实非线性长路径收束移入后续版本。
- `0.5.3`:V5 范围内的 nonlinear/contact diagnostic hardening 完成;
完整工业级 AL/mortar 一致切线和真实非线性长路径收束移入后续版本。
- `0.5.4`:完整 Mohr-Coulomb 和强度折减完成。
- `0.5.5`:线性屈曲和循环对称完成。
- `0.5.6`:真实高保真滚压成形完成。
@@ -176,7 +176,7 @@ FemLite 0.5.x 定位为:
|---|---|---|---|
| V5.1 架构冻结与验收矩阵 | PARTIAL | 本计划、README 和 V1-V4 回归基线已建立。 | 最终验收矩阵、干净发布分支和 `docs/v5_acceptance_report.md`。 |
| V5.2 内部稀疏求解强化与 two arches 单点参考验证 | PASS | solver dispatch 记录 method、preconditioner、iteration、status、CSR matrix class、initial/final/relative residual;CG/BiCGSTAB/GMRES、内部 dense pivoting fallback、线性静力、隐式 Newmark、非线性接触修正、非线性修正 CG-to-GMRES fallback 和 C ABI 诊断回归通过;外部求解器接口、工具和构建目标已移除;`examples/two_arches` 已完成 PDF 几何、30/75 壳网格、接触激活、动态 blow-up 防护 checker 和 `para=0.02` 单个位移参考点 checker。 | 0.5.2 已补齐选定单点参考工况:`disp_upper=max_disp*para` 位移参考点、单点输出和参考指标 checker;不要求静力边载荷收敛或 COMSOL 参数化扫描。 |
| V5.3 mortar / AL 接触 | PARTIAL | 已有接触乘子、mortar AL 点/批量/约束/切线/迭代/报告模块和聚焦测试;非匹配实体压力、大滑移摩擦、shell-shell 和 shell-solid benchmark 已接入 CTest;0.5.1 新增 contact multiplier restart audit 和 mortar tangent matrix audit,并扩展 restart active/released/open 场景;OpenMP contact 性能一致性已升级为 64 面片、4 步 force/tangent/cache 路径。 | 完整工业级 AL 一致切线和更多真实非线性长路径仍需收束。 |
| V5.3 mortar / AL 接触诊断加固 | DIAGNOSTIC PASS / SOLVER REWRITE DEFERRED | 已有接触乘子、mortar AL 点/批量/约束/切线/迭代/报告模块和聚焦测试;非匹配实体压力、大滑移摩擦、shell-shell 和 shell-solid benchmark 已接入 CTest;0.5.3 新增 nonlinear failure reason taxonomy、residual breakdown API/path CSV、contact state/gap/slip/friction/multiplier/augmentation diagnostics、restart version 4 `CONTACT_PAIR_DIAGNOSTICS`、normal/stick/slip tangent audit split,以及 1/2/4 线程 OpenMP deterministic path consistency;四个 contact benchmark checker 已消费新增诊断字段。 | 0.5.3 交付可解释诊断与紧凑 benchmark 证据;完整工业级 AL/mortar 一致切线、完整接触状态机重写和更多真实非线性长路径仍移入后续版本。 |
| V5.4 Mohr-Coulomb 与强度折减 | FOS PASS / DIAGNOSTIC CLOUD DEFERRED | 已有 Mohr-Coulomb、包络、材料 driver、强度折减 driver/report 模块和测试;材料点验收覆盖三轴压缩、三轴伸展、纯剪、张拉截断、mixed return、分支号、塑性增量、强度折减残余下限,以及 shear/tension/mixed 活动集算法一致切线有限差分审计;`examples/strengthReduction` 已按 `models.geomech.strength_reduction_method.pdf` 的几何和参考工况升级为 0.75 m 网格 C3D8 Mohr-Coulomb 边坡强度折减 benchmark,覆盖 4 个坡角和 2 个材料工况,输出 path、case summary、plastic zone 和 displacement probe;0.5.2 新增 `--nonlinear-chain` 真实结构级 trial 路线和 `--nl-write-cloud` 目标 FOS 云图诊断路线,调用 `fem_solve_static_nonlinear` 输出真实收敛/失败诊断,并可生成 `strength_reduction_cloud_summary.csv` 与 `result_00001525.vtk`;实体 `DLOAD, GRAV` 已接入生产外载装配;非线性静力 step 已按增量时间缩放全局 `load_factor`,并新增 `static_ramp_load` 控制支持固定外载伪时间求解;strengthReduction 上下土体界面已修正为共享节点的 conforming mesh;NC-1 默认 `TWO_STAGE_LOAD_STRENGTH` 已接入 nonlinear chain 和 target cloud:阶段 A 在 `F=1.0` 收敛完整重力/外载,阶段 B 固定外载 continuation 强度折减因子;0.75 m cloud 路线还具备内部 BiCGSTAB/ILU0 预条件器、静力割线位移预测器、自适应 continuation 跳步和 accepted segment 后 VTK 刷新,旧路线实测可从 `accepted_time=0.003` 跳到 `0.053` 并推进到 `0.0905`;NC-5 已将 `METHOD=MC_SUBSTEPPING_SEMISMOOTH` 接入生产 Mohr-Coulomb 材料分发,支持 INP 可配置局部子步,在 `statev(27:32)` 写入聚合诊断,并已把 MC point/substep/branch/max-yield/max-plastic 汇总到 strengthReduction nonlinear chain/cloud/progress 输出,由 checker 校验。 | V5 交付不要求 0.75 m 临界失稳位移/eqps 云图完整复现;该问题计算量巨大且涉及边坡失稳临界现象,移入后续 longrun/研究验证。 |
| V5.5 屈曲与循环对称 | PARTIAL / BOUNDED V5 DELIVERY | 已有几何刚度、特征求解、模态输出、屈曲支持、循环对称模块/测试、Euler 柱专用 `femlite --buckling` 主程序路径、波纹壳紧凑循环屈曲 benchmark、普通 INP 小规模 dense generic `*BUCKLING` 子集和 WAVE=0 显式节点对 `*CYCLIC SYMMETRY` 主路径;相关 checker 已验证临界载荷、模态残差、`K_G` 归一化、循环边界残差和循环/全模型一致性;generic `*BUCKLING` 子集复用已装配线弹性 `K`,几何刚度支持显式 `*BUCKLING GEOMETRIC LINE`、`*BUCKLING GEOMETRIC LINE, PRELOAD` 的预载派生线刚度子集,以及 `*STATIC` 后直接 `*BUCKLING` 的 C3D4/C3D8 实体 initial-stress `K_G` 子集,summary/modal CSV 走普通输出目录工作流;主路径 cyclic 通过 MPC 罚约束覆盖实体 3-DOF 与壳 6-DOF 节点对。 | 完整预载后壳几何刚度、高阶实体几何刚度、完整壳 FE 波纹壳高保真模型、自动循环边界配对和非零 harmonic wave 主求解语义均延期到 post-V5。 |
| V5.6 高保真滚压成形 | PARTIAL / DEFERRED PRODUCTION WORKFLOW | 已有刚体圆柱/辊、运动调度、滚压指标、roller kinematics benchmark 和紧凑多层 J2 springback benchmark;示例输出 slip、traction、friction energy、pressure、torque、plastic work、plastic zone、residual displacement 和 springback ratio。 | 主求解器通用滚压成形 step、完整三维工件网格滚压、restart 驱动多 step 工艺流和更大规模长跑延期到 post-V5;当前 compact benchmark 只作为回归证据。 |
@@ -215,13 +215,13 @@ V5 benchmark 示例当前标记:
| 发布确认提交 | `9f577c0 Fix clean release verification inputs` |
| 发布确认标签 | `v0.5.0-v5-acceptance-checkpoint`,annotated tag,指向 `9f577c0` |
| 正式 0.5.0 标签 | `v0.5.0`,annotated tag,指向 `78dc4a6 Complete V5 documentation governance` |
| TODO 状态 | `todo.md` 中原 V5.2 至 V5.10 事项均已用 `[x]` 标记完成;0.5.2 新增 `examples/two_arches` 单点参考验证已用 `[x]` 标记完成 |
| TODO 状态 | `todo.md` 中原 V5.2 至 V5.10 事项均已用 `[x]` 标记完成;0.5.2 新增 `examples/two_arches` 单点参考验证已用 `[x]` 标记完成;0.5.3 nonlinear/contact diagnostic hardening 已完成 |
| 默认回归 | 本地原工作树和 clean clone 均记录为 `ctest --test-dir build-win-gcc-16 -C Release --output-on-failure` 106/106 passed |
| V5 验收子集 | 本地原工作树和 clean clone 均记录为 `ctest --test-dir build-win-gcc-16 -C Release -L v5_acceptance --output-on-failure` 35/35 passed |
| V5 验收子集 | 本地原工作树和 clean clone 均记录为 `ctest --test-dir build-win-gcc-16 -C Release -L v5_acceptance --output-on-failure` 35/35 passed;0.5.3 本地 `build-codex-gcc` 记录为 39/39 passed |
| WSL 多平台复测 | Ubuntu 24.04 / GNU Fortran 13.3.0 / GNU C 13.3.0 / CMake 3.28.3,`build-wsl-gfortran-v5-20-2` 默认 CTest 106/106 passed,`v5_acceptance` 35/35 passed |
| Windows Intel 多平台复测 | VS DevCmd 17.14.33 / MSVC 19.44.35227.0 / IntelLLVM ifx 2026.0.0,`build-win-ifx-v5-20-2` 默认 CTest 106/106 passed,`v5_acceptance` 35/35 passed |
| OpenMP smoke | `contact_omp1`、`contact_omp4` 和 `perf_contact_pair_omp_consistency` 通过;`perf_contact_pair.exe 64 1` 在 1/4 线程下非计时统计一致 |
| 发布卫生 | 根目录生成结果文件已清理;`v0.5.0` 正式标签已推送;`main` 后续开发版本提升至 `0.5.2` |
| OpenMP smoke | `contact_omp1`、`contact_omp4` 和 `perf_contact_pair_omp_consistency` 通过;0.5.3 `perf_contact_pair_omp_consistency` 覆盖 1/2/4 线程 deterministic force/tangent/cache/state/residual stats |
| 发布卫生 | 根目录生成结果文件已清理;`v0.5.0` 正式标签已推送;`main` 后续开发版本提升至 `0.5.3` |
| 验收文档 | 新增 `docs/v5_acceptance_report.md` 和 `docs/v5_benchmark_matrix.md` |
| solver 边界 | 第三方/外部求解器接口、工具和测试已移除;内部 CG/BiCGSTAB/GMRES 与 dense pivoting fallback 为当前生产 solver 路径 |
| 示例边界 | benchmark 编排工具位于 `tools/benchmarks`,示例输入和 checker 位于对应 `examples/<case>/` 目录,不进入 `src` |
@@ -1182,4 +1182,4 @@ OpenMP contact/performance smoke 记录:
| `docs/v5_development_plan.md` | 已登记 20.1 发布确认、20.2 多平台复测和 20.4 治理规则;V5.9/V5.10 仍保留 PARTIAL 以反映 longrun 和部分工程化边界 |
| `docs/v5_benchmark_matrix.md` | 已新增多平台复测矩阵和文档治理边界;Windows GCC、WSL GNU、Windows Intel/MSVC 和 OpenMP smoke 结果已登记 |
| `docs/v5_acceptance_report.md` | 已移除“多平台复测/release hygiene 未完成”的旧口径,保留 longrun、最终 tag 决策和剩余 PARTIAL 能力边界 |
| 后续建议 | `v0.5.0` 正式标签已包含 20.2 多平台复测和 20.4 文档治理;下一步在 `0.5.2` 上优先补更大规模 longrun 和 V5.3-V5.7 的工程化主流程集成 |
| 后续建议 | `v0.5.0` 正式标签已包含 20.2 多平台复测和 20.4 文档治理;0.5.3 收束 nonlinear/contact explainability 后,下一步优先补更大规模 longrun 和剩余 PARTIAL 能力的工程化主流程集成 |