Add initial FEM documentation skeletons

This commit is contained in:
shenw
2026-06-22 12:43:41 +08:00
commit 1cc1ce24a8
6 changed files with 915 additions and 0 deletions
+139
View File
@@ -0,0 +1,139 @@
# FEM Software Requirements Specification
文档状态:草稿
适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序
## 1. 文档目的
本文档用于定义 FEM 软件模块的功能需求、非功能需求、输入输出要求、约束条件和第一阶段开发范围。
待补充:
- 需求来源与适用项目
- 需求优先级规则
- 验收准则
## 2. 项目目标
本软件面向船舶接触爆炸问题中的船体结构响应分析,支持三维线弹性、弹塑性和瞬态动力学计算。
目标包括:
- 提供可被外部程序调用的 Fortran95 FEM 核心库
- 提供基于 Abaqus inp 文件的小型 FEM 分析程序
- 暴露与 SPH 方法进行边界耦合的接口
- 支持后续扩展接触、壳单元、实体单元和非线性求解能力
## 3. 应用场景
待补充:
- 船体局部板架受爆炸冲击
- 船体结构与 SPH 流体/爆炸载荷耦合
- 壳-实体混合模型瞬态响应
- 弹塑性变形与接触冲击分析
## 4. 功能需求
### 4.1 物理模型
待补充:
- 线弹性
- 弹塑性
- 瞬态动力学
- 非线性增量迭代
### 4.2 空间维度
软件应支持三维结构有限元分析。
### 4.3 单元类型
待补充:
- 三角形壳单元
- 四边形壳单元
- 四面体实体单元
- 六面体实体单元
- 线性单元
- 二次单元
### 4.4 材料模型
待补充:
- 各向同性线弹性材料
- 各向同性 J2 弹塑性材料
- 密度、弹性参数、屈服参数和硬化参数定义
### 4.5 边界条件与载荷
待补充:
- Dirichlet 边界
- Neumann 边界
- Robin 边界
- 接触边界
- 约束方程
- SPH 边界耦合载荷
### 4.6 求解类型
待补充:
- 默认显式瞬态动力学
- 可选隐式瞬态动力学
- 非线性增量迭代
### 4.7 输入输出
待补充:
- Abaqus inp 输入子集
- 日志输出
- 结果输出
- 重启动文件
- 错误诊断信息
## 5. 非功能需求
待补充:
- Fortran95 兼容性
- Windows/Linux 平台
- 编译器兼容性
- 计算规模目标
- 内存使用目标
- 数值稳定性要求
- 鲁棒性要求
## 6. 约束与假设
待补充:
- 非面向对象 Fortran95 编程
- 第一阶段不追求完整 Abaqus 兼容
- 默认采用一致单位制,由用户输入保证
- 第一阶段优先支持显式动力学
## 7. 开发阶段划分
待补充:
- 原型阶段
- 核心算法阶段
- INP 驱动程序阶段
- SPH 耦合阶段
- 验证与发布阶段
## 8. 验收标准
待补充:
- 支持的输入样例
- 必须通过的基准算例
- 接口调用测试
- 回归测试要求
+130
View File
@@ -0,0 +1,130 @@
# FEM Software Architecture Design
文档状态:草稿
适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序
## 1. 文档目的
本文档描述 FEM 软件的整体架构、模块划分、数据流、控制流、外部接口和扩展策略。
## 2. 架构目标
待补充:
- 核心库与小型主程序分离
- 显式动力学优先
- 保留隐式非线性扩展路径
- 支持 Abaqus inp 输入
- 支持 SPH-FEM 边界耦合
- 采用 Fortran95 过程式模块组织
## 3. 总体分层
建议分层:
- 输入层:Abaqus inp 读取与模型构造
- 核心 FEM 层:网格、材料、单元、边界、接触、耦合
- 求解层:显式动力学、隐式非线性、稀疏矩阵与外部求解器接口
- 输出层:日志、结果文件、诊断信息、重启动数据
待讨论:
- 是否需要独立 preprocessing 层
- 是否需要独立 restart 层
- 输出格式优先级
## 4. 模块划分
初步模块:
- fem_precision.f90
- fem_control.f90
- fem_database.f90
- fem_inp_reader.f90
- fem_shape_solid.f90
- fem_shape_shell.f90
- fem_quadrature.f90
- fem_material_iso.f90
- fem_element_solid.f90
- fem_element_shell.f90
- fem_assembly.f90
- fem_boundary.f90
- fem_constraint.f90
- fem_contact.f90
- fem_sph_coupling.f90
- fem_solver_explicit.f90
- fem_solver_implicit.f90
- fem_sparse_csr.f90
- fem_program.f90
待补充:
- 每个模块的职责边界
- 模块依赖关系
- 禁止出现的循环依赖
## 5. 核心数据流
待补充:
```text
Abaqus inp
-> inp reader
-> mesh/material/section/boundary database
-> dof numbering
-> mass initialization
-> time integration loop
-> element stress/internal force update
-> boundary/contact/SPH force update
-> result output
```
## 6. 求解控制流
待补充:
- 显式中心差分控制流
- 隐式 Newmark + Newton 控制流
- 非线性状态变量更新时机
- 输出与重启动时机
## 7. SPH-FEM 耦合架构
待补充:
- FEM 边界 facet 导出
- 边界坐标、速度、法向、面积交换
- SPH 压力/剪切/节点力导入
- 时间步同步策略
- 错误码和耦合状态管理
## 8. 错误处理与日志
待补充:
- 错误级别
- 错误码范围
- 日志格式
- 不支持 keyword 的处理策略
## 9. 扩展策略
待补充:
- 添加新单元
- 添加新材料
- 添加新边界条件
- 添加新输入 keyword
- 接入外部线性求解器
## 10. 构建与部署架构
待补充:
- 静态库
- 动态库
- 小型命令行程序
- 测试程序
- 示例算例目录
+208
View File
@@ -0,0 +1,208 @@
# FEM Detailed Design
文档状态:草稿
适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序
## 1. 文档目的
本文档给出各 Fortran95 模块的数据结构、子程序接口、调用顺序和实现细节,用于直接指导编码。
## 2. 设计原则
待补充:
- 过程式 Fortran95
- 模块化组织
- 全局数据库集中管理
- 单元例程局部化
- 求解器与单元实现解耦
- 输入解析与计算核心解耦
## 3. 全局精度与常量模块
模块:fem_precision.f90
待补充:
- real kind 定义
- integer kind 定义
- 常用常量
- 容差参数
## 4. 控制参数模块
模块:fem_control.f90
待补充:
- 时间步控制
- 求解器类型
- 输出控制
- 非线性迭代控制
- 接触控制
- SPH 耦合控制
## 5. 数据库模块
模块:fem_database.f90
待补充:
- 节点数组
- 单元数组
- 自由度编号
- 材料表
- 截面表
- 边界条件表
- 状态变量表
- 全局向量
初步自由度约定:
```text
1 UX
2 UY
3 UZ
4 RX
5 RY
6 RZ
```
## 6. INP 读取模块
模块:fem_inp_reader.f90
待补充:
- 支持 keyword
- 不支持 keyword 处理
- 集合解析
- 材料解析
- step 解析
- 错误恢复策略
## 7. 形函数与积分模块
模块:
- fem_shape_solid.f90
- fem_shape_shell.f90
- fem_quadrature.f90
待补充:
- 单元自然坐标
- 形函数接口
- 导数接口
- Jacobian 计算
- 积分点与权重
## 8. 材料模块
模块:fem_material_iso.f90
待补充:
- 线弹性更新
- J2 弹塑性返回映射
- 状态变量定义
- 一致切线或算法切线
- 波速估计
## 9. 实体单元模块
模块:fem_element_solid.f90
待补充:
- 单元质量
- 单元内力
- 单元刚度
- 应力更新
- 稳定时间步估计
- C3D4/C3D10/C3D8/C3D20 支持计划
## 10. 壳单元模块
模块:fem_element_shell.f90
待补充:
- 壳截面
- 膜应变
- 弯曲应变
- 横向剪切
- 厚度积分
- 剪切锁死处理
- hourglass 控制
## 11. 边界、约束与接触模块
模块:
- fem_boundary.f90
- fem_constraint.f90
- fem_contact.f90
待补充:
- Dirichlet 处理
- Neumann 处理
- Robin 处理
- MPC 处理
- penalty 接触
- 接触搜索接口
## 12. SPH 耦合模块
模块:fem_sph_coupling.f90
待补充:
- 边界 facet 数据结构
- FEM 状态导出接口
- SPH 载荷导入接口
- 节点力映射
- 时间同步约定
## 13. 求解器模块
模块:
- fem_solver_explicit.f90
- fem_solver_implicit.f90
待补充:
- 显式初始化
- 显式单步推进
- 稳定时间步估计
- 隐式残差组装
- Newton 迭代
- 收敛准则
## 14. 稀疏矩阵模块
模块:fem_sparse_csr.f90
待补充:
- CSR 存储
- 稀疏结构构造
- 装配接口
- 矩阵向量乘
- 外部求解器接口
## 15. 主程序模块
模块:fem_program.f90
待补充:
- 命令行参数
- inp 文件读取
- 求解流程
- 输出流程
- 返回码
@@ -0,0 +1,160 @@
# FEM Mathematical Model and Algorithms
文档状态:草稿
适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序
## 1. 文档目的
本文档说明软件采用的控制方程、有限元离散、材料算法、时间积分、接触算法和 SPH-FEM 耦合算法。
## 2. 控制方程
待补充:
- 动量守恒方程
- 初始条件
- 位移边界
- 力边界
- 接触边界
- SPH 耦合边界
离散后基本方程:
```text
M a + C v + F_int(u, state) = F_ext + F_contact + F_sph
```
## 3. 弱式形式
待补充:
- 虚功原理
- 内力项
- 外力项
- 惯性项
- 阻尼项
- 接触和耦合边界贡献
## 4. 空间离散
待补充:
- 位移插值
- 应变-位移矩阵
- 实体单元离散
- 壳单元离散
- 节点自由度定义
## 5. 质量矩阵与阻尼
待补充:
- 一致质量矩阵
- 集中质量矩阵
- Rayleigh 阻尼
- 边界阻尼
- 显式动力学质量处理
## 6. 显式中心差分算法
待补充:
- 速度半步更新
- 位移整步更新
- 加速度计算
- 边界条件施加
- 稳定时间步限制
## 7. 隐式 Newmark 算法
待补充:
- Newmark 参数
- 有效刚度
- 有效残差
- Newton-Raphson 迭代
- 收敛准则
## 8. 实体单元算法
待补充:
- C3D4
- C3D10
- C3D8
- C3D20
- 形函数
- 数值积分
- Jacobian
- 内力和刚度
## 9. 壳单元算法
待补充:
- Reissner-Mindlin 壳理论
- 三角形壳
- 四边形壳
- 膜应变
- 弯曲应变
- 横向剪切
- 厚度积分
- 锁死控制
## 10. 材料算法
待补充:
- 各向同性线弹性
- J2 屈服函数
- 关联流动法则
- 各向同性硬化
- 径向返回映射
- 状态变量更新
- 算法切线
## 11. 接触算法
待补充:
- penalty 接触
- 接触法向
- 穿透量计算
- 接触力计算
- 接触阻尼
- 时间步限制
## 12. SPH-FEM 耦合算法
待补充:
- 边界 facet 构造
- FEM 边界运动学量导出
- SPH 压力映射
- 剪切力映射
- 节点等效力积分
- 显式时间同步
## 13. 稳定性与误差控制
待补充:
- 临界时间步
- 材料波速
- 单元特征长度
- 退化单元检测
- 能量平衡检查
## 14. 数值验证算例
待补充:
- patch test
- 单轴拉伸
- 悬臂梁
- 自由振动
- 弹性波传播
- 板受冲击
- SPH-FEM 耦合压力传递
+144
View File
@@ -0,0 +1,144 @@
# FEM Interface Control Document
文档状态:草稿
适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序
## 1. 文档目的
本文档定义 FEM 核心库对外暴露的调用接口、数据交换约定、错误码、单位制和 SPH-FEM 耦合接口。
## 2. 接口设计原则
待补充:
- Fortran95 数组接口
- 不依赖面向对象特性
- 调用者不直接访问内部数据库
- 通过错误码返回状态
- 一致单位制由调用者保证
## 3. 库生命周期接口
待补充:
```fortran
subroutine fem_initialize(ierr)
subroutine fem_finalize(ierr)
```
## 4. 模型输入接口
待补充:
```fortran
subroutine fem_read_inp(filename, ierr)
subroutine fem_build_model(ierr)
```
待讨论:
- filename 字符串长度约定
- 多 step inp 文件处理方式
- 不支持 keyword 的返回策略
## 5. 求解控制接口
待补充:
```fortran
subroutine fem_set_time_step(dt, ierr)
subroutine fem_estimate_stable_dt(dtcrit, ierr)
subroutine fem_advance_explicit(dt, ierr)
subroutine fem_solve_current_step(ierr)
```
## 6. 结果查询接口
待补充:
```fortran
subroutine fem_get_nodal_displacement(nnode, node_id, disp, ierr)
subroutine fem_get_nodal_velocity(nnode, node_id, vel, ierr)
subroutine fem_get_nodal_acceleration(nnode, node_id, acc, ierr)
subroutine fem_get_element_stress(nelem, elem_id, stress, ierr)
```
## 7. 载荷施加接口
待补充:
```fortran
subroutine fem_clear_external_force(ierr)
subroutine fem_apply_nodal_force(nnode, node_id, force, ierr)
subroutine fem_apply_pressure(nface, face_id, pressure, ierr)
```
## 8. SPH-FEM 耦合接口
待补充:
```fortran
subroutine fem_get_boundary_facets(nfacet, conn, x, v, normal, area, ierr)
subroutine fem_apply_sph_nodal_forces(nnode, node_id, force, ierr)
subroutine fem_apply_sph_facet_tractions(nfacet, facet_id, pressure, shear, ierr)
```
待讨论:
- facet 编号稳定性
- 法向方向约定
- 压力正负号约定
- 剪切力坐标系约定
- FEM 与 SPH 时间步同步方式
## 9. 边界条件接口
待补充:
```fortran
subroutine fem_apply_prescribed_displacement(nnode, node_id, dof, value, ierr)
subroutine fem_apply_prescribed_velocity(nnode, node_id, dof, value, ierr)
subroutine fem_apply_robin_boundary(nnode, node_id, dof, stiffness, damping, ierr)
```
## 10. 错误码定义
待补充:
- 成功
- 输入文件错误
- 不支持功能
- 内存分配失败
- 非法参数
- 网格质量错误
- 求解失败
- 耦合接口错误
## 11. 内存与数组约定
待补充:
- 数组维度顺序
- 调用方分配还是库内分配
- 字符串长度
- 下标从 1 开始
- 节点、单元和 facet 编号约定
## 12. 单位制约定
待补充:
- 软件不内置单位转换
- inp 文件和外部耦合程序必须采用一致单位制
- 日志中记录建议单位说明
## 13. C/C++/Python 包装层规划
待补充:
- Fortran95 原生接口
- C ABI 包装层
- Python 调研接口
- 与外部 SPH 程序耦合方式
+134
View File
@@ -0,0 +1,134 @@
# FEM Test and Verification Plan
文档状态:草稿
适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序
## 1. 文档目的
本文档定义 FEM 软件的测试层级、验证算例、确认算例、回归测试、性能测试和验收策略。
## 2. 测试目标
待补充:
- 验证有限元公式实现正确
- 验证材料更新算法正确
- 验证显式动力学稳定可靠
- 验证 Abaqus inp 子集解析正确
- 验证 SPH-FEM 边界接口可用
- 建立回归测试基准
## 3. 测试层级
待补充:
- 单元测试
- 模块测试
- 集成测试
- 系统测试
- 回归测试
- 性能测试
- 鲁棒性测试
## 4. 单元测试计划
待补充:
- 形函数 Kronecker delta 性质
- 形函数 partition of unity
- Jacobian 计算
- 高斯积分规则
- 线弹性应力更新
- J2 弹塑性返回映射
- CSR 索引构造
- INP keyword 解析
## 5. 模块测试计划
待补充:
- 实体单元质量矩阵
- 实体单元内力
- 壳单元膜响应
- 壳单元弯曲响应
- 边界载荷等效节点力
- Dirichlet 约束施加
- SPH facet 导出与载荷导入
## 6. 集成测试计划
待补充:
- inp 读取到数据库构建
- 数据库到自由度编号
- 显式初始化
- 单步推进
- 多步输出
- 错误日志检查
## 7. 验证算例
待补充:
- 实体单元 patch test
- 壳单元 patch test
- 单轴拉伸
- 悬臂梁静力
- 自由振动频率
- 弹性波传播
- 薄板弯曲
- 弹塑性单轴加载卸载
## 8. 确认算例
待补充:
- Taylor impact
- 板受冲击压力载荷
- 简化船体板架爆炸响应
- 接触冲击算例
- SPH-FEM 耦合压力传递算例
## 9. 回归测试
待补充:
- 基准结果存储格式
- 允许误差
- 浮点误差处理
- 自动测试脚本
- 每次提交必须运行的测试集合
## 10. 性能测试
待补充:
- 节点规模
- 单元规模
- 时间步规模
- 内存占用
- 显式单步耗时
- INP 读取耗时
## 11. 鲁棒性测试
待补充:
- 缺失材料
- 退化单元
- 非法边界自由度
- 不支持 keyword
- 空集合
- 非法塑性曲线
- 时间步过大
## 12. 验收准则
待补充:
- 第一阶段验收算例
- 数值误差阈值
- 日志和错误码要求
- 文档完整性要求