444 lines
12 KiB
Markdown
444 lines
12 KiB
Markdown
# 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 的双向信息交换
|
||
|
||
一次耦合步的基本流程为:
|
||
|
||
```text
|
||
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:第一版和第二版已验收测试无回退
|