Files
FemLite/docs/01_requirements_specification.md
shenw be02684827
FemLite CI / build-test (push) Has been cancelled
Release FemLite 0.3.0
2026-06-23 19:28:44 +08:00

12 KiB
Raw Permalink Blame History

FEM Software Requirements Specification

文档状态:需求基线草稿

适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序

1. 文档目的

本文档用于定义 FEM 软件模块的功能需求、非功能需求、输入输出要求、约束条件、阶段开发范围和阶段验收标准。

本文档将需求划分为四类:

  • MUST:第一版必须实现,作为第一阶段验收依据
  • SHOULD:第二版或第三版应实现,第一版架构需预留扩展能力
  • COULD:可选增强功能,不作为近期验收条件
  • OUT OF SCOPE:当前阶段明确不实现

2. 项目目标

本软件面向船舶接触爆炸问题中的船体结构响应分析,支持三维线弹性、弹塑性、瞬态动力学和后续静力学计算。

目标包括:

  • MUST:提供可被外部程序调用的 Fortran95 FEM 核心库
  • MUST:提供基于 Abaqus inp 文件的小型 FEM 分析程序
  • MUST:暴露与 SPH 方法进行边界耦合的力学接口
  • MUST:第一版支持显式瞬态动力学分析
  • MUST:第一版支持实体单元 C3D4、C3D8 和基础壳单元 S4
  • SHOULD:第二版支持更完整的壳单元、CSR、隐式线弹性最小流程、基础接触、VTK 和 restart 能力
  • SHOULD:第三版正式支持线性静力学、非线性静力学、壳单元静力学、隐式 Newmark + Newton 非线性动力学和通用接触
  • SHOULD:第二版支持 VTK 输出和 restart 能力

3. 应用场景

软件主要服务于以下场景:

  • MUST:船体局部板架受爆炸冲击载荷作用下的瞬态响应分析
  • MUST:船体结构与 SPH 流体/爆炸载荷程序之间的边界力交换
  • MUST:实体结构模型的线弹性和弹塑性动力响应分析
  • MUST:基础 S4 壳单元参与的板结构动力响应分析
  • SHOULD:壳-实体混合模型瞬态响应分析
  • SHOULD:接触冲击和复杂边界约束分析
  • SHOULD:线性静力和非线性静力分析
  • SHOULD:隐式非线性动力学增量迭代分析

4. 阶段范围

4.1 第一版范围

第一版必须完成:

  • 显式瞬态动力学求解
  • C3D4、C3D8、S4 单元
  • 线弹性材料
  • J2 von Mises 弹塑性材料
  • Abaqus inp 文件读取
  • Dirichlet 边界、节点力、面压力
  • SPH 外力接口
  • 日志输出、CSV 历史量输出、基本场变量输出
  • 第一版验收算例

4.2 第二版范围

第二版应完成最小可用工程扩展:

  • C3D10、C3D20、S3、S6、S8 单元
  • Robin 边界
  • MPC 约束方程
  • 基础 penalty 接触算法
  • 隐式线弹性小变形求解最小流程
  • CSR 全局矩阵格式
  • VTK 结果输出
  • restart 能力

4.3 第三版范围

第三版应正式完成静力学和隐式非线性主线:

  • 线性静力学求解
  • 非线性静力学求解
  • 壳单元线性静力刚度
  • Scordelis-Lo 等壳静力基准算例
  • 隐式 Newmark + Newton 非线性动力学框架
  • 实体和壳的弹塑性隐式路径
  • 通用接触搜索和节点-面、面-面接触框架
  • Newton 线搜索、失败回滚和可选步长缩减控制
  • 静力学反力、收敛历史和 VTK/CSV 输出

5. 功能需求

5.1 物理模型

软件应支持:

  • MUST:三维结构动力学
  • MUST:线弹性
  • MUST:弹塑性
  • MUST:大变形分析框架
  • MUST:小应变 J2 弹塑性作为可选材料更新方式
  • MUST:大应变 J2 弹塑性作为可选材料更新方式
  • MUST:材料失效与单元删除
  • MUST:Johnson-Cook 应变率效应
  • MUST:温度效应
  • SHOULD:线性静力学
  • SHOULD:非线性静力学
  • SHOULD:隐式非线性动力学增量迭代

说明:

  • 第一版默认求解器为显式瞬态动力学。
  • 弹塑性材料应允许用户选择小应变或大应变 J2 形式。
  • 材料失效、单元删除、应变率效应和温度效应属于船舶接触爆炸问题的核心需求,应在第一版需求中保留。

5.2 空间维度

  • MUST:支持三维结构有限元分析。

5.3 单元类型

第一版必须支持:

  • MUST:C3D4,四节点线性四面体实体单元
  • MUST:C3D8,八节点线性六面体实体单元
  • MUST:S4,四节点线性四边形壳单元

第二版应支持:

  • SHOULD:C3D10,十节点二次四面体实体单元
  • SHOULD:C3D20,二十节点二次六面体实体单元
  • SHOULD:S3,三节点线性三角形壳单元
  • SHOULD:S6,六节点二次三角形壳单元
  • SHOULD:S8,八节点二次四边形壳单元

5.4 材料模型

第一版必须支持:

  • MUST:各向同性材料
  • MUST:各向同性线弹性
  • MUST:J2 von Mises 弹塑性
  • MUST:理想弹塑性硬化模型
  • MUST:线性硬化模型
  • MUST:多段塑性曲线硬化模型
  • MUST:Johnson-Cook 流动应力
  • MUST:等效塑性应变阈值失效
  • MUST:Johnson-Cook 损伤失效
  • MUST:材料密度作为必填参数

第二版或后续版本可扩展:

  • SHOULD:热-力相关材料参数
  • COULD:各向异性材料

5.5 求解器与矩阵格式

第一版求解要求:

  • MUST:显式瞬态动力学作为默认求解器
  • MUST:显式求解采用集中质量矩阵
  • MUST:第一版暂不装配全局刚度矩阵
  • MUST:第一版通过单元内力累计形成全局内力向量
  • MUST:dense 矩阵仅用于单元局部矩阵和调试

第二版求解要求:

  • SHOULD:隐式线弹性小变形求解最小流程
  • SHOULD:CSR 作为隐式求解的主稀疏矩阵格式
  • COULD:skyline 格式作为低优先级调试或小规模验证格式
  • COULD:外部稀疏线性求解器接口

第三版求解要求:

  • SHOULD:线性静力学求解,方程形式为 K u = f
  • SHOULD:非线性静力学求解,方程形式为 R(u) = 0
  • SHOULD:隐式 Newmark + Newton 非线性动力学求解
  • SHOULD:载荷步、增量步、Newton 迭代、线搜索、收敛准则、失败回退和可选步长缩减控制
  • SHOULD:实体和壳单元均可参与线性静力学求解

5.6 边界条件与载荷

第一版必须支持:

  • MUST:Dirichlet 边界条件
  • MUST:节点力
  • MUST:面压力
  • MUST:SPH 外力接口

第二版应支持:

  • SHOULD:Robin 弹簧/阻尼边界
  • SHOULD:MPC 约束方程
  • SHOULD:基础接触边界

第三版应支持:

  • SHOULD:通用节点-面接触
  • SHOULD:通用面-面接触框架
  • SHOULD:接触对、接触面、接触状态、接触力和接触功输出

5.7 SPH-FEM 耦合接口

SPH-FEM 耦合必须满足:

  • MUST:SPH 可向 FEM 传递压力
  • MUST:SPH 可向 FEM 传递剪切力
  • MUST:SPH 可向 FEM 传递等效节点力
  • MUST:FEM 可导出边界 facet
  • MUST:边界 facet 可来自实体单元外表面
  • MUST:边界 facet 可来自壳单元表面
  • MUST:边界 facet 可来自指定 elset
  • MUST:固体外法向定义为 facet 正法向
  • MUST:压力正方向定义为受压为正
  • MUST:正应力正方向定义为受拉为正
  • MUST:时间步由 SPH 或外部耦合驱动器控制
  • MUST:每个时间步进行 FEM 与 SPH 的双向信息交换

一次耦合步的基本流程为:

FEM 导出边界 facet 坐标、速度、法向和面积
SPH 根据 FEM 边界状态计算压力、剪切力或节点力
FEM 接收 SPH 外力并形成外力向量
FEM 在给定时间步长内显式推进
FEM 更新边界状态并进入下一耦合步

5.8 Abaqus INP 输入兼容

第一版必须支持以下 Abaqus inp keyword:

  • MUST:*NODE
  • MUST:*ELEMENT
  • MUST:*NSET
  • MUST:*ELSET
  • MUST:*MATERIAL
  • MUST:*DENSITY
  • MUST:*ELASTIC
  • MUST:*PLASTIC
  • MUST:*SOLID SECTION
  • MUST:*SHELL SECTION
  • MUST:*BOUNDARY
  • MUST:*CLOAD
  • MUST:*DLOAD
  • MUST:*AMPLITUDE
  • MUST:*STEP
  • MUST:*DYNAMIC

集合生成要求:

  • MUST:支持 *NSET, GENERATE
  • MUST:支持 *ELSET, GENERATE

错误处理要求:

  • MUST:不支持的 keyword 默认 warning 后跳过
  • MUST:关键数据缺失时返回 error 并终止当前分析
  • MUST:输入解析日志应记录已识别 keyword、不支持 keyword 和错误位置

第三版应扩展支持以下 Abaqus inp keyword 或其 FemLite 子集:

  • SHOULD:*STATIC
  • SHOULD:*CONTROLS
  • SHOULD:*SURFACE
  • SHOULD:*CONTACT PAIR
  • SHOULD:*TIE
  • SHOULD:*OUTPUT
  • SHOULD:*NODE PRINT
  • SHOULD:*EL PRINT
  • SHOULD:*NODE FILE
  • SHOULD:*EL FILE

5.9 输出需求

第一版必须支持:

  • MUST:日志输出
  • MUST:CSV 历史量输出
  • MUST:节点位移输出
  • MUST:节点速度输出
  • MUST:节点加速度输出
  • MUST:单元应力输出
  • MUST:单元应变输出
  • MUST:单元塑性应变输出
  • MUST:能量历史输出

第二版应支持:

  • SHOULD:VTK 结果文件输出
  • SHOULD:restart 文件输出与读取

第三版静力学输出应支持:

  • SHOULD:静力步和增量历史
  • SHOULD:Newton 残差范数和迭代次数
  • SHOULD:节点反力
  • SHOULD:静力 VTK 结果
  • SHOULD:静力 CSV 历史量

5.10 错误诊断

软件应诊断并报告:

  • MUST:输入文件不存在或不可读
  • MUST:不支持的单元类型
  • MUST:缺失材料定义
  • MUST:缺失密度
  • MUST:非法材料参数
  • MUST:退化单元或负 Jacobian
  • MUST:非法边界自由度
  • MUST:时间步非法
  • MUST:SPH 耦合接口参数非法

6. 非功能需求

6.1 语言与编译

  • MUST:采用 Fortran95
  • MUST:采用非面向对象过程式编程风格
  • MUST:默认支持 gfortran
  • MUST:兼容 Intel Fortran
  • MUST:采用 CMake 构建系统

6.2 平台

  • MUST:支持 Windows
  • MUST:支持 Linux

6.3 性能目标

第一版性能目标:

  • MUST:目标节点数 10000
  • MUST:目标单元数 10000
  • MUST:目标时间步数 10000
  • MUST:第一版不要求并行
  • MUST:第一版不要求 OpenMP

后续性能扩展:

  • COULD:OpenMP 并行
  • COULD:更大规模模型
  • COULD:外部高性能稀疏求解器

6.4 鲁棒性

  • MUST:不支持 keyword 不应导致程序异常崩溃
  • MUST:关键数据错误应给出明确错误信息
  • MUST:显式时间积分应检查时间步合法性
  • MUST:单元删除后求解流程应保持数组和状态变量一致

7. 约束与假设

  • MUST:软件不内置单位转换,输入文件、材料参数和 SPH 耦合数据必须采用一致单位制
  • MUST:第一版不追求完整 Abaqus 兼容,仅支持本文列出的 keyword 子集
  • MUST:第一版以显式动力学为默认分析流程
  • MUST:第一版不装配全局刚度矩阵
  • MUST:所有外部接口以 Fortran95 可表达的数组和标量参数为主
  • SHOULD:后续如需 C/C++/Python 调用,可增加薄包装层

8. 开发阶段划分

8.1 第一阶段

第一阶段目标是形成可运行的显式动力学 FEM 原型:

  • INP 读取与模型数据库
  • C3D4、C3D8、S4 单元
  • 线弹性与 J2 弹塑性
  • 大变形分析框架
  • 集中质量显式动力学
  • Dirichlet、节点力、面压力
  • SPH 外力接口
  • CSV 与日志输出
  • 第一版验收算例

8.2 第二阶段

第二阶段目标是扩展工程分析能力:

  • 二次实体单元
  • 更多壳单元
  • 基础接触
  • Robin 和 MPC
  • 隐式线弹性最小流程
  • CSR 稀疏矩阵
  • VTK 输出
  • restart

8.3 第三阶段

第三阶段目标是形成可验收的静力学和隐式非线性能力:

  • 线性静力和非线性静力求解
  • 实体单元和壳单元静力刚度
  • Scordelis-Lo 壳静力基准
  • 隐式 Newmark + Newton 动力学
  • 通用接触搜索与接触输出
  • 静力学反力和收敛历史输出
  • 第三版验收算例和回归测试

8.4 后续阶段

后续可考虑:

  • 并行计算
  • 外部求解器
  • 更丰富材料模型
  • 更完整 Abaqus inp 兼容
  • 后处理工具链

9. 第一版验收标准

第一版必须通过以下验收项:

  • MUST:单元 patch test
  • MUST:单轴拉伸
  • MUST:弹塑性加载卸载
  • MUST:弹性波传播
  • MUST:板受压力脉冲
  • MUST:简化 SPH-FEM 边界力传递接口

每个验收算例应至少包含:

  • 输入文件
  • 运行命令
  • 参考结果
  • 允许误差
  • 日志检查项
  • 回归测试判据

10. 第三版验收标准

第三版必须通过以下验收项:

  • SHOULD:实体单元线弹性静力 patch test
  • SHOULD:实体单元单轴拉伸静力
  • SHOULD:实体单元 J2 弹塑性静力加载卸载
  • SHOULD:Scordelis-Lo 壳静力基准
  • SHOULD:板壳弯曲静力基准
  • SHOULD:隐式动力弹性波
  • SHOULD:简化接触静力压入
  • SHOULD:简化接触动力冲击
  • SHOULD:第一版和第二版已验收测试无回退