9.6 KiB
9.6 KiB
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:第二版支持更完整的壳单元、接触和隐式非线性求解
- SHOULD:第二版支持 VTK 输出和 restart 能力
3. 应用场景
软件主要服务于以下场景:
- MUST:船体局部板架受爆炸冲击载荷作用下的瞬态响应分析
- MUST:船体结构与 SPH 流体/爆炸载荷程序之间的边界力交换
- MUST:实体结构模型的线弹性和弹塑性动力响应分析
- MUST:基础 S4 壳单元参与的板结构动力响应分析
- 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 约束方程
- 接触算法
- 隐式 Newmark + Newton 非线性求解
- CSR 全局矩阵格式
- VTK 结果输出
- restart 能力
5. 功能需求
5.1 物理模型
软件应支持:
- MUST:三维结构动力学
- MUST:线弹性
- MUST:弹塑性
- MUST:大变形分析框架
- MUST:小应变 J2 弹塑性作为可选材料更新方式
- MUST:大应变 J2 弹塑性作为可选材料更新方式
- MUST:材料失效与单元删除
- MUST:Johnson-Cook 应变率效应
- MUST:温度效应
- 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:隐式 Newmark + Newton 非线性求解
- SHOULD:CSR 作为隐式求解的主稀疏矩阵格式
- COULD:skyline 格式作为低优先级调试或小规模验证格式
- COULD:外部稀疏线性求解器接口
5.6 边界条件与载荷
第一版必须支持:
- MUST:Dirichlet 边界条件
- MUST:节点力
- MUST:面压力
- MUST:SPH 外力接口
第二版应支持:
- SHOULD:Robin 弹簧/阻尼边界
- SHOULD:MPC 约束方程
- 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 和错误位置
5.9 输出需求
第一版必须支持:
- MUST:日志输出
- MUST:CSV 历史量输出
- MUST:节点位移输出
- MUST:节点速度输出
- MUST:节点加速度输出
- MUST:单元应力输出
- MUST:单元应变输出
- MUST:单元塑性应变输出
- MUST:能量历史输出
第二版应支持:
- SHOULD:VTK 结果文件输出
- SHOULD:restart 文件输出与读取
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 后续阶段
后续可考虑:
- 并行计算
- 外部求解器
- 更丰富材料模型
- 更完整 Abaqus inp 兼容
- 后处理工具链
9. 第一版验收标准
第一版必须通过以下验收项:
- MUST:单元 patch test
- MUST:单轴拉伸
- MUST:弹塑性加载卸载
- MUST:弹性波传播
- MUST:板受压力脉冲
- MUST:简化 SPH-FEM 边界力传递接口
每个验收算例应至少包含:
- 输入文件
- 运行命令
- 参考结果
- 允许误差
- 日志检查项
- 回归测试判据