45 KiB
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 定位为:
工程级非线性接触 + 隐式非线性求解增强 + 壳塑性验证 + 大规模性能基础版
第四版不是追求完整 Abaqus 全关键字兼容,也不是一次性完成所有工业级通用有限元能力。第四版的核心是把 0.3.3 已具备的阶段能力继续工程化,尤其是:
- 将 surface/contact 输入从 element-target 子集扩展为更完整的工程常用子集。
- 将面-面 contact pair 从 penalty/mortar 权重阶段能力推进到更稳健的 mortar/augmented penalty 接触框架。
- 将 Coulomb 摩擦从接触对级历史推进到更完整的接触积分点历史与正则化模型。
- 将非线性 Newmark-Newton 从骨架和小算例回归推进到更可靠的工程非线性求解流程。
- 将壳塑性、钻转稳定、剪切锁定和壳接触纳入系统验证。
- 将大规模接触搜索、并行、外部稀疏求解器和性能测试纳入阶段验收。
第四版工程约束:
- 普通过程/函数尽量不超过 100 行,超过 128 行必须登记审查理由和后续拆分方向。
- 源文件尽量不超过 1500 行,超过 2000 行必须审查是否拆分。
source_sizeCTest 继续作为本地回归检查项。- 新增大型算例结果不得全量提交到 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 输入习惯。
建议实现内容:
- 扩展
*SURFACE:TYPE=ELEMENT的更多数据行变体。TYPE=NODE或 node-based surface 子集。- analytic rigid surface 子集。
- surface
GENERATE。 - surface
OP=ADD、OP=NEW的完整回归。 - element set、node set、混合显式编号的数据行。
- 扩展 shell surface 语义:
SPOS、SNEG、双侧 shell surface 行为。- 壳法向翻转、slave/master 侧向筛选。
- 扩展
*CONTACT PAIR:- header 式和数据行式输入。
- contact property 名称关联。
- 小滑移/有限滑移参数先 warning 或保留字段。
- 增加接触属性输入:
- 法向 penalty。
- 法向阻尼。
- 摩擦系数。
- 摩擦正则化参数预留。
- 明确 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 权重阶段能力推进到更稳健的工程接触求解框架。
建议实现内容:
- 接触 active set:
- 激活、保持、释放三类状态。
- 接触开闭切换记录。
- 初始穿透处理策略。
- 接触残差:
- 法向 gap 约束残差。
- mortar 约束积分残差。
- slave/master 双侧贡献。
- 接触切线:
- gap 对节点位移的线性化。
- 法向变化项的近似或一致处理。
- mortar 权重对局部坐标的敏感性可先近似,需文档说明。
- 求解策略:
- penalty 继续保留为默认稳健路径。
- augmented penalty 或 augmented Lagrangian 作为第四版主增强方向。
- Lagrange multiplier 路径可预留,不作为 0.4.0 必需项。
- 接触稳定化:
- 法向 penalty 自动建议值。
- penalty 过大导致病态时的诊断。
- 穿透容限和接触力容限。
验收条件:
- 平块压入刚体平面静力接触可收敛。
- 两弹性块面-面压缩接触可收敛,压力分布合理。
- 壳-刚体接触可运行并输出接触功。
- active set 切换不会破坏 trial/rollback。
- 接触残差、接触力、最大穿透量和接触功随网格加密趋势合理。
8. V4.3 摩擦与接触输出
目标:
- 从接触对级摩擦历史推进到接触积分点级或 mortar 积分点级摩擦历史。
- 建立可验证的摩擦功、接触功和粘滑状态输出。
建议实现内容:
- 摩擦历史变量:
- 接触积分点切向滑移。
- 切向牵引。
- stick/slip 状态。
- 累计滑移。
- 摩擦模型:
- 无摩擦。
- Coulomb 摩擦。
- 正则化 Coulomb 摩擦。
- 粘滑转换返回映射。
- 摩擦切线:
- stick 状态切向 penalty。
- slip 状态一致或近似切线。
- 正则化参数对切线的影响。
- 输出:
- 法向接触功。
- 摩擦功。
- 累计耗散能。
- stick/slip 计数。
- 最大穿透和最大切向滑移。
- contact pair 分项统计。
验收条件:
- block sliding 摩擦算例可重现静摩擦到动摩擦转换趋势。
- 摩擦功非负耗散检查通过。
- 粘滑循环加载历史变量不丢失。
- contact CSV 字段稳定并在用户手册中说明。
9. V4.4 搜索、并行与大规模接触
目标:
- 提高接触搜索和接触装配在大规模模型中的效率与可诊断性。
建议实现内容:
- BVH 增强:
- BVH 构建、重构和更新策略。
- facet AABB 扩张距离。
- 候选缓存与失效条件。
- 空间网格增强:
- 网格尺寸自动估计。
- 高度非均匀模型的 fallback 策略。
- OpenMP 并行:
- slave facet 并行搜索。
- contact pair 并行残差计算。
- 装配阶段减少临界区。
- 摩擦历史更新的线程安全。
- 性能输出:
- facet 数。
- broad-phase 候选数。
- narrow-phase 激活数。
- 搜索时间。
- 接触力和切线装配时间。
验收条件:
- 大规模接触 P1 性能测试通过。
- 并行和串行路径结果在容限内一致。
- 接触搜索时间随 facet 数增长趋势合理。
- OpenMP 关闭时功能不回退。
10. V4.5 隐式非线性求解鲁棒性
目标:
- 让非线性静力和非线性 Newmark-Newton 可用于更复杂材料、接触和壳模型。
建议实现内容:
- Newton 策略:
- full Newton。
- modified Newton。
- 自动切换或用户控制。
- 收敛准则:
- 力残差绝对/相对准则。
- 位移增量准则。
- 能量范数准则。
- 接触穿透准则。
- 步长控制:
- 自适应增量。
- cutback 后状态恢复。
- 最小步长退出。
- 最大 cutback 次数。
- 线搜索:
- 残差型线搜索。
- 能量型线搜索预留。
- 失败诊断:
- 线性求解失败。
- 接触 penalty 病态。
- 约束不足。
- 材料局部失效导致刚度退化。
验收条件:
- 非线性静力弹塑性加载卸载长跑稳定。
- 接触非线性静力压入可自动 cutback 并最终收敛。
- 非线性 Newmark 接触冲击小算例可完成指定时间。
- 失败日志能说明失败阶段、残差和建议检查项。
11. V4.6 稀疏求解器接口
目标:
- 建立内部/外部线性求解器可切换的架构,为大规模隐式求解做准备。
建议实现内容:
- 线性求解器抽象层:
- CSR 矩阵输入。
- RHS 和解向量。
- 求解器参数。
- 迭代历史和失败码。
- 内部求解器增强:
- CG 保留。
- BiCGSTAB 或 GMRES。
- Jacobi 预条件。
- 简单对角缩放。
- 外部求解器预留:
- MUMPS。
- SuperLU。
- Intel MKL Pardiso。
- oneAPI/MKL 检测和 CMake 选项。
- 跨平台策略:
- 默认不强依赖外部库。
- 外部库不可用时自动降级到内部求解器。
- Windows、WSL Linux、Intel Fortran 和 gfortran 路径都需可配置。
验收条件:
- 线性求解器接口单元测试通过。
- 内部 CG/BiCGSTAB 或 GMRES 可在相同 CSR 矩阵上切换。
- 外部求解器未启用时构建不受影响。
- 求解器残差和迭代数进入 convergence CSV 或日志。
12. V4.7 壳塑性与壳非线性基准
目标:
- 系统验证壳单元在塑性、弯曲、剪切、锁定和接触问题中的表现。
建议实现内容:
- 壳塑性切线:
- 膜内塑性路径继续保留。
- 弯曲塑性一致切线增强。
- 横向剪切塑性切线增强。
- section 积分点状态 trial/rollback 检查。
- 壳数值稳定:
- drilling DOF 稳定参数敏感性。
- 剪切锁定敏感性。
- 膜锁定敏感性。
- hourglass 控制策略复查。
- 壳基准:
- Scordelis-Lo 网格收敛。
- pinched cylinder。
- hemispherical shell。
- twisted beam。
- clamped square plate pressure pulse 长跑。
- 壳接触:
- 壳-刚体接触。
- 壳-壳接触。
- 壳 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:
- 扩展 surface/contact 输入和数据结构。
- 固化 contact pair property、active set 和状态变量。
- 将现有 penalty/mortar 接触接入新的 active set 框架。
- 增加小型接触收敛测试。
- 再推进摩擦正则化、并行搜索和隐式求解鲁棒性。
这样可以先稳定数据结构和接口,再逐步替换接触算法内部实现,降低对已有显式、静力和隐式测试的冲击。
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 稳定系数 | B 类。改为可配置参数,增加默认推荐值、敏感性测试、失稳诊断和用户手册说明 | V4.7 |
| S8 | S3 剪切锁定经验缩放 | B 类。通过壳基准验证误差;必要时增加改进减缩、MITC/ANS 预研路径或更明确适用范围 | V4.7 |
| 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 |
| 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 匹配函数仅对
ELEMENTsurface 生效,避免把 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 ABIfemlite_get_contact_friction_summary。 - 新增 Fortran API
fem_get_contact_hist_stats和 C ABIfemlite_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 时间统计,使用 Fortrancpu_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_omp4CTest 变体,分别以OMP_NUM_THREADS=1/4重跑 contact 模块,覆盖 OpenMP 串并行路径;contact 系列测试标记RUN_SERIAL,避免固定 CSV 输出并行互踩。 - 新增
perf_contact_pair_smoke和perf_contact_pair_mediumCTest,分别以 32/64 对 S4 面片触发 BVH contact pair、active 接触、缓存命中和切线装配路径。 - 新增
perf_contact_pair_omp_consistencyCTest,通过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 接触长跑基准。