# FemLite 0.3.0 第三版开发计划 文档状态:第三版开发基线草稿 日期:2026-06-23 适用对象:FemLite 0.3.0 开发、评审、测试与阶段验收 ## 1. 文档目的 本文档定义 FemLite 第三版的开发目标、阶段划分、技术路线、验收准则和风险控制。 第三版以 0.2.0 第二版最小可用/阶段验收版为起点,在不破坏第一版显式动力学和第二版框架能力的前提下,正式补齐静力学计算、壳单元静力、隐式非线性和通用接触能力。 ## 2. 第三版定位 FemLite 0.3.0 定位为: ```text 线性/非线性静力学 + 壳静力基准 + 隐式非线性动力学基础 + 通用接触增强版 ``` 第三版不是简单增加示例算例,而是把 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. 有效残差: ```text R = F_ext - F_int - C v - M a ``` 4. 有效切线: ```text K_eff = K_t + a0 M + a1 C ``` 5. Rayleigh 阻尼接入。 6. 隐式动力输出与显式输出字段对齐。 当前实现状态: - 已实现 `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 或后续版本。