9.4 KiB
9.4 KiB
FemLite 0.2.0 第二版开发计划
文档状态:第二版开发基线草稿
日期:2026-06-22
适用对象:FemLite 0.2.0 开发、评审、测试与阶段验收
1. 文档目的
本文档定义 FemLite 第二版的开发目标、阶段划分、技术路线、验收准则和风险控制。
第二版开发应以 0.1.0 第一版验收基线为起点,在不破坏第一版显式瞬态、实体单元、材料、INP 读取和 SPH 力接口能力的前提下,逐步扩展壳单元、二次实体、接触、隐式求解、CSR 稀疏矩阵、VTK、restart 和外部接口能力。
2. 版本定位
0.2.0 的定位:
- 保持 0.1.0 已验收能力稳定可回归。
- 完成第二版需求中的关键框架能力。
- 优先建立可扩展基础设施,再逐项加入复杂算法。
- 每个阶段都必须能编译、能测试、能回退定位。
0.2.0 不应一次性大改所有核心模块。涉及求解器、单元、状态变量和输出格式的变更应通过小步提交完成。
3. 第二版主要目标
第二版计划实现或完善:
- CSR 稀疏矩阵基础设施。
- 隐式线弹性小变形框架。
- 非线性增量迭代框架预留。
- C3D10、C3D20 二次实体单元。
- S3、S6、S8 壳单元。
- S4 壳单元能力完善。
- Robin 边界条件。
- MPC 约束方程。
- 接触基础框架。
- C ABI 包装层。
- Python 调试接口。
- VTK 结果输出。
- restart 基础能力。
- CI 或准 CI 本地脚本。
4. 开发分支与版本策略
推荐策略:
main保持已验收稳定版本。v0.1.0标签固定第一版验收基线。dev/v0.2作为第二版主开发分支。- 每个阶段完成后形成阶段提交。
- 发布 0.2.0 前从
dev/v0.2合并回main。
版本号约定:
- 开发中版本可保持
0.2.0-dev或在文档中标记为第二版开发版。 - 正式第二版验收后将代码常量更新为
0.2.0。 - 若需要中间可用版本,可使用
0.2.0-alpha.1、0.2.0-alpha.2等标签。
5. 阶段划分
第二版分为 6 个阶段。
| 阶段 | 名称 | 目标 | 阶段结果 |
|---|---|---|---|
| V2.1 | 基础设施整理 | 单元拓扑、积分规则、状态变量和测试结构升级 | 为二次单元、壳单元和隐式求解打基础 |
| V2.2 | CSR 与隐式线弹性 | CSR 矩阵、装配接口、线性求解接口、隐式小变形线弹性 | 可运行小型静力或准静力线弹性算例 |
| V2.3 | 二次实体单元 | C3D10、C3D20 形函数、积分、质量、内力、patch test | 二次实体单元通过基础验证 |
| V2.4 | 壳单元扩展 | S4 完善,新增 S3、S6、S8 | 壳单元压力、膜、弯曲和 patch test 通过 |
| V2.5 | 约束与接触 | Robin、MPC、基础接触搜索和接触力 | 简化接触冲击与约束测试通过 |
| V2.6 | 外部接口与输出 | C ABI、Python 调试接口、VTK、restart、CI | 第二版交付形态完整 |
6. V2.1 基础设施整理
目标:
- 建立统一单元拓扑查询接口。
- 建立统一积分点与权重接口。
- 将单元状态变量维度和高斯点数量从固定逻辑中解耦。
- 梳理显式、隐式共用的单元级数据接口。
- 扩展测试目录,区分第一版回归和第二版新增测试。
建议新增或整理模块:
src/element/fem_element_topology.f90src/element/fem_quadrature.f90src/element/fem_shape_functions.f90src/solver/fem_sparse_csr.f90占位或骨架tests/module中新增单元拓扑和积分规则测试
验收条件:
- 0.1.0 全部 CTest 继续通过。
- C3D4、C3D8、S4 原有路径不回退。
- 单元类型、节点数、面数、面节点、积分点数量可通过统一接口查询。
- 为 C3D10、C3D20、S3、S6、S8 预留清晰入口。
7. V2.2 CSR 与隐式线弹性
目标:
- 实现 CSR 矩阵存储和基础操作。
- 建立稀疏装配接口。
- 建立隐式求解器骨架。
- 第一阶段只实现小变形线弹性隐式路径。
- 外部线性求解器先不作为强依赖,可先实现内部简单 CG 或直接调试求解器。
建议实现内容:
- CSR pattern 构建。
- CSR 数值清零、累加、矩阵向量乘。
- Dirichlet 条件在 CSR 系统中的施加。
- 单元刚度矩阵装配接口。
- 隐式求解控制参数读取。
- 小型 C3D4/C3D8 线弹性静力或准静力验证算例。
验收条件:
- dense 仍只用于单元局部矩阵和调试。
- CSR 成为隐式主格式。
- 第一版显式求解路径不受影响。
- 至少一个小型线弹性隐式算例通过解析或手算验证。
8. V2.3 二次实体单元
目标:
- 实现 C3D10 和 C3D20。
- 支持质量、内力、应力更新、稳定步长估计和基础输出。
- 显式路径优先,隐式刚度可随后接入。
建议顺序:
- C3D10 形函数、导数、体积和 patch test。
- C3D10 集中质量和显式内力。
- C3D20 形函数、导数、积分和 patch test。
- C3D20 集中质量和显式内力。
- 二次单元 INP 读取和输出检查。
验收条件:
- C3D10、C3D20 通过形函数 Kronecker delta、partition of unity 和导数测试。
- C3D10、C3D20 通过基础 patch test。
- 单元质量守恒。
- 删除单元和 SPH facet 导出逻辑不被二次单元破坏。
9. V2.4 壳单元扩展
目标:
- 完善 S4 第一版有限能力实现。
- 新增 S3、S6、S8。
- 明确壳厚度、法向、转动自由度、剪切修正和积分规则。
建议顺序:
- 固化壳单元公共数据接口。
- 完善 S4 状态输出、压力载荷和基础塑性路径。
- 实现 S3 线性三角壳。
- 实现 S6 二次三角壳。
- 实现 S8 二次四边壳。
- 增加壳单元压力脉冲和 patch test 覆盖。
验收条件:
- S4 第一版测试继续通过。
- S3、S6、S8 至少覆盖膜、弯曲、横向剪切、压力载荷基础测试。
- 壳单元质量和转动惯量非负。
- 壳面 facet 可被 SPH 耦合层正确导出。
10. V2.5 约束与接触
目标:
- 实现 Robin 边界条件。
- 实现 MPC 约束方程基础能力。
- 实现接触基础框架。
接触第一阶段建议采用:
- 节点到面接触。
- penalty 法作为默认接触力方法。
- 显式接触优先。
- 接触搜索先使用简单网格或朴素搜索,后续再优化。
- 接触接口与 SPH 耦合层保持分离。
验收条件:
- Robin 边界在小型算例中通过手算验证。
- MPC 可约束节点自由度线性关系。
- 简化节点-刚性面或节点-壳面接触算例稳定运行。
- 接触力、接触能量或关键接触统计量可输出。
11. V2.6 外部接口与输出
目标:
- 增加 C ABI 包装层。
- 增加 Python 调试接口。
- 增加 VTK 输出。
- 增加 restart 基础能力。
- 增加 CI 或本地准 CI 脚本。
建议内容:
- C ABI 优先覆盖初始化、读入、建模、推进、取边界 facet、施加 SPH 力、取节点运动量和释放资源。
- Python 接口先用于调试和测试,不作为第一阶段高性能接口。
- VTK 优先输出节点位移、速度、加速度、单元应力、应变、塑性应变和删除状态。
- restart 优先支持显式求解从某一步继续。
- CI 第二版至少覆盖 Linux gfortran 构建和 CTest。
验收条件:
- C ABI 测试程序可独立调用核心流程。
- Python 调试脚本可运行一个小型算例并读取关键结果。
- VTK 文件可被 ParaView 打开并显示基础场量。
- restart 可从保存步继续并与连续计算关键历史量一致。
12. 第二版测试策略
第二版测试必须保留第一版回归。
每个阶段新增测试:
- V2.1:拓扑、积分、形函数、状态维度测试。
- V2.2:CSR 操作、装配、Dirichlet、隐式线弹性测试。
- V2.3:C3D10、C3D20 单元级和小型显式算例。
- V2.4:S3、S6、S8 壳单元测试和压力脉冲算例。
- V2.5:Robin、MPC、接触测试。
- V2.6:C ABI、Python、VTK、restart 测试。
第二版发布前必须通过:
- 第一版全部验收测试。
- 第二版新增 P0/P1 测试。
- Windows 和 Linux 至少完成构建检查。
- gfortran 为默认通过编译器。
- Intel Fortran 兼容性问题如未完全解决,必须形成限制说明。
13. 风险与控制
主要风险:
- 隐式求解和显式求解共享数据库时引入状态提交混乱。
- 二次单元增加高斯点数量后破坏旧状态数组假设。
- 壳单元转动自由度和实体单元平动自由度耦合不清。
- 接触算法可能影响显式稳定时间步。
- C ABI 和 Python 接口可能暴露内部编号与 Abaqus 原始编号不一致的问题。
- VTK/restart 输出可能引入较大文件或跨平台二进制兼容问题。
控制策略:
- 每个阶段先写最小测试,再接入完整流程。
- 保持第一版测试作为回归底线。
- CSR、接触、VTK、restart 均先实现最小可用版本。
- 新增全局数组必须明确初始化、释放和重置路径。
- 外部接口继续默认使用 Abaqus 原始编号。
- 大型输出和长算例结果不提交 git,只提交小型参考和抽样结果。
14. 第二版完成准则
FemLite 0.2.0 完成条件:
- 0.1.0 验收能力无回退。
- C3D10、C3D20、S3、S6、S8 基础能力通过测试。
- S4 能力比第一版明确增强,并有对应测试证明。
- CSR 隐式线弹性最小流程可运行。
- Robin、MPC、接触基础能力可运行并通过小型验证。
- C ABI、Python 调试接口、VTK 和 restart 至少具备最小可用能力。
- 文档、测试计划和接口说明更新到与实现一致。
- 形成
v0.2.0验收报告或发布说明。