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
+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 程序耦合方式