Files
FemLite/docs/v3_development_plan.md
T

463 lines
16 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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. 朴素接触搜索,后续再优化为空间网格或 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 facet 权重分摊。
- 0.3.1 支持基于相对切向速度的 Coulomb 摩擦力和切向近似切线。
- 0.3.1 增加 facet 中心/等效半径空间 broad-phase 过滤,减少明显不可能接触的 facet 对。
- CSR 稀疏图案会为 contact pair 预留 slave-slave、slave-master、master-slave 和 master-master 切线块。
- 已补充 contact pair 法向力、摩擦力、多 master 分摊和切线装配测试。
- 当前尚未实现严格 mortar 积分、精确面内投影裁剪、空间网格/BVH 加速、完整接触状态输出和工程级接触收敛控制。
验收条件:
- 刚性平面接触第二版能力无回退。
- 节点-面接触小算例通过。
- 面-面接触框架可运行并输出接触状态。
- 静力压入算例反力合理。
- 动力接触冲击算例稳定运行。
## 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`:
- contact_id
- node_id 或 facet_id
- penetration
- normal_force
- tangential_force
- contact_status
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 摩擦和空间 broad-phase,再继续推进节点-面、严格 mortar 和搜索加速。
- 输出字段先冻结格式,再增加内容。
- 每个阶段均保持 CTest 可通过。
## 17. 与后续版本的边界
第三版不强制完成:
- 高性能外部稀疏求解器绑定。
- 并行接触搜索。
- 完整摩擦接触模型。
- 完整热传导求解。
- 完整 Abaqus inp 全关键字兼容。
- 大规模工程级隐式非线性性能优化。
这些内容可进入 0.4.0 或后续版本。