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

444 lines
12 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.
# 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:第一版和第二版已验收测试无回退