19 KiB
19 KiB
FemLite 0.3.x 第三版开发计划与维护记录
文档状态:第三版开发与 0.3.3 阶段验收记录
日期:2026-06-24
适用对象:FemLite 0.3.0 至 0.3.3 开发、评审、测试与阶段验收
1. 文档目的
本文档定义 FemLite 第三版的开发目标、阶段划分、技术路线、验收准则和风险控制。
第三版以 0.2.0 第二版最小可用/阶段验收版为起点,在不破坏第一版显式动力学和第二版框架能力的前提下,正式补齐静力学计算、壳单元静力、隐式非线性和通用接触能力。
2. 第三版定位
FemLite 0.3.x 定位为:
线性/非线性静力学 + 壳静力基准 + 隐式非线性动力学基础 + 通用接触增强版
第三版不是简单增加示例算例,而是把 0.2.0 中的最小可用框架推进到可工程验收的求解能力。
第三版核心目标:
- 正式支持线性静力学计算。
- 正式支持非线性静力学计算。
- 补齐实体单元和壳单元静力刚度。
- 让 Scordelis-Lo 屋面壳体成为可验收的壳静力基准。
- 建立隐式 Newmark + Newton 非线性动力学框架。
- 增强通用接触搜索、节点-面接触和面-面接触框架。
- 输出静力学反力、收敛历史、接触状态和 VTK/CSV 结果。
第三版工程约束:
- 普通过程/函数尽量不超过 100 行,超过 128 行必须登记审查理由和后续拆分方向。
- 源文件尽量不超过 1500 行,超过 2000 行必须审查是否拆分。
source_sizeCTest 作为本地回归检查项,硬阈值例外记录在tests/source_size_exceptions.txt。
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。 - 0.3.1 和 0.3.2 用于接触、壳塑性切线和接触输出增强。
- 0.3.3 用于 Abaqus contact/surface 输入子集、示例 smoke、源码规模门禁、多编译器兼容性和发布整理。
- 发布前更新
v3_acceptance_report.md,并确认 CMake 版本和 Fortran 版本常量一致。
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.x 验收版 |
6. V3.1 静力学控制与输入
目标:
- 将静力学作为正式求解类型,而不是隐式线弹性调试入口。
- 保持
--implicit-linear兼容,同时新增清晰命令行。
开发内容:
- 增加分析类型控制:
EXPLICIT_DYNAMICSTATIC_LINEARSTATIC_NONLINEARIMPLICIT_DYNAMIC
- 命令行增加:
--static-linear--static-nonlinear--implicit-newmark--implicit-newmark-nonlinear
- 保留:
--implicit-linear作为--static-linear兼容别名--run作为显式动力学运行入口
- INP 读取增加:
*STATIC*CONTROLS的 FemLite 子集
- 控制参数增加:
- 最大增量数
- 最大 Newton 迭代次数
- 力残差容限
- 位移修正容限
- 是否允许步长缩减
验收条件:
- 静力命令行和显式命令行互斥检查正确。
*STATIC可被读取并进入静力分析流程。- 不支持的 Abaqus 静力参数 warning 后跳过。
- 静力分析日志记录步长、增量、迭代和输出设置。
7. V3.2 实体线性静力
目标:
- 将实体单元线性静力求解从最小流程提升为正式功能。
开发内容:
- 完善 C3D4 线性弹性刚度矩阵。
- 完善 C3D8 线性弹性刚度矩阵。
- 接入 C3D10、C3D20 线性弹性刚度矩阵。
- 支持 CLOAD、DLOAD、Dirichlet、Robin 和 MPC 在静力方程中的装配。
- 计算节点反力。
- 静力求解后恢复单元应力、应变和等效结果。
- 静力求解后写出 VTK 和 CSV。
验收条件:
- C3D4/C3D8 patch test 通过。
- C3D10/C3D20 小型线弹性静力算例通过。
- 单轴拉伸静力位移与解析解误差满足容限。
- 约束反力总和与外载平衡。
8. V3.3 壳线性静力
目标:
- 补齐第三版最关键缺口:壳单元静力计算。
开发内容:
- 实现 S3 线性静力刚度。
- 实现 S4 线性静力刚度。
- 实现 S6 线性静力刚度。
- 实现 S8 线性静力刚度。
- 采用 Mindlin-Reissner 壳:
- 膜刚度
- 弯曲刚度
- 横向剪切刚度
- 增加 drilling DOF 稳定处理。
- 处理壳单元转动自由度约束和反力矩输出。
- 补充 Scordelis-Lo 屋面壳体静力基准。
- 补充板壳弯曲静力基准。
验收条件:
- S3/S4/S6/S8 壳静力 patch test 通过。
- Scordelis-Lo 关键位移与参考结果在约定容限内。
- 板壳弯曲基准位移趋势和数量级正确。
- 壳静力 VTK 中位移、转角、应力和应变字段完整。
9. V3.4 非线性静力
目标:
- 建立可用于弹塑性加载卸载的非线性静力框架。
开发内容:
- Newton-Raphson 主循环。
- 增量加载控制。
- 位移边界条件增量施加。
- 力残差和位移修正收敛准则。
- 失败回退和步长缩减。
- 小应变 J2 弹塑性静力路径。
- 大变形 Updated Lagrangian 静力路径。
- 实体 J2 算法切线,壳膜内/弯曲/剪切 section J2 算法切线。
- 材料状态 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 框架基础上形成隐式动力学基础能力。
开发内容:
- Newmark 参数控制。
- 位移、速度、加速度预测。
- 有效残差:
R = F_ext - F_int - C v - M a
- 有效切线:
K_eff = K_t + a0 M + a1 C
- Rayleigh 阻尼接入。
- 隐式动力输出与显式输出字段对齐。
当前实现状态:
- 已实现
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 通用接触增强
目标:
- 将第二版基础刚性平面接触扩展为可用于结构接触问题的通用框架。
开发内容:
*SURFACE输入子集。*CONTACT PAIR输入子集。- 接触面数据结构。
- 接触搜索,采用均匀空间网格和可选 OpenMP BVH 宽相搜索。
- 节点-面接触。
- 面-面接触框架。
- penalty 法默认接触力。
- 接触阻尼。
- 接触状态、接触力、最大穿透量和接触功输出。
- 接触接口与 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_XXXXXXXX.csv输出 stick/slip、累计滑移和切向力。 - CSR 稀疏图案会为 contact pair 预留 slave-slave、slave-master、master-slave 和 master-master 切线块。
- 0.3.3 支持
*SURFACE, NAME=..., TYPE=ELEMENT输入子集,TYPE可省略或显式为ELEMENT;surface 数据行可混合引用 element id 和 elset,可省略 face label,并使用S1/F1/FACE1等 face label 筛选实际候选 facet;支持同名 surface 的OP=ADD/NEW,壳单元SPOS/SNEG当前匹配其单一 shell facet,并在 contact pair 中用于 master 法向翻转和 slave 侧向朝向筛选。 - 0.3.3 支持 Abaqus 常见的数据行式
*CONTACT PAIR子集:header 给出 penalty/damping/search/friction,下一行给出 slave/master surface。 - 0.3.3 已将接触状态统计、接触目标/面筛选、几何/投影/mortar 积分、空间搜索/BVH、Coulomb 粘滑摩擦历史、contact pair 力路径、contact pair 切线路径和接触 CSV 字段访问分别拆分到
fem_contact_state、fem_contact_target、fem_contact_geometry、fem_contact_search、fem_contact_friction、fem_contact_force、fem_contact_tangent与fem_contact_output模块;fem_contact主模块仅保留公开入口和刚性平面 penalty 接触路径。 - 已补充 contact pair header 解析、surface 数据行式解析、混合 surface target、省略 face label、非法 surface TYPE、surface
OP=ADD/NEW、shellSPOS/SNEG法向语义、法向力、摩擦力、多 master 分摊、投影裁剪面积、mortar 权重、空间网格/BVH 分支、粘滑历史、接触统计和切线装配测试。 - 0.3.3 已接入
example_smokeCTest 分组,覆盖 shell patch S3/S4、pressure pulse S4 和 rigid sphere impact S3/S4 的短步数回归,其中刚球冲击 smoke 会检查最终 contact CSV 的 active contact。 - 当前仍未实现完整 Abaqus
*SURFACE变体、复杂 surface 布尔/生成操作、node-based surface、analytic rigid surface、工程级 mortar 约束求解、摩擦正则化参数体系和大规模接触收敛控制;这些内容后续版本继续推进。
验收条件:
- 刚性平面接触第二版能力无回退。
- 节点-面接触小算例通过。
- 面-面接触框架可运行并输出接触状态。
- 静力压入算例反力合理。
- 动力接触冲击算例稳定运行。
12. V3.7 输出与接口
目标:
- 让静力、非线性静力、隐式动力和接触结果可检查、可回归、可后处理。
开发内容:
convergence.csv:- step
- increment
- iteration
- residual_norm
- correction_norm
- converged
reactions_step_xxxxx.csv:- node_id
- rx_force
- ry_force
- rz_force
- mx
- my
- mz
contact_XXXXXXXX.csv:- kind
- pair_id
- active_count
- max_penetration
- force_norm
- work_estimate
- cumulative_work
- stick_count
- slip_count
- accumulated_slip
- ftx, fty, ftz
- 静力 VTK 输出:
- displacement
- rotation
- stress
- strain
- plastic strain
- element status
- Fortran95 接口扩展:
fem_solve_static_linearfem_solve_static_nonlinearfem_advance_implicit_newmarkfem_advance_newmark_nonlinearfem_run_newmark_nonlinearfem_get_nodal_reactionsfem_get_convergence_statusfem_get_contact_summary
- C ABI 和 Python 调试接口跟随扩展。
验收条件:
- 静力求解结束后自动写出 VTK 和 CSV。
- 反力总和可用于外载平衡检查。
- 收敛历史文件字段固定且可由 Python 脚本读取。
- 接触输出能用于判断接触激活、最大穿透和接触功。
13. V3.8 测试、文档与验收
目标:
- 完成第三版验收闭环。
开发内容:
- 更新六份核心手册至第三版实现状态。
- 更新 CTest 测试集合。
- 增加第三版 P0/P1/P2 测试分组。
- 增加示例和验证算例 README。
- 形成 0.3.x 验收报告。
- 更新版本号并确认 CMake 与 Fortran 常量一致。
- 发布前完成 Windows 和 Linux 构建验证。
验收条件:
- 第一版和第二版测试无回退。
- 第三版新增 P0/P1 全部通过。
- P2 关键基准完成并形成记录。
- 文档、命令行帮助、示例和实现一致。
- 形成 0.3.x 验收报告。
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 测试。
- Windows Intel oneAPI
ifx2026.0 + MSVCcl19.44 已完成本地构建与 CTest 33/33 兼容性检查,并清理 Intel/NMake/machine:x64ifx warning。 - 形成
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 或后续版本。