This commit is contained in:
@@ -0,0 +1,79 @@
|
||||
# 13 CCLite Coupling API 盘点
|
||||
|
||||
文档状态:阶段 A 初始盘点
|
||||
|
||||
## 1. Boundary Facet 接口现状
|
||||
|
||||
已有 Fortran API:
|
||||
|
||||
- `fem_get_boundary_facet_count(num_facets, max_face_nodes, ierr)`
|
||||
- `fem_get_boundary_facets(nfacet_in, max_face_nodes_in, facet_id, elem_id, face_id, facet_nnode, facet_conn, x, vnod, normal, area, ierr)`
|
||||
|
||||
已有 C ABI:
|
||||
|
||||
- `femlite_get_boundary_facet_count`
|
||||
- `femlite_get_boundary_facets`
|
||||
|
||||
已有测试:
|
||||
|
||||
- `test_c_api` 覆盖 C3D4 边界 facet 数量和基础字段。
|
||||
- `test_facet_nodal_c_api` 覆盖 facet 查询后施加 facet nodal load。
|
||||
- `test_smoke` 覆盖 Fortran API 的实体和壳边界 facet 查询。
|
||||
|
||||
当前缺口:
|
||||
|
||||
- 接口命名偏内部 boundary,不是 CCLite 中立 coupling surface。
|
||||
- 当前不携带 `surface_id`、`material_id`、`section_id` 和 `valid_flags`。
|
||||
- surface 名称过滤留到后续阶段。
|
||||
- 壳厚度和 mass per area 留到后续阶段。
|
||||
|
||||
## 2. Facet/Load 接口现状
|
||||
|
||||
已有 Fortran API:
|
||||
|
||||
- `fem_clear_sph_forces(ierr)`
|
||||
- `fem_apply_sph_nodal_force(node_id, force, ierr)`
|
||||
- `fem_apply_sph_nodal_forces(num_force_nodes, node_ids, force, ierr)`
|
||||
- `fem_get_sph_force_summary(total_force, ierr)`
|
||||
- `fem_apply_sph_facet_pressure`
|
||||
- `fem_apply_sph_facet_tractions`
|
||||
- `fem_apply_sph_facet_nodal_loads`
|
||||
|
||||
已有 C ABI:
|
||||
|
||||
- `femlite_clear_sph_forces`
|
||||
- `femlite_apply_sph_nodal_forces`
|
||||
- `femlite_get_sph_force_summary`
|
||||
- `femlite_apply_sph_facet_pressure`
|
||||
- `femlite_apply_sph_facet_tractions`
|
||||
- `femlite_apply_sph_facet_nodal_loads`
|
||||
|
||||
已有测试:
|
||||
|
||||
- `test_c_api` 覆盖 nodal force 后显式推进。
|
||||
- `test_facet_nodal_c_api` 覆盖 facet nodal load 的总力和错误边界。
|
||||
- `test_particle_fem_coupling` 覆盖 Fortran 侧 facet load 与 particle coupling 小闭环。
|
||||
|
||||
当前缺口:
|
||||
|
||||
- `sph` 命名不适合作为 CCLite 长期公共接口。
|
||||
- 当前节点力接口不记录 source id、load mode 和 valid flags。
|
||||
- 当前总力查询只有 force,没有 moment、接受计数和拒绝计数。
|
||||
- 非有限载荷、节点未匹配、容量不足等诊断尚未统一为 coupling load 诊断。
|
||||
|
||||
## 3. 阶段 A 处理策略
|
||||
|
||||
- 新增中立 coupling wrapper,先复用现有 boundary facet 和 sph load 实现。
|
||||
- 保留旧 `sph` 命名接口,避免破坏历史调用。
|
||||
- 先提供全部边界 facet 导出,不在阶段 A 做 surface 名称过滤。
|
||||
- 先提供节点力导入和基础诊断,不在阶段 A 做 facet pressure 的中立包装。
|
||||
- C ABI smoke 覆盖新 wrapper,旧测试继续保留。
|
||||
|
||||
## 4. 当前完成状态
|
||||
|
||||
- 中立 coupling surface/facet wrapper 已补齐,旧 `boundary` 和 `sph` 命名接口继续保留兼容。
|
||||
- 扩展 facet 导出已包含 `surface_id`、`material_id`、`section_id`、`valid_flags`、`shell_thickness` 和 `mass_per_area`。
|
||||
- 节点力导入已记录 `source_id`、`load_mode` 和 `valid_flags`,并维护独立诊断缓存。
|
||||
- 诊断已覆盖本步总力、总力矩、接受记录数、非有限载荷、未知节点、容量/metadata 错误和按 `source_id` 汇总。
|
||||
- C API 已提供 `femlite_get_coupling_source_load_diagnostics` 与 `femlite_write_coupling_reports`。
|
||||
- worker mock 已在 VTU/PVD 输出目录同步生成 `femlite_cclite_load_report.csv` 和 `femlite_cclite_surface_report.csv`。
|
||||
Reference in New Issue
Block a user