Files
FemLite/docs/v3_development_plan.md
T
shenw 108c646f39
FemLite CI / build-test (push) Has been cancelled
Implement FemLite 0.3.2 mortar contact BVH
2026-06-23 20:40:34 +08:00

17 KiB
Raw Blame History

FemLite 0.3.0 第三版开发计划

文档状态:第三版开发基线草稿

日期:2026-06-23

适用对象:FemLite 0.3.0 开发、评审、测试与阶段验收

1. 文档目的

本文档定义 FemLite 第三版的开发目标、阶段划分、技术路线、验收准则和风险控制。

第三版以 0.2.0 第二版最小可用/阶段验收版为起点,在不破坏第一版显式动力学和第二版框架能力的前提下,正式补齐静力学计算、壳单元静力、隐式非线性和通用接触能力。

2. 第三版定位

FemLite 0.3.0 定位为:

线性/非线性静力学 + 壳静力基准 + 隐式非线性动力学基础 + 通用接触增强版

第三版不是简单增加示例算例,而是把 0.2.0 中的最小可用框架推进到可工程验收的求解能力。

第三版核心目标:

  • 正式支持线性静力学计算。
  • 正式支持非线性静力学计算。
  • 补齐实体单元和壳单元静力刚度。
  • 让 Scordelis-Lo 屋面壳体成为可验收的壳静力基准。
  • 建立隐式 Newmark + Newton 非线性动力学框架。
  • 增强通用接触搜索、节点-面接触和面-面接触框架。
  • 输出静力学反力、收敛历史、接触状态和 VTK/CSV 结果。

3. 开发基线

0.2.0 已具备:

  • 显式瞬态动力学。
  • C3D4、C3D8、C3D10、C3D20、S3、S4、S6、S8 基础单元能力。
  • 各向同性线弹性和 J2 弹塑性材料路径。
  • Abaqus inp 子集读取。
  • CSR 稀疏矩阵、CG 线性求解器和隐式线弹性最小流程。
  • Robin、MPC 和基础刚性平面 penalty 接触。
  • VTK、restart、C ABI 和 Python 调试接口。
  • Windows GCC 和 WSL gfortran 基础构建测试。

0.2.0 已知限制中进入第三版的内容:

  • 线性静力仅为最小流程,尚未正式覆盖壳单元静力。
  • 隐式求解不是完整 Newmark + Newton 非线性框架。
  • 接触不是通用面-面接触,也缺少完整接触搜索和接触输出。
  • 壳单元仍需 hourglass 控制、drilling DOF 稳定和更完整壳塑性路径。
  • 静力学反力、收敛历史和静力 VTK 输出需要统一工程化。

4. 版本与分支策略

建议分支:

  • main:保持已发布稳定版本。
  • dev/v0.3:第三版主开发分支。
  • feature/v3-static:静力学求解相关开发。
  • feature/v3-shell-static:壳单元静力刚度和基准算例。
  • feature/v3-contact:通用接触增强。

版本号策略:

  • 开发阶段使用 0.3.0-dev。
  • 第三版验收通过后更新为 0.3.0。
  • 发布前形成 v3_acceptance_report.md,但该报告应在验收阶段再创建。

5. 第三版阶段划分

第三版分为 8 个阶段。

阶段 名称 主要内容 阶段结果
V3.1 静力学控制与输入 *STATIC、命令行、控制参数、输出字段 静力模式可进入求解流程
V3.2 实体线性静力 C3D4/C3D8/C3D10/C3D20 静力刚度和反力 实体线性静力算例通过
V3.3 壳线性静力 S3/S4/S6/S8 壳静力刚度和 Scordelis-Lo 壳静力基准可计算
V3.4 非线性静力 修正 Newton、增量加载、J2 弹塑性、线搜索和步长缩减 小型弹性/J2 静力算例通过
V3.5 隐式 Newmark 线弹性 Newmark、非线性 Newmark-Newton、有效刚度和命令行入口 小型隐式动力算例通过
V3.6 通用接触增强 接触面、搜索、节点-面预留、面-面框架 接触静力/动力小算例通过
V3.7 输出与接口 反力、收敛历史、接触状态、API 扩展 静力/隐式输出完整
V3.8 测试与验收 回归、基准、文档、验收报告 形成 0.3.0 验收版

6. V3.1 静力学控制与输入

目标:

  • 将静力学作为正式求解类型,而不是隐式线弹性调试入口。
  • 保持 --implicit-linear 兼容,同时新增清晰命令行。

开发内容:

  1. 增加分析类型控制:
    • EXPLICIT_DYNAMIC
    • STATIC_LINEAR
    • STATIC_NONLINEAR
    • IMPLICIT_DYNAMIC
  2. 命令行增加:
    • --static-linear
    • --static-nonlinear
    • --implicit-newmark
    • --implicit-newmark-nonlinear
  3. 保留:
    • --implicit-linear 作为 --static-linear 兼容别名
    • --run 作为显式动力学运行入口
  4. INP 读取增加:
    • *STATIC
    • *CONTROLS 的 FemLite 子集
  5. 控制参数增加:
    • 最大增量数
    • 最大 Newton 迭代次数
    • 力残差容限
    • 位移修正容限
    • 是否允许步长缩减

验收条件:

  • 静力命令行和显式命令行互斥检查正确。
  • *STATIC 可被读取并进入静力分析流程。
  • 不支持的 Abaqus 静力参数 warning 后跳过。
  • 静力分析日志记录步长、增量、迭代和输出设置。

7. V3.2 实体线性静力

目标:

  • 将实体单元线性静力求解从最小流程提升为正式功能。

开发内容:

  1. 完善 C3D4 线性弹性刚度矩阵。
  2. 完善 C3D8 线性弹性刚度矩阵。
  3. 接入 C3D10、C3D20 线性弹性刚度矩阵。
  4. 支持 CLOAD、DLOAD、Dirichlet、Robin 和 MPC 在静力方程中的装配。
  5. 计算节点反力。
  6. 静力求解后恢复单元应力、应变和等效结果。
  7. 静力求解后写出 VTK 和 CSV。

验收条件:

  • C3D4/C3D8 patch test 通过。
  • C3D10/C3D20 小型线弹性静力算例通过。
  • 单轴拉伸静力位移与解析解误差满足容限。
  • 约束反力总和与外载平衡。

8. V3.3 壳线性静力

目标:

  • 补齐第三版最关键缺口:壳单元静力计算。

开发内容:

  1. 实现 S3 线性静力刚度。
  2. 实现 S4 线性静力刚度。
  3. 实现 S6 线性静力刚度。
  4. 实现 S8 线性静力刚度。
  5. 采用 Mindlin-Reissner 壳:
    • 膜刚度
    • 弯曲刚度
    • 横向剪切刚度
  6. 增加 drilling DOF 稳定处理。
  7. 处理壳单元转动自由度约束和反力矩输出。
  8. 补充 Scordelis-Lo 屋面壳体静力基准。
  9. 补充板壳弯曲静力基准。

验收条件:

  • S3/S4/S6/S8 壳静力 patch test 通过。
  • Scordelis-Lo 关键位移与参考结果在约定容限内。
  • 板壳弯曲基准位移趋势和数量级正确。
  • 壳静力 VTK 中位移、转角、应力和应变字段完整。

9. V3.4 非线性静力

目标:

  • 建立可用于弹塑性加载卸载的非线性静力框架。

开发内容:

  1. Newton-Raphson 主循环。
  2. 增量加载控制。
  3. 位移边界条件增量施加。
  4. 力残差和位移修正收敛准则。
  5. 失败回退和步长缩减。
  6. 小应变 J2 弹塑性静力路径。
  7. 大变形 Updated Lagrangian 静力路径。
  8. 实体 J2 算法切线,壳膜内/弯曲/剪切 section J2 算法切线。
  9. 材料状态 trial/commit 机制。

当前实现状态:

  • 已实现 fem_solve_static_nonlinear(max_increment, max_iter, tol, iter, res_norm, ierr)。
  • 已实现命令行 --static-nonlinear 入口。
  • 已实现按 *STATIC 时间控制分增量加载。
  • 当前残差由 CLOAD、DLOAD、Robin、MPC、SPH、contact 外力和内力共同构成。
  • 实体单元切线按积分点材料状态使用弹性/J2 算法切线;壳单元膜内、弯曲和横向剪切 section tangent 对 J2/J2_JC 使用当前积分点算法切线映射。
  • 已实现材料状态和单元删除标志的 trial/restore/commit 机制,非收敛时恢复到增量起点。
  • 已接入 Robin、MPC、刚性平面 penalty contact 和面-面 contact pair 的非线性切线。
  • 已覆盖弹性非线性退化、位移控制 J2 塑性状态更新和 trial rollback 测试。
  • 已实现 Newton 线搜索;可选步长缩减支持在非收敛时回退到增量起点并缩小当前增量。
  • 节点-面接触、接触输出统计和更高阶接触积分仍需继续完善。

验收条件:

  • 弹性非线性静力退化到线性静力结果。
  • 小应变 J2 弹塑性加载卸载曲线合理。
  • 大变形 J2 静力小算例无明显能量或残差异常。
  • Newton 收敛历史可输出。
  • 非收敛算例能明确返回错误或执行步长缩减。

10. V3.5 隐式 Newmark 动力学

目标:

  • 在静力 Newton 框架基础上形成隐式动力学基础能力。

开发内容:

  1. Newmark 参数控制。
  2. 位移、速度、加速度预测。
  3. 有效残差:
R = F_ext - F_int - C v - M a
  1. 有效切线:
K_eff = K_t + a0 M + a1 C
  1. Rayleigh 阻尼接入。
  2. 隐式动力输出与显式输出字段对齐。

当前实现状态:

  • 已实现 fem_advance_implicit_newmark(dt, max_iter, tol, iter, res_norm, ierr)。
  • 已实现 fem_run_implicit_newmark(max_iter, tol, iter_total, res_norm, ierr)。
  • 已实现 fem_advance_newmark_nonlinear(dt, max_iter, tol, iter, res_norm, ierr)。
  • 已实现 fem_run_newmark_nonlinear(max_iter, tol, iter_total, res_norm, ierr)。
  • 已实现命令行 --implicit-newmark 入口。
  • 已实现命令行 --implicit-newmark-nonlinear 入口。
  • 默认 Newmark 参数为 beta=0.25、gamma=0.5。
  • 当前有效刚度为 K_eff = K + a0 M + a1 C。
  • 已接入线性 Rayleigh 阻尼 C = alpha_M M + beta_K K。
  • 已提供 fem_set_rayleigh_damping(alpha_mass, beta_stiffness, ierr)。
  • 已覆盖 C3D4 单步隐式 Newmark 拉伸、Rayleigh 阻尼、非线性 Newmark 线弹性退化和 CLI 回归测试。
  • 已覆盖非线性 Newmark 中 Robin、MPC、刚性平面接触切线、面-面 contact pair 切线和失败后 trial rollback 的解析小算例。
  • 非线性 Newmark 对实体 J2 使用当前积分点算法切线;壳膜内、弯曲和横向剪切 section tangent 对 J2/J2_JC 使用当前积分点算法切线映射,更完整隐式动力基准仍需继续补充。
  • 已实现非线性 Newmark 线搜索;可选动态步长缩减在单步失败时恢复运动学量和材料 trial 状态后重试。

验收条件:

  • 单自由度弹簧质量系统与解析解或参考解一致。
  • 小型实体弹性波传播可运行。
  • 显式和隐式在小变形弹性小算例上趋势一致。
  • 隐式动力残差和迭代历史可输出。

11. V3.6 通用接触增强

目标:

  • 将第二版基础刚性平面接触扩展为可用于结构接触问题的通用框架。

开发内容:

  1. *SURFACE 输入子集。
  2. *CONTACT PAIR 输入子集。
  3. 接触面数据结构。
  4. 接触搜索,采用均匀空间网格和可选 OpenMP BVH 宽相搜索。
  5. 节点-面接触。
  6. 面-面接触框架。
  7. penalty 法默认接触力。
  8. 接触阻尼。
  9. 接触状态、接触力、最大穿透量和接触功输出。
  10. 接触接口与 SPH 耦合层保持分离。

当前实现状态:

  • 保留第二版刚性平面 penalty 接触路径。
  • 新增 contact_pair_slave/master/penalty/damping/search/friction 集中式数据库数组,可通过 elset、element id 或 ALL 指定接触对目标。
  • 面-面接触采用边界 facet 的当前构形、法向间隙和 penalty/damping 法向力映射;0.3.1 已从质心权重推进到 master 平面局部二维投影裁剪面积积分,并对重复 master 面做从面面积上限修正。
  • 0.3.2 已补充投影交叠域上的 mortar 形函数积分,面力和接触切线按 Ns、Nm 及其乘积积分分配到 slave/master 节点。
  • 0.3.2 支持基于接触对历史切向力的 Coulomb 粘滑判定,记录 stick/slip 计数、累计滑移和切向摩擦力历史。
  • 0.3.2 增加 master facet BVH 宽相搜索;启用 OpenMP 时按 slave facet 并行遍历 BVH,装配全局接触力/切线和摩擦历史时使用受保护临界区。
  • 0.3.1 新增全局和逐 contact pair 的激活数、最大穿透量、接触力范数和接触功估计统计;0.3.2 扩展 contact_step_xxxxx.csv 输出 stick/slip、累计滑移和切向力。
  • CSR 稀疏图案会为 contact pair 预留 slave-slave、slave-master、master-slave 和 master-master 切线块。
  • 已补充 contact pair 法向力、摩擦力、多 master 分摊、投影裁剪面积、mortar 权重、空间网格/BVH 分支、粘滑历史、接触统计和切线装配测试。
  • 当前仍未实现工程级 mortar 约束求解、摩擦正则化参数体系和大规模接触收敛控制。

验收条件:

  • 刚性平面接触第二版能力无回退。
  • 节点-面接触小算例通过。
  • 面-面接触框架可运行并输出接触状态。
  • 静力压入算例反力合理。
  • 动力接触冲击算例稳定运行。

12. V3.7 输出与接口

目标:

  • 让静力、非线性静力、隐式动力和接触结果可检查、可回归、可后处理。

开发内容:

  1. convergence.csv:
    • step
    • increment
    • iteration
    • residual_norm
    • correction_norm
    • converged
  2. reactions_step_xxxxx.csv:
    • node_id
    • rx_force
    • ry_force
    • rz_force
    • mx
    • my
    • mz
  3. contact_step_xxxxx.csv:
    • kind
    • pair_id
    • active_count
    • max_penetration
    • force_norm
    • work_estimate
    • cumulative_work
    • stick_count
    • slip_count
    • accumulated_slip
    • ftx, fty, ftz
  4. 静力 VTK 输出:
    • displacement
    • rotation
    • stress
    • strain
    • plastic strain
    • element status
  5. Fortran95 接口扩展:
    • fem_solve_static_linear
    • fem_solve_static_nonlinear
    • fem_advance_implicit_newmark
    • fem_advance_newmark_nonlinear
    • fem_run_newmark_nonlinear
    • fem_get_nodal_reactions
    • fem_get_convergence_status
    • fem_get_contact_summary
  6. C ABI 和 Python 调试接口跟随扩展。

验收条件:

  • 静力求解结束后自动写出 VTK 和 CSV。
  • 反力总和可用于外载平衡检查。
  • 收敛历史文件字段固定且可由 Python 脚本读取。
  • 接触输出能用于判断接触激活、最大穿透和接触功。

13. V3.8 测试、文档与验收

目标:

  • 完成第三版验收闭环。

开发内容:

  1. 更新六份核心手册至第三版实现状态。
  2. 更新 CTest 测试集合。
  3. 增加第三版 P0/P1/P2 测试分组。
  4. 增加示例和验证算例 README。
  5. 形成 0.3.0 验收报告。
  6. 更新版本号为 0.3.0。
  7. 发布前完成 Windows 和 Linux 构建验证。

验收条件:

  • 第一版和第二版测试无回退。
  • 第三版新增 P0/P1 全部通过。
  • P2 关键基准完成并形成记录。
  • 文档、命令行帮助、示例和实现一致。
  • 形成 0.3.0 验收报告。

14. 第三版测试策略

第三版测试必须保留第一版和第二版回归。

P0 测试:

  • 编译测试。
  • CSR 和线性求解器测试。
  • 实体线性静力小算例。
  • 壳线性静力小算例。
  • 静力反力平衡测试。
  • *STATIC 输入解析测试。
  • 静力 VTK/CSV 输出字段测试。

P1 测试:

  • 实体 patch test。
  • 壳 patch test。
  • 单轴拉伸静力。
  • 弹塑性静力加载卸载。
  • 隐式 Newmark 小算例。
  • 节点-面接触小算例。
  • Windows/Linux 构建测试。

P2 测试:

  • Scordelis-Lo 壳静力基准。
  • 板壳弯曲静力基准。
  • 简化接触静力压入。
  • 简化接触动力冲击。
  • 10000 节点/10000 单元静力或准静力性能测试。

15. 第三版完成准则

第三版完成必须满足:

  • 0.1.0 和 0.2.0 已验收能力无回退。
  • --static-linear 可用于实体和壳单元。
  • --static-nonlinear 可用于小型弹塑性静力算例。
  • --implicit-newmark 可运行小型隐式动力算例。
  • --implicit-newmark-nonlinear 可运行小型非线性 Newmark-Newton 骨架算例。
  • Scordelis-Lo 壳静力基准通过。
  • 通用接触基础算例通过。
  • 静力反力、收敛历史、接触输出和 VTK 输出完整。
  • Windows GCC、WSL gfortran 至少通过 P0/P1 测试。
  • Intel Fortran 兼容性完成检查或记录明确限制。
  • 形成 v3_acceptance_report.md 或等价验收报告。

16. 风险与控制

主要风险:

  • 壳单元静力刚度和显式壳内力路径不一致。
  • drilling DOF 稳定处理不当导致壳静力奇异或过硬。
  • 非线性静力状态提交和回滚不清晰。
  • 接触搜索和接触力可能导致 Newton 迭代不收敛。
  • 静力输出和显式输出字段不一致,增加后处理负担。
  • Fortran95 限制下接口数量增加,容易造成重复代码。

控制措施:

  • 先实现线性静力,再实现非线性静力。
  • 先实体,再壳;先 S4/S3,再 S6/S8。
  • Scordelis-Lo 作为壳静力主基准,分网格逐步验证。
  • 非线性静力先完成实体 J2 算法切线,再推进壳膜内塑性切线,0.3.1 补齐壳弯曲/剪切 section tangent 映射。
  • 接触先保留刚性平面和面-面框架,0.3.1 补充投影裁剪面积、多 master 面积上限、Coulomb 摩擦、均匀空间网格和接触输出,0.3.2 补充 mortar 形函数积分、粘滑历史和 OpenMP BVH 搜索。
  • 输出字段先冻结格式,再增加内容。
  • 每个阶段均保持 CTest 可通过。

17. 与后续版本的边界

第三版不强制完成:

  • 高性能外部稀疏求解器绑定。
  • 大规模并行接触域分解和负载均衡。
  • 完整摩擦接触模型。
  • 完整热传导求解。
  • 完整 Abaqus inp 全关键字兼容。
  • 大规模工程级隐式非线性性能优化。

这些内容可进入 0.4.0 或后续版本。