# 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:隐式路径通过统一线性求解器分发层求解 CSR 方程,内部至少支持 CG、BiCGSTAB 和 GMRES。 - SHOULD:线性求解器支持 none/Jacobi 预条件选择,并可查询最近一次迭代数、残差和状态码。 - COULD:外部稀疏线性求解器后端作为可选适配,不作为默认构建强依赖。 - 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:第一版和第二版已验收测试无回退