# 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 定位为: ```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 约束求解器。 - 摩擦模型当前以接触对级 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。 - 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 匹配隔离和 `fem_build_model`。 - `contact`:确认旧 element surface/contact pair 路径不回退。 - `source_size`:确认数据库状态拆分后源文件不超过硬性行数限制。 后续: - 增加 node-based surface 查询接口。 - 在节点-面接触或后续 contact pair 扩展中接入 node-based slave surface。 - 增加 analytic rigid surface 子集。