Files
FemLite/docs/05_interface_control_document.md
T
2026-06-22 12:43:41 +08:00

3.0 KiB

FEM Interface Control Document

文档状态:草稿

适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序

1. 文档目的

本文档定义 FEM 核心库对外暴露的调用接口、数据交换约定、错误码、单位制和 SPH-FEM 耦合接口。

2. 接口设计原则

待补充:

  • Fortran95 数组接口
  • 不依赖面向对象特性
  • 调用者不直接访问内部数据库
  • 通过错误码返回状态
  • 一致单位制由调用者保证

3. 库生命周期接口

待补充:

subroutine fem_initialize(ierr)
subroutine fem_finalize(ierr)

4. 模型输入接口

待补充:

subroutine fem_read_inp(filename, ierr)
subroutine fem_build_model(ierr)

待讨论:

  • filename 字符串长度约定
  • 多 step inp 文件处理方式
  • 不支持 keyword 的返回策略

5. 求解控制接口

待补充:

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. 结果查询接口

待补充:

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. 载荷施加接口

待补充:

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 耦合接口

待补充:

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. 边界条件接口

待补充:

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