Files
FemLite/docs/v4_development_plan.md
T
shenw 8f9c1ece61
FemLite CI / build-test (push) Has been cancelled
Complete V4.8 hardening and examples coverage
2026-06-25 11:27:59 +08:00

55 KiB
Raw Blame History

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_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、GMRES、none/Jacobi 预条件和统计查询;外部第三方库后端作为后续适配项 V4.6, V4.8 hardening
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.8 阶段验收版。

已完成:

  • 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 线性求解器抽象、内部可切换求解路径、预条件选择和最近一次求解统计已形成阶段完善基线;V4.8 后硬化补充内部 GMRES,外部第三方稀疏求解器不再作为第四版完成项。

已完成:

  • fem_control 新增线性求解器方法、预条件方法和最近一次线性求解统计状态。
  • fem_linear_solver_cg 保留兼容 linear_cg_solve,新增 linear_solver_solve 分发层。
  • 新增 BiCGSTAB 内部求解器,覆盖非对称 CSR 小系统。
  • 预条件器支持 LPRECOND_NONE 和 LPRECOND_JACOBI。
  • 隐式线性静力、线性 Newmark、非线性静力 Newton 修正方程和非线性 Newmark 修正方程均改为通过分发层求解。
  • LSOLVER_GMRES 已接入分发层,作为 CG/BiCGSTAB 之外的内部非对称 Krylov 求解器。
  • LSOLVER_EXTERNAL 仅作为后续外部第三方稀疏库适配预留 method;当前实际求解返回 LS_STATUS_UNSUPPORTED,不计入 V4.8 完成范围。
  • 新增 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 回归覆盖 GMRES + Jacobi 求解非对称 CSR 小系统,并保留外部求解器未启用时的明确 unsupported 状态。
  • implicit_inp 回归将隐式线性静力路径切换到 BiCGSTAB,并检查最后一次线性求解统计。
  • c_api 回归覆盖线性求解器默认设置、空模型统计、切换到 BiCGSTAB + none、切换到 GMRES + Jacobi 和恢复默认。
  • 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 阶段验收范围、测试矩阵、示例矩阵和后续限制。
  • V4.8 后硬化新增 examples/node_analytical_plane_contact/,将 node-based slave surface 到 analytical rigid plane 的接触路径提升为可双击示例和 CTest smoke。
  • V4.8 后硬化新增内部 GMRES 求解器和 perf_contact_pair_p1,增强线性求解器与接触性能验收覆盖。
  • V4.8 后硬化补齐 examples/block_on_arch/、examples/cylinder_roller_contact/、examples/sliding_wedge/、examples/membrane_airbag_inflation/、examples/spherical_cap_with_central_point_load/、examples/two_arches/、examples/blasting_rock/、examples/nonlinear_harmonic/、examples/failure_prediction_in_a_layered_shell/、examples/pinched_hemispherical_shell/、examples/stress_dependent_elasticity/、examples/roll_forming/、examples/falling_objects/、examples/ball_adhesion_decohesion/、examples/buckling_corrugated_shell/、examples/Dynamic_Grain_Packing_of_a_Flexible_Container/ 和 examples/thick_plate/;每个目录均包含 README、可执行 .inp 和 run_case.bat,并在 README 中标明当前求解器覆盖范围与未覆盖的完整高保真能力。

已补充测试:

  • 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 使用短步数动态输入检查接触输出,避免常规回归运行完整长跑。
  • 新增 example_node_analytical_contact_smoke、example_block_on_arch_contact_smoke、example_cylinder_roller_contact_smoke、example_sliding_wedge_friction_smoke、example_roll_forming_friction_smoke、example_falling_objects_contact_smoke、example_ball_adhesion_contact_smoke、example_buckling_corrugated_shell_smoke、example_dynamic_grain_container_smoke、example_thick_plate_pressure_smoke、example_membrane_airbag_pressure_smoke、example_spherical_cap_point_load_smoke、example_blasting_rock_pulse_smoke、example_nonlinear_harmonic_membrane_smoke、example_layered_shell_tension_smoke、example_two_arches_contact_smoke、example_pinched_hemisphere_smoke 和 example_stress_dependent_cantilever_smoke,覆盖节点-解析面、壳/实体接触、摩擦滑移、多物体接触、球-膜压入、波纹锥壳静力预载、柔性容器压力-地面接触、厚板压力、压力载荷、脉冲动力、壳-壳接触、层合壳拉伸、曲壳 pinched load 和分区弹性梁弯曲路径。
  • examples_layout 纳入 Python CTest 分支,保护示例目录结构约定。
  • Windows GCC 16 Release 构建已通过;全量 CTest 已通过,66/66 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。