Files
FemLite/docs/v4_development_plan.md
T
2026-06-24 19:06:37 +08:00

29 KiB
Raw Blame History

FemLite 0.4.x 第四版开发计划

文档状态:第四版开发建议稿

日期:2026-06-24

适用对象:FemLite 0.4.0 至 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 约束求解器。
  • 摩擦模型当前以接触对级 Coulomb 粘滑历史为主,尚未形成接触积分点级历史和摩擦正则化参数体系。
  • 大规模接触收敛控制、接触域分解和负载均衡仍需推进。
  • 壳塑性一致切线仍需要更多弯曲/剪切塑性基准和长时间稳定性验证。
  • 非线性 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.0:完整 surface/contact 工程常用子集和工程级接触框架。
  • 0.4.1:摩擦正则化、接触积分点历史和接触功输出增强。
  • 0.4.2:隐式非线性长跑、步长控制和外部稀疏求解器接口。
  • 0.4.3:壳塑性基准、性能优化、多平台发布整理。

发布前必须更新:

  • 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 残差和更一致切线
摩擦历史 接触对级 Coulomb 粘滑历史,切向刚度按 penalty * area 估计 不删除 V4.3 升级为接触积分点或 mortar 积分点历史、正则化 Coulomb 和摩擦功输出
接触并行 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、单元状态和高斯点状态,不保存完整 inp 模型数据库 保留 如 V4 新增接触积分点历史,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 级摩擦历史 A 类。升级到接触积分点或 mortar 积分点历史,补充正则化 Coulomb、粘滑切换和摩擦功输出 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 类。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.0 开发记录

V4.1 Surface/Contact 输入增强

已启动:

  • 新增 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 继承。
  • 数据库全局状态拆出到 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 名称在模型构建阶段报错。
  • implicit_inp:检查 surface_type、node target、facet 匹配隔离、node surface 查询接口和 fem_build_model。
  • contact:确认旧 element surface/contact pair 路径不回退。
  • source_size:确认数据库状态拆分后源文件不超过硬性行数限制。

后续:

  • 在节点-面接触或后续 contact pair 扩展中接入 node-based slave surface。
  • 增加 analytic rigid surface 子集。