Files
FemLite/docs/v4_development_plan.md
T
shenw 240d2728fa
FemLite CI / build-test (push) Has been cancelled
Complete V4.8 example acceptance and scripts
2026-06-25 10:29:03 +08:00

909 lines
52 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# FemLite 0.4.x 第四版开发计划
文档状态:第四版开发建议稿
日期:2026-06-24
适用对象:FemLite 0.4.1 至 0.4.x 开发、评审、测试与阶段验收
## 1. 文档目的
本文档定义 FemLite 第四版的开发定位、阶段划分、技术路线、验收准则和风险控制。
第四版以 0.3.3 第三版阶段验收基线为起点,在保持显式动力学、静力学、隐式 Newmark、壳单元、面-面接触和外部接口能力不回退的前提下,重点推进工程级非线性接触、隐式非线性求解稳定性、Abaqus surface/contact 输入子集、壳塑性验证和大规模性能能力。
## 2. 第四版定位
FemLite 0.4.x 定位为:
```text
工程级非线性接触 + 隐式非线性求解增强 + 壳塑性验证 + 大规模性能基础版
```
第四版不是追求完整 Abaqus 全关键字兼容,也不是一次性完成所有工业级通用有限元能力。第四版的核心是把 0.3.3 已具备的阶段能力继续工程化,尤其是:
- 将 surface/contact 输入从 element-target 子集扩展为更完整的工程常用子集。
- 将面-面 contact pair 从 penalty/mortar 权重阶段能力推进到更稳健的 mortar/augmented penalty 接触框架。
- 将 Coulomb 摩擦从接触对级历史推进到更完整的接触积分点历史与正则化模型。
- 将非线性 Newmark-Newton 从骨架和小算例回归推进到更可靠的工程非线性求解流程。
- 将壳塑性、钻转稳定、剪切锁定和壳接触纳入系统验证。
- 将大规模接触搜索、并行、外部稀疏求解器和性能测试纳入阶段验收。
第四版工程约束:
- 普通过程/函数尽量不超过 100 行,超过 128 行必须登记审查理由和后续拆分方向。
- 源文件尽量不超过 1500 行,超过 2000 行必须审查是否拆分。
- `source_size` CTest 继续作为本地回归检查项。
- 新增大型算例结果不得全量提交到 git,只提交小型参考结果、抽样结果和生成脚本。
- 所有新增能力必须同时更新需求、详细设计、数学算法、接口、测试和用户/开发者手册中的相关章节。
## 3. 开发基线
0.3.3 已具备:
- 显式瞬态动力学。
- 线性静力和非线性静力入口。
- 隐式 Newmark 线性动力学和非线性 Newmark-Newton 主流程。
- C3D4、C3D8、C3D10、C3D20 实体单元。
- S3、S4、S6、S8 壳单元基础动力、静力和输出能力。
- 各向同性线弹性、J2 弹塑性、Johnson-Cook 强化/损伤相关路径。
- 材料状态、单元删除状态的 trial/restore/commit 机制。
- 实体 J2 算法切线,以及壳 section J2/J2_JC 切线路径。
- Robin、MPC、刚性平面接触和面-面 contact pair 的非线性切线装配。
- 面-面 contact pair 的投影裁剪面积、多 master 面积分摊、mortar 形函数积分、Coulomb 粘滑历史、stick/slip/累计滑移输出、空间网格和可选 OpenMP BVH 候选搜索。
- Abaqus `*SURFACE, TYPE=ELEMENT` 输入子集、face label 筛选、壳 `SPOS`/`SNEG` 侧向语义和数据行式 `*CONTACT PAIR` 子集。
- CSV、VTK、restart、C ABI、Python 调试接口。
- Windows GCC、WSL gfortran 和 Windows Intel oneAPI ifx/MSVC 构建与 CTest 验证。
0.3.3 已知限制中进入第四版的内容:
- `*SURFACE` 当前仍为 element-target 子集,尚未支持完整 Abaqus surface 变体、node-based surface、analytic rigid surface 和复杂 surface 操作。
- 面-面 contact pair 已具备 mortar 权重、摩擦历史和 BVH 搜索,但仍不是完整工程级 mortar 约束求解器。
- 摩擦模型当前已具备 mortar 积分点级 Coulomb/正则化 Coulomb 粘滑历史、状态统计、摩擦功输出和 restart 保存。
- 大规模接触收敛控制、接触域分解和负载均衡仍需推进。
- 壳塑性一致切线仍需要更多弯曲/剪切塑性基准和长时间稳定性验证。
- 非线性 Newmark-Newton 仍需要更多工程基准、长时间稳定性验证和线性求解器鲁棒性增强。
## 4. 版本与分支策略
建议分支:
- `main`:保持已发布稳定版本。
- `dev/v0.4`:第四版主开发分支。
- `feature/v4-surface-input`:surface/contact 输入增强。
- `feature/v4-contact-mortar`:工程级 mortar/augmented penalty 接触。
- `feature/v4-friction`:摩擦正则化和接触历史变量。
- `feature/v4-implicit-robustness`:隐式非线性求解稳定性。
- `feature/v4-shell-plasticity`:壳塑性和壳基准。
- `feature/v4-performance`:大规模性能、并行和外部求解器。
版本号策略:
- `0.4.1`:V4.1 surface/contact 输入增强完成,包含 node-based surface、contact property 和 analytical rigid plane contact 子集。
- `0.4.2`:工程级 mortar/augmented penalty 接触框架增强。
- `0.4.3`:摩擦正则化、接触积分点历史和接触功输出增强。
- `0.4.4`:搜索与并行增强,包含 contact pair 搜索统计、BVH/候选缓存和并行装配优化。
- `0.4.5`:壳塑性基准、性能优化、多平台发布整理。
发布前必须更新:
- CMake 项目版本。
- Fortran 版本常量。
- `docs/v4_acceptance_report.md`。
- 用户手册和开发者手册。
- 接口、算法和测试文档。
## 5. 第四版阶段划分
| 阶段 | 名称 | 主要内容 | 完成标志 |
|---|---|---|---|
| V4.1 | Surface/contact 输入增强 | node-based surface、analytic rigid surface、contact property 子集 | 常用 Abaqus 接触输入可读取 |
| V4.2 | 工程级 mortar 接触 | active set、约束残差、一致切线、augmented penalty | 面-面接触收敛性显著提升 |
| V4.3 | 摩擦与接触输出 | 正则化 Coulomb、积分点历史、摩擦功和耗散输出 | 粘滑转换和能量输出可验证 |
| V4.4 | 搜索与并行 | BVH 动态更新、候选缓存、OpenMP 装配优化 | 大规模 contact pair 性能测试通过 |
| V4.5 | 隐式非线性鲁棒性 | 自适应步长、多准则收敛、求解失败诊断 | 非线性静力/动力长跑稳定 |
| V4.6 | 稀疏求解器接口 | 线性求解器抽象、预条件、外部库预留 | 可切换内部/外部求解路径 |
| V4.7 | 壳塑性与壳基准 | 弯曲/剪切塑性切线、锁定测试、壳接触基准 | 壳非线性基准矩阵通过 |
| V4.8 | 验证、性能和发布 | 大算例、文档、验收报告、多编译器回归 | 形成 0.4.x 阶段验收版 |
## 6. V4.1 Surface/Contact 输入增强
目标:
- 扩展 Abaqus inp 中 surface 和 contact 相关关键字的工程常用子集。
- 让典型接触算例的建模过程更接近 Abaqus 输入习惯。
建议实现内容:
1. 扩展 `*SURFACE`:
- `TYPE=ELEMENT` 的更多数据行变体。
- `TYPE=NODE` 或 node-based surface 子集。
- analytic rigid surface 子集。
- surface `GENERATE`。
- surface `OP=ADD`、`OP=NEW` 的完整回归。
- element set、node set、混合显式编号的数据行。
2. 扩展 shell surface 语义:
- `SPOS`、`SNEG`、双侧 shell surface 行为。
- 壳法向翻转、slave/master 侧向筛选。
3. 扩展 `*CONTACT PAIR`:
- header 式和数据行式输入。
- contact property 名称关联。
- 小滑移/有限滑移参数先 warning 或保留字段。
4. 增加接触属性输入:
- 法向 penalty。
- 法向阻尼。
- 摩擦系数。
- 摩擦正则化参数预留。
5. 明确 unsupported keyword 行为:
- 不影响模型完整性的参数 warning 后跳过。
- 关键 surface 或 contact pair 数据缺失时 error。
验收条件:
- node-based surface 小算例可读取并导出 facet 或节点目标。
- analytic rigid surface 小算例可读取并参与接触。
- element surface 的 face label、elset、显式编号、`OP=ADD/NEW` 回归通过。
- contact property 可正确绑定到 contact pair。
- 不支持参数的 warning 信息稳定、可读、可测试。
## 7. V4.2 工程级 Mortar 接触
目标:
- 将第三版 penalty/mortar 权重阶段能力推进到更稳健的工程接触求解框架。
建议实现内容:
1. 接触 active set:
- 激活、保持、释放三类状态。
- 接触开闭切换记录。
- 初始穿透处理策略。
2. 接触残差:
- 法向 gap 约束残差。
- mortar 约束积分残差。
- slave/master 双侧贡献。
3. 接触切线:
- gap 对节点位移的线性化。
- 法向变化项的近似或一致处理。
- mortar 权重对局部坐标的敏感性可先近似,需文档说明。
4. 求解策略:
- penalty 继续保留为默认稳健路径。
- augmented penalty 或 augmented Lagrangian 作为第四版主增强方向。
- Lagrange multiplier 路径可预留,不作为 0.4.0 必需项。
5. 接触稳定化:
- 法向 penalty 自动建议值。
- penalty 过大导致病态时的诊断。
- 穿透容限和接触力容限。
验收条件:
- 平块压入刚体平面静力接触可收敛。
- 两弹性块面-面压缩接触可收敛,压力分布合理。
- 壳-刚体接触可运行并输出接触功。
- active set 切换不会破坏 trial/rollback。
- 接触残差、接触力、最大穿透量和接触功随网格加密趋势合理。
## 8. V4.3 摩擦与接触输出
目标:
- 从接触对级摩擦历史推进到接触积分点级或 mortar 积分点级摩擦历史。
- 建立可验证的摩擦功、接触功和粘滑状态输出。
建议实现内容:
1. 摩擦历史变量:
- 接触积分点切向滑移。
- 切向牵引。
- stick/slip 状态。
- 累计滑移。
2. 摩擦模型:
- 无摩擦。
- Coulomb 摩擦。
- 正则化 Coulomb 摩擦。
- 粘滑转换返回映射。
3. 摩擦切线:
- stick 状态切向 penalty。
- slip 状态一致或近似切线。
- 正则化参数对切线的影响。
4. 输出:
- 法向接触功。
- 摩擦功。
- 累计耗散能。
- stick/slip 计数。
- 最大穿透和最大切向滑移。
- contact pair 分项统计。
验收条件:
- block sliding 摩擦算例可重现静摩擦到动摩擦转换趋势。
- 摩擦功非负耗散检查通过。
- 粘滑循环加载历史变量不丢失。
- contact CSV 字段稳定并在用户手册中说明。
## 9. V4.4 搜索、并行与大规模接触
目标:
- 提高接触搜索和接触装配在大规模模型中的效率与可诊断性。
建议实现内容:
1. BVH 增强:
- BVH 构建、重构和更新策略。
- facet AABB 扩张距离。
- 候选缓存与失效条件。
2. 空间网格增强:
- 网格尺寸自动估计。
- 高度非均匀模型的 fallback 策略。
3. OpenMP 并行:
- slave facet 并行搜索。
- contact pair 并行残差计算。
- 装配阶段减少临界区。
- 摩擦历史更新的线程安全。
4. 性能输出:
- facet 数。
- broad-phase 候选数。
- narrow-phase 激活数。
- 搜索时间。
- 接触力和切线装配时间。
验收条件:
- 大规模接触 P1 性能测试通过。
- 并行和串行路径结果在容限内一致。
- 接触搜索时间随 facet 数增长趋势合理。
- OpenMP 关闭时功能不回退。
## 10. V4.5 隐式非线性求解鲁棒性
目标:
- 让非线性静力和非线性 Newmark-Newton 可用于更复杂材料、接触和壳模型。
建议实现内容:
1. Newton 策略:
- full Newton。
- modified Newton。
- 自动切换或用户控制。
2. 收敛准则:
- 力残差绝对/相对准则。
- 位移增量准则。
- 能量范数准则。
- 接触穿透准则。
3. 步长控制:
- 自适应增量。
- cutback 后状态恢复。
- 最小步长退出。
- 最大 cutback 次数。
4. 线搜索:
- 残差型线搜索。
- 能量型线搜索预留。
5. 失败诊断:
- 线性求解失败。
- 接触 penalty 病态。
- 约束不足。
- 材料局部失效导致刚度退化。
验收条件:
- 非线性静力弹塑性加载卸载长跑稳定。
- 接触非线性静力压入可自动 cutback 并最终收敛。
- 非线性 Newmark 接触冲击小算例可完成指定时间。
- 失败日志能说明失败阶段、残差和建议检查项。
## 11. V4.6 稀疏求解器接口
目标:
- 建立内部/外部线性求解器可切换的架构,为大规模隐式求解做准备。
建议实现内容:
1. 线性求解器抽象层:
- CSR 矩阵输入。
- RHS 和解向量。
- 求解器参数。
- 迭代历史和失败码。
2. 内部求解器增强:
- CG 保留。
- BiCGSTAB 或 GMRES。
- Jacobi 预条件。
- 简单对角缩放。
3. 外部求解器预留:
- MUMPS。
- SuperLU。
- Intel MKL Pardiso。
- oneAPI/MKL 检测和 CMake 选项。
4. 跨平台策略:
- 默认不强依赖外部库。
- 外部库不可用时自动降级到内部求解器。
- Windows、WSL Linux、Intel Fortran 和 gfortran 路径都需可配置。
验收条件:
- 线性求解器接口单元测试通过。
- 内部 CG/BiCGSTAB 或 GMRES 可在相同 CSR 矩阵上切换。
- 外部求解器未启用时构建不受影响。
- 求解器残差和迭代数进入 convergence CSV 或日志。
## 12. V4.7 壳塑性与壳非线性基准
目标:
- 系统验证壳单元在塑性、弯曲、剪切、锁定和接触问题中的表现。
建议实现内容:
1. 壳塑性切线:
- 膜内塑性路径继续保留。
- 弯曲塑性一致切线增强。
- 横向剪切塑性切线增强。
- section 积分点状态 trial/rollback 检查。
2. 壳数值稳定:
- drilling DOF 稳定参数敏感性。
- 剪切锁定敏感性。
- 膜锁定敏感性。
- hourglass 控制策略复查。
3. 壳基准:
- Scordelis-Lo 网格收敛。
- pinched cylinder。
- hemispherical shell。
- twisted beam。
- clamped square plate pressure pulse 长跑。
4. 壳接触:
- 壳-刚体接触。
- 壳-壳接触。
- 壳 SPOS/SNEG 接触侧向回归。
验收条件:
- 壳弯曲和剪切塑性测试通过。
- 壳静力基准位移与参考解趋势一致。
- 壳显式压力脉冲长跑稳定。
- 壳接触算例接触状态和法向方向正确。
## 13. V4.8 验证、性能和发布
目标:
- 建立第四版验收矩阵,覆盖接触、隐式、壳、性能和多平台兼容性。
建议测试矩阵:
- 单元测试:
- surface 解析。
- contact property 解析。
- mortar 权重。
- 摩擦历史变量。
- active set 状态切换。
- BVH 候选搜索。
- 线性求解器接口。
- 模块测试:
- 接触残差和切线。
- 摩擦功和接触功。
- 非线性 cutback。
- 壳 section tangent。
- 示例 smoke:
- Hertz 或简化压入接触。
- block sliding。
- shell contact。
- nonlinear Newmark contact impact。
- P1 性能测试:
- 10000 节点、10000 单元、100 步保持回归。
- 新增中等规模接触搜索性能。
- P2 长跑:
- 大规模 contact pair。
- 非线性 Newmark 长时间稳定性。
- 壳压力脉冲长跑。
发布验收环境:
- Windows GCC。
- WSL Ubuntu gfortran。
- Windows Intel oneAPI ifx + MSVC。
- OpenMP 开启和关闭两种路径。
- 外部求解器开启路径如尚未具备,可记录为可选验证。
## 14. 接口影响
第四版接口扩展原则:
- 现有 Fortran95 接口保持向后兼容。
- C ABI 保持已公开函数签名稳定,新增函数只能追加。
- Python 调试接口跟随新增查询能力,但不作为高性能接口。
- 外部 SPH 耦合接口不依赖接触内部实现。
建议新增或增强接口:
- surface 数量、surface 类型和 surface facet 查询。
- contact pair 属性查询。
- 接触 summary 查询扩展:
- active set 数量。
- stick/slip 数量。
- 法向接触功。
- 摩擦功。
- 最大切向滑移。
- 搜索候选数量。
- 线性求解器统计查询:
- 求解器类型。
- 迭代次数。
- 最终残差。
- 失败码。
- 非线性求解统计查询:
- 当前增量。
- Newton 迭代次数。
- cutback 次数。
- 收敛状态。
## 15. 文档更新要求
第四版开发过程中必须同步更新:
- `docs/01_requirements_specification.md`:
- 增加第四版范围和非范围。
- `docs/02_software_architecture_design.md`:
- 增加接触、求解器和外部稀疏求解器架构。
- `docs/03_detailed_design.md`:
- 增加 surface/contact 数据结构、active set、摩擦历史和求解器接口。
- `docs/04_mathematical_model_and_algorithms.md`:
- 增加 mortar/augmented penalty、摩擦正则化、非线性收敛策略。
- `docs/05_interface_control_document.md`:
- 增加 surface/contact/solver 统计查询接口。
- `docs/06_test_and_verification_plan.md`:
- 增加第四版验收测试矩阵。
- `docs/07_user_manual.md`:
- 增加新输入、接触设置、求解器选项和输出说明。
- `docs/08_developer_manual.md`:
- 增加开发流程、模块边界和扩展指南。
- `docs/v4_acceptance_report.md`:
- 第四版验收时新增,不在开发初期提前伪造验收结论。
## 16. 风险与控制
主要风险:
- 工程级 mortar 接触范围过大,导致 0.4.0 无法阶段验收。
- 接触一致切线复杂,可能引入非线性收敛回退。
- 摩擦历史变量和 OpenMP 并行更新存在状态一致性风险。
- 外部稀疏求解器依赖跨平台配置复杂。
- 壳塑性与接触叠加后验证难度显著提高。
- 大规模性能优化可能与 Fortran95 非面向对象约束发生冲突。
控制策略:
- penalty 接触作为始终可用 fallback。
- augmented penalty 优先于完整 Lagrange multiplier 路径。
- mortar 权重、active set、摩擦历史、切线装配分阶段接入。
- 先用小型解析算例验证,再扩展到长跑和大规模算例。
- 外部求解器保持可选,不作为默认构建依赖。
- 所有接触状态修改必须进入 trial/rollback 流程。
- 性能优化不得破坏串行确定性回归。
## 17. 与后续版本的边界
第四版不强制完成:
- 完整 Abaqus 全关键字兼容。
- 完整 Abaqus 所有 contact formulation。
- 通用自接触最终版。
- 完整热-力耦合求解。
- 分布式 MPI 并行。
- 大规模工业模型的生产级 GUI 前后处理。
- 高阶复杂材料库。
- 完整商业求解器级别的接触鲁棒性。
这些内容可进入 0.5.0 或后续版本。
## 18. 第四版阶段验收准则
0.4.x 阶段验收建议满足:
- 0.1.0、0.2.0、0.3.3 已验收能力无回退。
- `*SURFACE` 和 `*CONTACT PAIR` 工程常用子集明显扩展,并有解析回归测试。
- node-based surface 或 analytic rigid surface 至少一类达到可用。
- 工程级 mortar/augmented penalty 接触小算例可稳定收敛。
- 摩擦正则化和接触积分点历史变量具备可验证输出。
- 接触功、摩擦功、stick/slip、最大穿透和接触搜索统计可输出。
- 非线性静力和非线性 Newmark 接触算例可完成长跑。
- 壳塑性弯曲/剪切基准和壳接触小算例通过。
- 至少一个中等规模接触性能测试通过。
- 内部线性求解器接口可切换,并输出迭代统计。
- Windows GCC、WSL gfortran、Windows Intel ifx/MSVC 构建和 CTest 通过。
- `source_size` 无 active hard-threshold exception,或每个例外均有审查理由和拆分计划。
- 用户手册、开发者手册、接口文档、算法文档、测试文档和验收报告同步更新。
## 19. 建议启动顺序
建议第四版先做 V4.1 和 V4.2:
1. 扩展 surface/contact 输入和数据结构。
2. 固化 contact pair property、active set 和状态变量。
3. 将现有 penalty/mortar 接触接入新的 active set 框架。
4. 增加小型接触收敛测试。
5. 再推进摩擦正则化、并行搜索和隐式求解鲁棒性。
这样可以先稳定数据结构和接口,再逐步替换接触算法内部实现,降低对已有显式、静力和隐式测试的冲击。
## 20. 当前阶段性简化实现清单与处置策略
代码中未发现独立命名为 mini 版或 demo 版的求解器模块,但存在若干第三版阶段验收所需的简化实现、fallback 路径和工程近似。第四版不应直接删除这些实现,而应先登记、测试保护,再按优先级替换或增强。
处置原则:
- 已通过验收、能稳定支撑示例和测试的简化实现保留为 fallback。
- 会影响第四版接触、隐式和壳非线性目标的简化实现,应列入 V4 主线增强。
- 仅用于调试或小规模验证的实现,应增加命名、文档和 warning,避免用户误认为工程级能力。
- 替换简化实现前,必须先补充等价回归测试,保证旧路径可对比、可回退。
当前简化实现与第四版处置建议:
| 类别 | 当前代码形态 | 是否删除 | 第四版处置 |
|---|---|---:|---|
| Surface 输入 | `*SURFACE` 当前只支持 `TYPE=ELEMENT` 子集,`OP=ADD/NEW` 和 face label 已支持基础语义 | 不删除 | V4.1 扩展 node-based surface、analytic rigid surface、更多数据行和 contact property 绑定 |
| 未支持 INP keyword | 未支持 keyword warning 跳过,关键数据缺失才 error | 不删除 | 保持兼容策略,但为 contact/surface 关键字建立更细的 warning/error 分级 |
| 刚性平面接触 | 节点到刚性平面的 penalty/damping 法向接触 | 保留 | 作为接触 fallback 和调试基准,补充 active set 输出和接触功一致性检查 |
| 面-面 contact pair | mortar 权重、投影裁剪、多 master 分摊、penalty 法向力和近似切线 | 不删除 | V4.2 升级为 active set + augmented penalty/mortar 残差和更一致切线 |
| 摩擦历史 | mortar 积分点级 Coulomb/正则化 Coulomb 粘滑历史,切向刚度按 `penalty * area` 估计 | 不删除 | V4.3 已完成阶段目标;V4.4/V4.5 可继续增强并行一致性和算法一致切线 |
| 接触并行 | BVH 搜索可 OpenMP 并行,但力/切线装配仍依赖 critical 保护 | 不删除 | V4.4 降低锁竞争,增加候选缓存、并行一致性测试和性能统计 |
| 壳 drilling 稳定 | 使用固定 `SHELL_DRILLING_STIFFNESS_FACTOR = 1.0e-4` | 不删除 | V4.7 参数化并增加敏感性测试,形成推荐范围和失稳诊断 |
| S3 剪切锁定处理 | 使用经验型 `shell3_shear_locking_scale` | 不删除 | V4.7 通过基准算例验证,必要时替换为更系统的 MITC/ANS 或改进减缩策略 |
| 壳局部几何 | 壳静力基于局部平面 basis,复杂曲壳几何仍是阶段能力 | 不删除 | V4.7 用 Scordelis-Lo、pinched cylinder、hemisphere 等曲壳基准约束误差 |
| 壳塑性切线 | section tangent 已接入膜、弯曲、剪切映射,但基准仍不足 | 不删除 | V4.7 补充弯曲/剪切塑性、卸载和长跑基准 |
| 质量矩阵 | 显式和隐式动力主要使用集中质量,壳转动惯量为对角近似 | 保留 | 显式继续默认集中质量;V4.5/V4.6 可预留一致质量或改进转动惯量选项 |
| 线性求解器 | 内部 CG + Jacobi 预条件为主 | 保留 | V4.6 增加求解器抽象、BiCGSTAB/GMRES、预条件和外部稀疏求解器预留 |
| MPC | MPC 当前采用 penalty 装配 | 保留 | 非 V4 主线;接触/隐式增强后再考虑 Lagrange multiplier 或更严格约束形式 |
| 材料大变形 | 当前为小应变 J2/J2_JC + Jaumann 客观率的 hypoelastic-plastic 路径 | 保留 | 第四版主要验证其在接触/隐式中的稳定性;完整 `F = Fe Fp` 可列入后续版本 |
| Restart | restart 保存已建模型上的 DOF、单元状态、高斯点状态和 V4.3 mortar 积分点摩擦历史,不保存完整 inp 模型数据库 | 保留 | 后续新增接触或求解器历史时,restart 必须同步保存新增历史变量 |
| 输出 | CSV/VTK 为工程调试级输出,单元量多为平均值 | 保留 | V4 增加 contact/solver 统计和关键积分点历史输出,避免提交大规模全场结果 |
第四版启动前建议先建立对应测试保护:
- 刚性平面 penalty 接触回归。
- 现有面-面 contact pair 回归。
- 摩擦 stick/slip 计数回归。
- S3/S4 壳静力和压力脉冲回归。
- CG+Jacobi 小型 CSR 求解回归。
- restart 写读现有状态回归。
第四版完成后,上表中仍保留的 fallback 应在用户手册中明确标注适用范围,避免与工程级新路径混淆。
## 21. 简化策略 0.4.x 实施计划列表
当前简化策略可以全部纳入 0.4.x 管理,但不应全部承诺为“最终完整实现”。第四版采用三类完成口径:
- A 类:0.4.x 内完成工程化替换或增强,旧实现保留为 fallback。
- B 类:0.4.x 内完成参数化、验证、文档和可诊断输出,暂不强制替换旧实现。
- C 类:0.4.x 内完成接口预留、风险隔离和回归保护,完整实现进入 0.5.0 或后续。
0.4.x 计划列表:
| 编号 | 简化策略 | 0.4.x 完成口径 | 阶段 |
|---|---|---|---|
| S1 | `*SURFACE, TYPE=ELEMENT` 子集 | A 类。扩展 node-based surface、analytic rigid surface、surface/contact property 常用子集;旧 element surface 保留兼容 | V4.1 |
| S2 | unsupported INP keyword warning 跳过 | B 类。建立 contact/surface 关键字 warning/error 分级表,关键数据缺失保持 error | V4.1 |
| S3 | 刚性平面 penalty 接触 | B 类。保留为 fallback,补充 active set 统计、接触功一致性、接触状态输出和回归测试 | V4.2, V4.3 |
| S4 | 面-面 penalty/mortar 近似接触 | A 类。升级为 active set + augmented penalty/mortar 残差 + 更一致切线;旧 penalty/mortar 路径保留为调试 fallback | V4.2 |
| S5 | contact-pair 级摩擦历史 | DONE。已推进到 mortar 积分点级历史,补充粘滑状态、正则化摩擦、摩擦功输出和 restart 保存 | V4.3 |
| S6 | BVH/OpenMP 装配依赖 critical | A 类。降低锁竞争,增加候选缓存、线程私有累加或分块装配,并建立串并行一致性测试 | V4.4 |
| S7 | 固定 drilling 稳定系数 | DONE。已改为可配置参数,增加默认推荐值、敏感性测试、稳定性统计、Fortran/C 查询接口和用户手册说明 | V4.7 |
| S8 | S3 剪切锁定经验缩放 | DONE。已参数化经验缩放和最小折减,补充诊断统计与 Scordelis-Lo smoke;MITC/ANS 仍作为后续精化方向 | V4.7 |
| S9 | 壳局部平面几何近似 | DONE/PARTIAL。Scordelis-Lo 曲壳 S3/S4 静力 smoke 已接入独立基准目录;完整 pinched cylinder/hemisphere/twisted beam 矩阵进入 V4.8 验收扩展 | V4.7 |
| S10 | 壳塑性 section tangent 基准不足 | DONE/PARTIAL。已补充 S4 J2 剪切塑性、代表性外纤维弯曲塑性、trial/rollback 和 tangent 对称性回归;完整厚度积分壳塑性和卸载长跑进入后续 | V4.7 |
| S11 | 集中质量和壳转动惯量对角近似 | B 类。显式继续默认集中质量;隐式路径增加一致质量或改进转动惯量选项的设计和小算例验证 | V4.5, 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 |
| S16 | CSV/VTK 调试级输出和单元平均量 | B 类。增加 contact/solver 统计、关键积分点历史抽样和输出体量控制;全量高性能后处理格式后续推进 | V4.3, V4.8 |
0.4.x 验收时,上述列表应逐项给出状态:
- `DONE`:按 A/B/C 类口径完成并有测试。
- `PARTIAL`:已有实现但未达到计划口径,需要说明缺口。
- `DEFERRED`:经评审确认推迟到 0.5.0 或后续,必须说明原因和风险。
任何 `DEFERRED` 项不得影响 0.1.0、0.2.0、0.3.3 已验收能力。
## 22. 0.4.1 开发记录
### V4.1 Surface/Contact 输入增强
完成状态:V4.1 阶段完成,可作为 FemLite 0.4.1 发布。
已完成:
- 新增 surface 类型字段,当前支持 `ELEMENT` 和 `NODE` 两类 surface。
- `*SURFACE` 的 `TYPE` 缺省仍为 `ELEMENT`,保持 0.3.3 输入兼容。
- `TYPE=NODE` 可读取节点号、节点集或 `ALL` 目标,并在数据库校验阶段检查节点/节点集是否存在。
- `TYPE=NODE` 数据行暂不允许 face label。
- 新增 `fem_get_surface_node_count` / `fem_get_surface_nodes`,外部驱动可按 surface 名称查询 node-based surface 的原始节点编号。
- contact pair 仍基于 facet 接触路径;若 contact pair 直接引用 node-based surface,数据库校验阶段报错,避免静默无效接触。
- facet 匹配函数仅对 `ELEMENT` surface 生效,避免把 node surface 的节点号误匹配为单元号。
- 新增 `*SURFACE INTERACTION` / `*CONTACT PROPERTY` 子集,支持法向 penalty、damping、search 和 `*FRICTION` 摩擦系数。
- `*CONTACT PAIR` 支持 `INTERACTION=` / `PROPERTY=` 名称绑定,pair 级显式参数优先,未显式给出的参数从 contact property 继承。
- 新增 `*SURFACE, TYPE=ANALYTICAL` 的刚性平面子集,数据行为 `PLANE, nx, ny, nz, offset`。
- 当 analytical surface 作为 contact pair master 时,接触力/切线接入已有刚性平面 penalty 路径;slave 当前支持 `ALL`、节点、节点集或 node-based surface。
- analytical contact pair 当前不处理摩擦,后续进入 V4.3 摩擦正则化/积分点历史统一处理。
- 数据库全局状态拆出到 `fem_database_state`,主数据库行为模块保持在源文件硬性尺寸限制内。
已补充测试:
- `tests/data/s4_node_surface.inp`:node-based surface 解析和数据库校验。
- `tests/data/s4_contact_property.inp`:contact property 解析、friction 读取和 contact pair 参数继承。
- `tests/data/s4_contact_pair_unknown_property.inp`:未知 `INTERACTION` 名称在模型构建阶段报错。
- `tests/data/s4_contact_analytical_plane.inp`:analytical rigid plane surface 解析、contact pair 绑定和模型构建。
- `implicit_inp`:检查 `surface_type`、node target、facet 匹配隔离、node surface 查询接口和 `fem_build_model`。
- `contact`:确认旧 element surface/contact pair 路径不回退,并验证 analytical plane contact pair 节点力。
- `source_size`:确认数据库状态拆分后源文件不超过硬性行数限制。
后续:
- 在节点-面接触或后续 contact pair 扩展中接入 node-based slave surface。
- 扩展 analytical surface 到更完整的 Abaqus segments/cylinder/sphere 子集。
## 23. 0.4.2 开发记录
### V4.2 Active Set 与 Augmented Penalty 起步
完成状态:V4.2 阶段完成,可作为 FemLite 0.4.2 候选基线;完整工程级 augmented Lagrangian/mortar 约束求解器仍进入后续 0.4.x。
已完成:
- contact pair 数据库新增增广 penalty 系数、法向增广乘子、显式设置标记、上一状态 active 数、当前状态、激活次数、释放次数和 gap 残差。
- `*CONTACT PAIR` 支持 `AUGMENT=` / `AUGMENT_FACTOR=` pair 级参数。
- `*SURFACE INTERACTION` / `*CONTACT PROPERTY` 支持 `AUGMENT=` / `AUGMENT_FACTOR=`,并可继承到 contact pair。
- 刚性平面 analytical contact pair 和面-面 contact pair 的法向压力统一经过 `penalty * penetration + lambda` 路径。
- 接触力计算后统一 finalize active-set 状态,区分 open、activated、maintained、released。
- active pair 按当前 gap 残差更新增广乘子,released pair 自动清零增广乘子。
- contact CSV 追加输出 pair 状态、激活/释放次数、gap 残差、增广系数和增广乘子。
- 新增 Fortran API `fem_get_contact_diagnostics`,可查询 active pair 数、activated/maintained/released pair 数、最大 gap residual 和最大 augmented penalty 乘子。
- C ABI 追加 `femlite_get_contact_diagnostics`,保持 `femlite_get_contact_summary` 向后兼容。
- `examples/` 下新增刚性平面压入、两实体块面-面压缩、S4 壳-刚性平面接触三个独立小算例目录。
- 每个新增接触算例目录提供 `run_case.bat`,支持 Windows 双击自动运行并检查结果。
已补充测试:
- analytical rigid plane contact pair 的 active set 激活、保持、释放状态切换。
- 增广乘子对第二次接触力的贡献和释放后的清零。
- contact property 中 `AUGMENT` 参数解析和 pair 继承。
- contact CSV header 回归覆盖 active-set/augmented penalty 诊断列。
- Fortran API 和 C ABI 接触诊断查询回归。
- 三个新增示例均已运行,检查脚本确认 active contact、gap residual、augmented multiplier 和 VTK 输出存在。
- 三个 `run_case.bat` 已用 `FEMLITE_NO_PAUSE=1` 自动模式验证通过。
- Windows GCC 16 构建和全量 CTest 已通过,33/33 passed。
后续:
- gap/mortar 残差已在 V4.5 接入非线性求解统计;后续继续标定接触穿透硬收敛准则。
- 增强 contact tangent 对 active set 状态和增广路径的诊断输出。
- 将 pair 级 augmented penalty 乘子推进到 mortar 积分点级历史,并在后续 V4.x 中与摩擦历史统一调试输出。
## 24. 0.4.3 开发记录
### V4.3 摩擦正则化与摩擦功输出起步
完成状态:V4.3 阶段完成,可作为 FemLite 0.4.3 候选基线;完整工程级 mortar 约束求解器和更强并行接触装配仍进入后续 0.4.x。
已完成:
- `*CONTACT PAIR` 和 `*SURFACE INTERACTION` / `*CONTACT PROPERTY` 支持 `FRICTION_REGULARIZATION=` / `FRICTION_REG=` 参数。
- `*FRICTION` 数据行支持第二个可选值作为摩擦正则化滑移尺度。
- contact pair 新增摩擦正则化滑移尺度、摩擦 step 功和摩擦累计功状态。
- 默认 `FRICTION_REGULARIZATION=0` 时保持经典 Coulomb 截断;正则化大于 0 时使用 `tanh(s_eq/s_reg)` 平滑 Coulomb 极限。
- 正则化摩擦切线使用相同 `tanh(s/s_reg)` 因子折减接触对级切向近似块,保持与力路径的参数趋势一致。
- 新增 `fem_contact_history`,将切向摩擦历史从单一 contact pair 标量推进到 mortar 积分点槽,槽键为 `pair + slave element/face + master element/face + point_id`;数据库初始化和释放时清空历史,模型内跨时间步保留。
- restart 文件格式升级到 v2,追加 `CONTACT_HISTORY` 段保存 mortar 积分点摩擦历史;读入端兼容旧 v1 文件,并在旧文件路径下清空当前接触历史。
- contact CSV 和 history CSV 增加摩擦功、摩擦累计功和摩擦正则化参数字段。
- 新增 Fortran API `fem_get_contact_friction` 和 C ABI `femlite_get_contact_friction_summary`。
- 新增 Fortran API `fem_get_contact_hist_stats` 和 C ABI `femlite_get_contact_history_stats`,用于查询 mortar 积分点历史槽数量、单槽最大滑移、单槽最大摩擦功和单槽最大切向力。
- `examples/contact_block_sliding/` 新增两块 C3D8 正则化摩擦滑移示例,包含 `run_case.bat` 和摩擦功检查脚本。
已补充测试:
- 默认 Coulomb 摩擦力、滑移计数、累计滑移和摩擦功回归。
- 正则化 Coulomb 摩擦力降低、切向近似切线折减、正摩擦耗散功和累计滑移回归。
- mortar 积分点历史在连续模型运行中不会串状态,`contact` 回归覆盖数据库生命周期 reset。
- mortar 积分点历史统计 API 回归覆盖非零历史槽和 C ABI 空模型零值。
- `contact` 回归检查正则化摩擦会创建多个积分点历史槽,并验证这些槽处于 slip 状态。
- `restart` 回归覆盖接触历史写读一致性,检查历史槽、累计滑移、摩擦功和切向力。
- contact property 中 `FRICTION_REGULARIZATION` 参数解析和 pair 继承。
- contact friction summary C ABI 空模型零值回归。
- contact block sliding friction 示例已接入 `example_smoke`,短步数回归检查 active contact、正则化参数、累计滑移、切向力、摩擦功非负和 VTK 输出。
- `contact`、`restart`、`c_api`、`implicit_inp`、`source_size` 和 `example_contact_block_sliding_smoke` 定向 CTest 已通过。
- Windows GCC 16 全量 CTest 已通过,34/34 passed。
后续:
- 继续完善 stick/slip 切换的更严格算法一致切线,并补充更多切线回归。
- 在 V4.4 中降低 OpenMP 接触力/切线装配锁竞争,补充并行一致性测试。
- 将 mortar 积分点历史暴露为可选调试输出,避免默认输出体量过大。
## 25. 0.4.4 开发记录
### V4.4 搜索统计与并行优化起步
完成状态:V4.4 起步,尚未作为发布版本;当前项目版本仍为 0.4.3。
已完成:
- `fem_contact_state` 新增全局与逐 contact pair 搜索统计,记录 facet 数、master facet 数、候选评估数、active 候选数和 BVH 节点数。
- `fem_contact_state` 新增 contact search/force/tangent CPU 时间统计,使用 Fortran `cpu_time` 作为轻量趋势诊断。
- BVH contact pair 力路径新增 slave facet 局部 active 候选缓存,第一遍权重搜索保存 `master/gap/vn`,第二遍施力复用缓存;缓存溢出时自动回退旧 BVH 遍历施力路径。
- BVH cached force 路径拆分为线程本地 `contact_prepare_force_state` 和短临界区 `contact_commit_force_state`;cached、cached broad overflow 和非缓存 BVH 回退路径均在 `critical` 外完成法向、mortar 权重、接触面积和切向方向准备,锁内只保留摩擦历史、全局力向量、切向历史和 active 状态提交。
- BVH contact pair 切线路径复用同类 slave facet 局部 active 候选缓存,并按 slave facet 批量进入切线装配保护区;缓存溢出时回退旧 BVH 遍历切线路径。
- BVH contact pair 切线并行装配拆分为线程本地 `contact_prepare_pair_tan` 和短临界区 CSR 合并;cached、cached broad overflow 和非缓存 BVH 回退路径均在 `critical` 外完成法向、mortar 权重和切线块计算。
- 新增 `fem_contact_candidate_cache`,保存 BVH force/tangent 共享的跨调用 broad candidate 列表;当 facet 拓扑、pair 名称、search 距离一致且 facet 中心/半径变化未超过 `0.25 * search` 阈值时复用,命中后跳过 BVH 构建并重新计算当前 gap/vn/active 状态。
- 候选缓存失效条件覆盖 contact pair 重分配、数据库 finalize、facet 拓扑变化、pair slave/master 名称变化、search 距离变化、候选列表溢出和 facet 运动超阈值。
- `fem_contact_state` 新增 BVH 候选缓存使用和溢出统计。
- 全搜索、uniform grid 和 BVH 力路径在第一遍候选评估中记录 broad/active 候选统计。
- BVH 并行权重搜索改为局部候选计数后集中汇总,避免在热循环中直接写全局统计。
- BVH force 权重准备阶段使用 OpenMP reduction 汇总 broad/active 统计,退出并行区后一次性写入全局与 pair 级统计,移除每个 slave facet 一次的统计临界区。
- 新增 Fortran API `fem_get_contact_search_stats`。
- 新增 Fortran API `fem_get_contact_perf_stats`。
- 新增 Fortran API `fem_get_contact_cache_stats`。
- C ABI 追加 `femlite_get_contact_search_stats`,保持既有 contact summary/diagnostics/friction/history 接口不变。
- C ABI 追加 `femlite_get_contact_perf_stats`。
- C ABI 追加 `femlite_get_contact_cache_stats`。
- 新增 `perf_contact_pair` 性能程序,程序内生成 S4 master/slave 面对,输出 facet/master/candidate/active/BVH 节点、缓存命中和接触 search/force/tangent CPU 时间统计。
- contact CSV 的 `SUMMARY` 行追加全局 `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` 字段;逐 `PAIR` 行通过 `contact_get_pair_stats` 写出对应接触对的搜索、缓存和计时统计。
已补充测试:
- `contact` 回归检查实际 contact pair 小算例的 facet/master/broad/active 统计非零,非 BVH 小算例 BVH 节点数为 0。
- `contact` 回归检查 contact CSV header 包含新增搜索统计和 CPU 时间统计字段。
- `contact` 回归检查 `contact_get_pair_stats` 的逐 pair 统计,并确认 contact CSV 中存在 `PAIR` 行。
- `contact` 回归检查 BVH 小算例 cache used 非零、cache overflow 为 0。
- `contact` 回归检查 BVH 小算例第一次力计算建立跨调用候选缓存,第二次同几何力计算命中缓存且不重建 BVH,随后切线装配复用同一候选缓存,slave facet 移动超过失效阈值后缓存失效并重新构建 BVH。
- 新增 `contact_omp1` 和 `contact_omp4` CTest 变体,分别以 `OMP_NUM_THREADS=1/4` 重跑 contact 模块,覆盖 OpenMP 串并行路径;contact 系列测试标记 `RUN_SERIAL`,避免固定 CSV 输出并行互踩。
- 新增 `perf_contact_pair_smoke` 和 `perf_contact_pair_medium` CTest,分别以 32/64 对 S4 面片触发 BVH contact pair、active 接触、缓存命中和切线装配路径。
- 新增 `perf_contact_pair_omp_consistency` CTest,通过 `tests/scripts/check_perf_contact_pair_omp.py` 对比 `perf_contact_pair` 在 `OMP_NUM_THREADS=1/4` 下的 active、broad/active 候选、BVH 节点和缓存命中统计,保护性能 smoke 的串并行一致性。
- `c_api` 回归检查空接触模型搜索统计为全零。
- `c_api` 回归检查空接触模型性能计时为全零。
- `c_api` 回归检查空接触模型缓存统计为全零。
- `source_size` 回归确认新增接口未触发源码尺寸硬阈值。
- `contact`、`contact_omp1`、`contact_omp4`、`c_api`、`source_size`、`perf_contact_pair_smoke` 和 `example_contact_block_sliding_smoke` 定向 CTest 已通过;reduction 汇总后统计值保持回归一致,跨调用候选缓存 force/tangent 命中和失效回归通过。
- `perf_contact_pair_smoke`、`perf_contact_pair_medium`、`perf_contact_pair_omp_consistency` 和 `source_size` 定向 CTest 已通过,确认新增性能一致性脚本、medium 性能 smoke 和源码规模检查可用。
- Windows GCC 16 全量 CTest 已通过,39/39 passed。
- Windows GCC 16 并行 CTest `-j 4` 已通过,37/37 passed;contact 系列 `RUN_SERIAL` 可避免固定 CSV 输出并行互踩。
后续:
- 评估按 slave facet 的线程私有力增量和历史提交边界,进一步缩短 force 路径全局提交临界区。
- 补充更大规模 OpenMP 性能测试,继续评估分块 CSR 累加或线程私有增量合并。
## 26. 0.4.5 开发记录
### V4.5 隐式非线性收敛诊断完善
完成状态:V4.5 收敛诊断和 cutback 失败诊断已形成阶段完善基线;contact gap/mortar residual 已纳入多准则统计,硬接触穿透停止准则保留为后续标定项。
已完成:
- `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 为零值。
后续:
- 标定 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 默认路径。
## 28. 0.4.7 开发记录
### V4.7 壳稳定、壳塑性与壳基准完善
完成状态:V4.7 壳稳定参数化、壳 J2 剪切/代表性弯曲塑性回归、trial/rollback 和 Scordelis-Lo 小型基准 smoke 已形成阶段完善基线;完整厚度方向 section integration 和更大曲壳基准矩阵继续进入 V4.8 验收扩展。
已完成:
- `fem_control` 新增壳 drilling 稳定系数、S3 剪切锁定折减系数、最小折减比例和壳稳定性统计状态。
- `fem_element_stiffness` 将 drilling 稳定系数和 S3 剪切折减改为可配置参数,并在每次壳刚度装配后记录 sample count、最近单元、最近 drilling 刚度、最近剪切折减、最小剪切折减和最大 drilling 刚度。
- 壳 J2 内力路径将膜、横向剪切和 `0.5 * thickness * bending strain` 外纤维弯曲近似组合为代表性三维小应变,使剪切和弯曲加载均可触发塑性状态更新。
- S4 J2 弯曲应变写入 `statev(13:15)`,便于回归检查和后续 section integration 迁移。
- 新增 Fortran API `fem_set_shell_stabilization`、`fem_get_shell_stabilization` 和 `fem_get_shell_stability_stats`。
- C ABI 新增 `femlite_set_shell_stabilization`、`femlite_get_shell_stabilization` 和 `femlite_get_shell_stability_stats`。
- `tests/scripts/run_example_smoke.py` 新增可选节点位移探针,用于 benchmark smoke 检查位移方向和最小量级。
- 新增 `examples/scordelis_lo_roof/` 独立基准目录,包含 S4/S3 Scordelis-Lo 静力输入和 README;旧 `examples/ScordelisLo/` 保留兼容。
- CTest 新增 `example_scordelis_lo_s4_smoke` 和 `example_scordelis_lo_s3_smoke`,检查自由角节点 `uz` 为负且超过最小量级。
已补充测试:
- `element_stiffness` 回归覆盖 drilling 稳定系数默认/关闭/提高的刚度敏感性,以及 S3 剪切折减诊断统计。
- `shell_internal` 回归覆盖 S4 J2 膜内塑性、剪切塑性、代表性弯曲塑性、section tangent 对称性和 trial rollback 状态恢复。
- `c_api` 回归覆盖壳稳定参数默认值、空模型统计、参数切换和恢复默认。
- `source_size` 定向 CTest 已通过,新增接口和测试未触发源码规模硬阈值。
- `example_scordelis_lo_s4_smoke` 和 `example_scordelis_lo_s3_smoke` 已通过,确认新增 benchmark 目录和节点位移探针可用。
后续:
- 在 V4.8 中补充 pinched cylinder、hemisphere、twisted beam 和更密 Scordelis-Lo 网格收敛矩阵。
- 将代表性外纤维弯曲塑性扩展为可选多层壳厚度积分时,保持现有 trial/rollback、section tangent 和外部诊断接口兼容。
- 补充更长时间 pressure pulse 与壳接触长跑验证,形成第四版阶段验收报告。
## 29. 0.4.8 开发记录
### V4.8 示例验收、发布检查与阶段报告完善
完成状态:V4.8 将第四版阶段验收收束到可运行示例矩阵、发布前自动检查和验收报告。`examples/` 下每个文档型目录均补充了可执行输入文件,每个包含 `.inp` 的示例目录均提供 `run_case.bat` 双击运行入口。
已完成:
- 新增 `examples/elliptic_membrane/` S4 静力缩减案例,基于 NAFEMS LE1 椭圆膜文档的几何、材料和边界尺度。
- 新增 `examples/membrane_uniaxial_stretching/` S4 单轴拉伸静力案例,采用文档中的各向同性膜材料参数。
- 新增 `examples/shell_solid_connection/` 共享节点壳-实体接口静力案例,覆盖 C3D8 与 S4 混合模型路径。
- 新增 `examples/strengthReduction/` 线弹性坡体楔形静力案例,作为强度折减文档的可执行占位基准。
- 新增 `examples/golfBallImpact/` 壳接触动力缩减案例,采用文档中的摩擦系数尺度并复用刚球冲击路径。
- 为 `clamped_square_plate_pressure_pulse`、`Kirsch`、`rigid_sphere_impact_plate`、`scordelis_lo_roof`、`ScordelisLo`、`shell_patch_test`、`tension2D`、`uniaxialTension3D` 和上述新增目录补充 `run_case.bat`。
- 新增通用 `examples/run_example_case.bat`,统一示例双击运行、结果目录清理和失败码返回。
- 新增 `tests/scripts/check_examples_layout.py`,检查 `examples/` 一级目录中“有文档无 `.inp`”和“有 `.inp` 无 `run_case.bat`”的回退。
- CTest 新增 `examples_layout`,并将新增五个文档派生案例接入 `example_smoke`。
- 新增 `docs/v4_acceptance_report.md`,记录第四版 V4.8 阶段验收范围、测试矩阵、示例矩阵和后续限制。
已补充测试:
- `elliptic_membrane_s4_static.inp`、`membrane_uniaxial_s4_static.inp`、`shell_solid_connection_static.inp` 和 `strength_reduction_slope_static.inp` 已完成静力求解 smoke。
- `example_golf_ball_impact_smoke` 使用短步数动态输入检查接触输出,避免常规回归运行完整长跑。
- `examples_layout` 纳入 Python CTest 分支,保护示例目录结构约定。
- Windows GCC 16 Release 构建已通过;全量 CTest 已通过,47/47 passed。
- 已手动验证 `examples/elliptic_membrane/run_case.bat` 静力入口和 `examples/clamped_square_plate_pressure_pulse/run_case.bat` 动力入口均可在 `FEMLITE_NO_PAUSE=1` 下完成。
后续:
- 将完整 pinched cylinder、hemisphere、twisted beam 和多密度 Scordelis-Lo 收敛矩阵作为 0.5.x 或专项长跑扩展,不阻断 V4.8 阶段验收。
- 当 Mohr-Coulomb、超弹/黏弹和完整 shell-solid coupling 能力进入核心求解器后,将当前文档派生缩减案例替换或扩展为更高保真 benchmark。