# 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 稳定系数 | 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 匹配函数仅对 `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 残差接入非线性求解统计和收敛准则。 - 增强 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 累加或线程私有增量合并。