Establish FEM design documentation baselines
This commit is contained in:
@@ -1,130 +1,439 @@
|
||||
# FEM Software Architecture Design
|
||||
|
||||
文档状态:草稿
|
||||
文档状态:架构基线草稿
|
||||
|
||||
适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序
|
||||
|
||||
## 1. 文档目的
|
||||
|
||||
本文档描述 FEM 软件的整体架构、模块划分、数据流、控制流、外部接口和扩展策略。
|
||||
本文档描述 FEM 软件的整体架构、交付形态、目录组织、模块划分、数据流、控制流、外部接口、错误处理和扩展策略。
|
||||
|
||||
本文档中的架构决策用于约束后续详细设计、算法设计、接口设计和代码实现。
|
||||
|
||||
## 2. 架构目标
|
||||
|
||||
待补充:
|
||||
软件架构应满足:
|
||||
|
||||
- 核心库与小型主程序分离
|
||||
- 显式动力学优先
|
||||
- 保留隐式非线性扩展路径
|
||||
- 支持 Abaqus inp 输入
|
||||
- 支持 SPH-FEM 边界耦合
|
||||
- 采用 Fortran95 过程式模块组织
|
||||
- 核心库与命令行程序分离
|
||||
- 第一版优先支持显式瞬态动力学
|
||||
- 第一版支持独立 FEM 程序运行和外部 SPH 驱动两种模式
|
||||
- 第一版支持 Abaqus inp 输入
|
||||
- 第一版支持 SPH-FEM 边界力交换接口
|
||||
- Fortran95 过程式模块组织,不采用面向对象类型绑定
|
||||
- 集中式数据库管理网格、材料、状态变量和全局向量
|
||||
- 单元、材料、求解器、耦合和输出模块保持职责分离
|
||||
- 第二版预留壳单元扩展、接触、隐式非线性和 CSR 稀疏矩阵能力
|
||||
|
||||
## 3. 总体分层
|
||||
## 3. 交付形态
|
||||
|
||||
建议分层:
|
||||
第一版交付:
|
||||
|
||||
- 输入层:Abaqus inp 读取与模型构造
|
||||
- 核心 FEM 层:网格、材料、单元、边界、接触、耦合
|
||||
- 求解层:显式动力学、隐式非线性、稀疏矩阵与外部求解器接口
|
||||
- 输出层:日志、结果文件、诊断信息、重启动数据
|
||||
- 静态库:libFemLite
|
||||
- 命令行程序:femlite
|
||||
- 测试程序:单元测试、模块测试和集成测试可执行文件
|
||||
- 示例算例:examples 目录中的 Abaqus inp 输入文件和参考输出
|
||||
- 文档:docs 目录中的需求、架构、详细设计、算法、接口和测试文档
|
||||
|
||||
待讨论:
|
||||
第二版或后续版本可扩展:
|
||||
|
||||
- 是否需要独立 preprocessing 层
|
||||
- 是否需要独立 restart 层
|
||||
- 输出格式优先级
|
||||
- 动态库
|
||||
- C/C++/Python 包装层
|
||||
- 更完整后处理工具链
|
||||
- 外部求解器适配层
|
||||
|
||||
## 4. 模块划分
|
||||
## 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
|
||||
```text
|
||||
src/base 基础类型、常量、日志、错误码、控制参数
|
||||
src/input Abaqus inp 读取与输入数据预处理
|
||||
src/mesh 网格、集合、facet、自由度编号
|
||||
src/material 材料模型与状态变量更新
|
||||
src/element 实体单元、壳单元、形函数、积分规则
|
||||
src/solver 显式求解器、隐式求解器预留、稀疏矩阵预留
|
||||
src/boundary 边界条件、载荷、约束、接触预留
|
||||
src/coupling FEM 外部耦合接口和 SPH 力映射
|
||||
src/output 日志、CSV、VTK 预留、restart 预留
|
||||
src/app femlite 命令行程序
|
||||
tests 测试程序与测试数据
|
||||
examples 示例 inp 文件与参考结果
|
||||
docs 工程文档
|
||||
```
|
||||
|
||||
待补充:
|
||||
目录职责边界:
|
||||
|
||||
- 每个模块的职责边界
|
||||
- 模块依赖关系
|
||||
- 禁止出现的循环依赖
|
||||
- input 层只负责解析输入,不直接执行求解。
|
||||
- material 层只负责本构更新,不直接访问全局网格。
|
||||
- element 层负责单元级质量、内力、应力更新和稳定步长估计。
|
||||
- solver 层负责时间推进和全局向量更新,不直接依赖 SPH 实现。
|
||||
- coupling 层只负责数据交换和力映射,FEM 核心不依赖 SPH 程序。
|
||||
- output 层统一处理日志、历史量和结果输出。
|
||||
|
||||
## 5. 核心数据流
|
||||
## 5. 总体分层
|
||||
|
||||
待补充:
|
||||
软件采用以下分层:
|
||||
|
||||
```text
|
||||
Application Layer
|
||||
femlite command line program
|
||||
test programs
|
||||
examples
|
||||
|
||||
Public API Layer
|
||||
fem_initialize
|
||||
fem_read_inp
|
||||
fem_build_model
|
||||
fem_advance_explicit
|
||||
fem_get_boundary_facets
|
||||
fem_apply_sph_forces
|
||||
fem_finalize
|
||||
|
||||
Core FEM Layer
|
||||
mesh database
|
||||
dof numbering
|
||||
material update
|
||||
element routines
|
||||
boundary and load routines
|
||||
coupling force mapping
|
||||
|
||||
Solver Layer
|
||||
explicit central difference solver
|
||||
implicit solver placeholder
|
||||
CSR matrix placeholder
|
||||
|
||||
Input/Output Layer
|
||||
Abaqus inp reader
|
||||
log writer
|
||||
CSV writer
|
||||
VTK placeholder
|
||||
restart placeholder
|
||||
```
|
||||
|
||||
## 6. 数据库架构
|
||||
|
||||
软件采用集中式 fem_database 模块。
|
||||
|
||||
架构约定:
|
||||
|
||||
- 网格、材料、截面、集合、自由度、状态变量和全局向量由 fem_database 统一保存。
|
||||
- 允许模块共享 fem_database 中的全局 allocatable 数组。
|
||||
- 各模块通过明确的初始化、查询和更新子程序访问数据库。
|
||||
- 不使用面向对象类型绑定。
|
||||
- 材料例程不直接访问全局数据库。
|
||||
- 单元例程可读取单元连接、坐标、材料编号和状态变量索引。
|
||||
- 求解器例程负责全局向量清零、累计、边界条件施加和时间推进。
|
||||
|
||||
核心数据库类别:
|
||||
|
||||
- 节点坐标
|
||||
- 单元连接关系
|
||||
- 单元类型
|
||||
- 节点集和单元集
|
||||
- 材料参数
|
||||
- 截面参数
|
||||
- 自由度编号
|
||||
- 位移、速度、加速度
|
||||
- 集中质量
|
||||
- 内力、外力、接触力、SPH 力
|
||||
- 高斯点应力、应变、塑性应变和历史变量
|
||||
- 单元删除标志
|
||||
|
||||
## 7. 自由度架构
|
||||
|
||||
每个节点预留 6 个自由度:
|
||||
|
||||
```text
|
||||
1 UX
|
||||
2 UY
|
||||
3 UZ
|
||||
4 RX
|
||||
5 RY
|
||||
6 RZ
|
||||
```
|
||||
|
||||
自由度规则:
|
||||
|
||||
- 实体单元只激活 UX、UY、UZ。
|
||||
- 壳单元激活 UX、UY、UZ、RX、RY、RZ。
|
||||
- 未激活自由度编号为 0。
|
||||
- 全局自由度编号由 mesh/dof 模块统一生成。
|
||||
- Dirichlet 边界、节点力、输出和 SPH 接口均使用同一自由度约定。
|
||||
- 后续 MPC、接触和壳-实体连接沿用同一自由度体系。
|
||||
|
||||
## 8. 大变形架构
|
||||
|
||||
第一版默认采用 Updated Lagrangian 架构。
|
||||
|
||||
基本约定:
|
||||
|
||||
- 当前构形用于计算单元几何、Jacobian、体积、面积和法向。
|
||||
- 单元内力基于当前构形上的应力状态累计。
|
||||
- 小应变 J2 和大应变 J2 通过材料更新选项切换。
|
||||
- 大变形相关运动学量由单元模块计算并传递给材料模块。
|
||||
- 材料模块只接收材料更新所需的局部变量和旧状态,返回新应力、状态变量和可选切线。
|
||||
- 壳单元第一版可采用有限转动能力受限的 S4 实现,第二版再扩展更完整壳大变形框架。
|
||||
|
||||
## 9. 材料与状态变量架构
|
||||
|
||||
状态变量存储按 element + integration point 组织。
|
||||
|
||||
职责划分:
|
||||
|
||||
- fem_database 保存所有高斯点状态变量。
|
||||
- element 模块负责从数据库取出旧状态并调用材料模块。
|
||||
- material 模块负责应力更新和状态变量更新。
|
||||
- element 模块负责把新状态写回数据库。
|
||||
- solver 模块负责控制何时提交或回滚状态变量。
|
||||
|
||||
材料例程接口原则:
|
||||
|
||||
- 输入应包含材料编号、应变增量或变形度量、应变率、温度、时间步长和旧状态。
|
||||
- 输出应包含新应力、新状态变量、失效标志和可选算法切线。
|
||||
- 材料例程不得依赖全局节点、单元或求解器状态。
|
||||
|
||||
## 10. 单元调度架构
|
||||
|
||||
Fortran95 下直接使用 Abaqus 单元类型字符串作为内部主标识。
|
||||
|
||||
支持的单元类型字符串:
|
||||
|
||||
```text
|
||||
C3D4
|
||||
C3D8
|
||||
S4
|
||||
C3D10
|
||||
C3D20
|
||||
S3
|
||||
S6
|
||||
S8
|
||||
```
|
||||
|
||||
调度原则:
|
||||
|
||||
- elem_type 使用固定长度字符串保存,例如 character(len=16)。
|
||||
- INP 读取时将单元类型转换为大写并去除多余空格。
|
||||
- element_driver 根据 elem_type 字符串调用具体单元例程。
|
||||
- 具体单元例程只处理本单元的质量、内力、应力更新、稳定时间步和面载荷。
|
||||
- 新增单元时扩展 elem_type 字符串识别和对应单元例程。
|
||||
- 第一版必须实现 C3D4、C3D8、S4。
|
||||
- 第二版应实现 C3D10、C3D20、S3、S6、S8。
|
||||
- 后续如需性能优化,可增加内部缓存编码,但 Abaqus 字符串仍作为数据库主字段。
|
||||
|
||||
## 11. 核心数据流
|
||||
|
||||
独立程序模式数据流:
|
||||
|
||||
```text
|
||||
Abaqus inp
|
||||
-> inp reader
|
||||
-> mesh/material/section/boundary database
|
||||
-> dof numbering
|
||||
-> facet construction
|
||||
-> mass initialization
|
||||
-> time integration loop
|
||||
-> explicit time integration loop
|
||||
-> element stress/internal force update
|
||||
-> boundary/contact/SPH force update
|
||||
-> result output
|
||||
-> boundary and load update
|
||||
-> output
|
||||
```
|
||||
|
||||
## 6. 求解控制流
|
||||
外部 SPH 驱动模式数据流:
|
||||
|
||||
待补充:
|
||||
```text
|
||||
external driver
|
||||
-> fem_initialize
|
||||
-> fem_read_inp / fem_build_model
|
||||
-> fem_get_boundary_facets
|
||||
-> external SPH force calculation
|
||||
-> fem_apply_sph_forces
|
||||
-> fem_advance_explicit(dt)
|
||||
-> fem_get_boundary_facets
|
||||
-> repeat
|
||||
```
|
||||
|
||||
- 显式中心差分控制流
|
||||
- 隐式 Newmark + Newton 控制流
|
||||
- 非线性状态变量更新时机
|
||||
- 输出与重启动时机
|
||||
## 12. 求解控制流
|
||||
|
||||
## 7. SPH-FEM 耦合架构
|
||||
第一版显式中心差分控制流:
|
||||
|
||||
待补充:
|
||||
```text
|
||||
initialize model
|
||||
compute lumped mass
|
||||
initialize displacement, velocity and acceleration
|
||||
for each time step:
|
||||
clear force vectors
|
||||
apply prescribed loads
|
||||
receive SPH forces when running in coupling mode
|
||||
compute element stress and internal force
|
||||
apply boundary conditions
|
||||
compute acceleration from lumped mass
|
||||
update velocity
|
||||
update displacement
|
||||
update current configuration
|
||||
delete failed elements when required
|
||||
write output when required
|
||||
end for
|
||||
```
|
||||
|
||||
- FEM 边界 facet 导出
|
||||
- 边界坐标、速度、法向、面积交换
|
||||
- SPH 压力/剪切/节点力导入
|
||||
- 时间步同步策略
|
||||
- 错误码和耦合状态管理
|
||||
第二版隐式控制流预留:
|
||||
|
||||
## 8. 错误处理与日志
|
||||
```text
|
||||
initialize model
|
||||
build CSR sparsity
|
||||
for each increment:
|
||||
predict displacement and velocity
|
||||
Newton iteration:
|
||||
assemble residual
|
||||
assemble tangent matrix
|
||||
apply boundary and constraint equations
|
||||
solve correction
|
||||
update trial state
|
||||
check convergence
|
||||
commit state
|
||||
write output
|
||||
end for
|
||||
```
|
||||
|
||||
待补充:
|
||||
求解控制权:
|
||||
|
||||
- 错误级别
|
||||
- 错误码范围
|
||||
- 日志格式
|
||||
- 不支持 keyword 的处理策略
|
||||
- 独立程序模式由 femlite 控制时间循环。
|
||||
- 外部 SPH 驱动模式由外部驱动器控制时间步长和调用顺序。
|
||||
- SPH 耦合时,solver 只接收 fsph 全局力向量。
|
||||
- solver 不直接调用 SPH 程序或依赖 SPH 数据结构。
|
||||
|
||||
## 9. 扩展策略
|
||||
## 13. SPH-FEM 耦合架构
|
||||
|
||||
待补充:
|
||||
coupling 层职责:
|
||||
|
||||
- 添加新单元
|
||||
- 添加新材料
|
||||
- 添加新边界条件
|
||||
- 添加新输入 keyword
|
||||
- 接入外部线性求解器
|
||||
- 构造和维护 FEM 边界 facet 列表。
|
||||
- 导出 facet 坐标、速度、法向和面积。
|
||||
- 接收压力、剪切力或等效节点力。
|
||||
- 将外部耦合载荷映射为 FEM 全局 fsph 向量。
|
||||
- 检查 coupling 接口参数合法性。
|
||||
|
||||
## 10. 构建与部署架构
|
||||
边界 facet 来源:
|
||||
|
||||
待补充:
|
||||
- 实体单元外表面
|
||||
- 壳单元表面
|
||||
- 指定 elset
|
||||
|
||||
- 静态库
|
||||
耦合约束:
|
||||
|
||||
- FEM 核心不依赖具体 SPH 程序。
|
||||
- coupling 层不执行 SPH 粒子计算。
|
||||
- element 层不直接依赖 SPH。
|
||||
- solver 层只使用已经映射好的 fsph。
|
||||
- 每个时间步可执行一次双向交换。
|
||||
- 时间步由 SPH 或外部耦合驱动器控制。
|
||||
|
||||
## 14. 输出架构
|
||||
|
||||
第一版输出:
|
||||
|
||||
- 日志文件:运行信息、warning、error、关键统计量
|
||||
- CSV 历史量:时间、能量、最大位移、最大速度、外力功等
|
||||
- CSV 场变量:节点位移、速度、加速度,单元应力、应变、塑性应变
|
||||
|
||||
第二版输出:
|
||||
|
||||
- VTK 结果文件
|
||||
- restart 文件
|
||||
|
||||
输出控制:
|
||||
|
||||
- 输出频率由 fem_control 统一管理。
|
||||
- 输出模块不参与求解状态更新。
|
||||
- 第一版不建立复杂后处理数据库。
|
||||
|
||||
## 15. 错误处理与日志
|
||||
|
||||
错误处理原则:
|
||||
|
||||
- 所有核心接口返回 ierr。
|
||||
- 日志模块记录 warning、error 和 fatal 信息。
|
||||
- 不支持的 Abaqus keyword 作为 warning 后跳过。
|
||||
- 关键数据缺失、非法材料参数、退化单元等错误应终止当前分析。
|
||||
- 外部接口不得通过未捕获异常或直接停止进程隐藏错误来源。
|
||||
|
||||
错误码分组:
|
||||
|
||||
```text
|
||||
0 success
|
||||
1000 input errors
|
||||
2000 mesh and dof errors
|
||||
3000 material and state errors
|
||||
4000 solver errors
|
||||
5000 coupling errors
|
||||
6000 output errors
|
||||
9000 internal errors
|
||||
```
|
||||
|
||||
日志至少记录:
|
||||
|
||||
- 输入文件名
|
||||
- 识别和跳过的 keyword
|
||||
- 节点数、单元数、自由度数
|
||||
- 材料和截面数量
|
||||
- 时间步设置
|
||||
- 输出设置
|
||||
- warning 和 error 位置
|
||||
- 分析开始和结束状态
|
||||
|
||||
## 16. 扩展策略
|
||||
|
||||
添加新单元:
|
||||
|
||||
- 增加 elem_type 字符串识别
|
||||
- 增加形函数和积分规则
|
||||
- 增加质量、内力、应力更新和面载荷例程
|
||||
- 增加单元测试和 patch test
|
||||
|
||||
添加新材料:
|
||||
|
||||
- 增加材料类型编码
|
||||
- 增加材料参数解析
|
||||
- 增加材料更新例程
|
||||
- 增加单轴或多轴材料测试
|
||||
|
||||
添加新边界条件:
|
||||
|
||||
- 增加输入解析
|
||||
- 增加数据库存储
|
||||
- 增加载荷或约束施加例程
|
||||
- 增加验证算例
|
||||
|
||||
添加新输入 keyword:
|
||||
|
||||
- 增加 keyword 识别
|
||||
- 增加参数解析
|
||||
- 增加错误诊断
|
||||
- 增加输入回归测试
|
||||
|
||||
接入外部线性求解器:
|
||||
|
||||
- 通过 CSR 层提供矩阵和向量接口
|
||||
- 隐式求解器不得直接绑定具体第三方库
|
||||
- 外部库适配应单独放在 solver 或 external 子层
|
||||
|
||||
## 17. 构建与部署架构
|
||||
|
||||
构建系统:
|
||||
|
||||
- 使用 CMake。
|
||||
- 默认编译器为 gfortran。
|
||||
- 兼容 Intel Fortran。
|
||||
- 支持 Windows 和 Linux。
|
||||
|
||||
构建目标:
|
||||
|
||||
- FemLite 静态库
|
||||
- femlite 命令行程序
|
||||
- 单元测试程序
|
||||
- 模块测试程序
|
||||
- 集成测试程序
|
||||
|
||||
第一版不要求:
|
||||
|
||||
- OpenMP
|
||||
- MPI
|
||||
- 动态库
|
||||
- 小型命令行程序
|
||||
- 测试程序
|
||||
- 示例算例目录
|
||||
|
||||
- 外部求解器强依赖
|
||||
|
||||
Reference in New Issue
Block a user