145 lines
3.0 KiB
Markdown
145 lines
3.0 KiB
Markdown
# 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 程序耦合方式
|
|
|