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