4.6 KiB
4.6 KiB
FemLite TODO
文档状态:根据 docs/12_cclite_integration_suggestions.md 重写,并随 0.6.x CCLite coupling 闭环更新。
开发原则
- 保持 FemLite 独立求解器身份,不把 CCLite/SPHLite 算法核心写入 FemLite。
- 先固化中立 coupling API,再做 worker/service,再接 Windows IPC。
- 每个待办都有 smoke、单元测试或文档验收。
- 旧
sph命名接口保留兼容,不在本轮直接删除。
阶段 A:中立 Coupling API 固化
- 盘点现有 boundary facet Fortran API、C ABI 和测试覆盖。
- 盘点现有 sph/facet load Fortran API、C ABI 和测试覆盖。
- 设计中立 coupling surface 查询接口名称、参数和错误返回规则。
- 增加 Fortran 层 coupling surface count/facets wrapper,并保持旧接口兼容。
- 增加 C ABI coupling surface count/facets wrapper,并补充头文件声明。
- 增加 coupling nodal force 导入接口,明确数组展开和容量规则。
- 增加 Fortran 层 coupling nodal force wrapper,并接入现有外部载荷路径。
- 增加 C ABI coupling nodal force wrapper,并补充头文件声明。
- 增加 coupling load 总力、总力矩、接受计数和拒绝计数诊断。
- 补充 C API smoke,覆盖 surface/facet 查询、空载荷、节点力和错误边界。
- 更新
docs/05_interface_control_document.md和 CCLite 建议文档。
阶段 B:Worker Mock 协议闭环
- 设计 worker command/state 枚举,覆盖 INIT 到 STOP。
- 增加 worker command block,包含 seq、ack、step、state 和 error 字段。
- 增加
--cclite-workerCLI 入口,不影响原 CLI 行为。 - 增加 READ_INPUT、BUILD_MODEL、EXPORT_INTERFACE、IMPORT_LOADS、ADVANCE、WRITE_OUTPUT 和 STOP 命令处理。
- 增加 worker CSV 日志,记录启动参数、命令状态和错误码。
- 补充 worker 启动、READY、seq/ack、100 step 空耦合、STOP 和错误路径 smoke。
- 更新用户文档,说明 worker mock 仍非真实 IPC。
阶段 C:Windows IPC Adapter
- 设计 Windows command block 二进制布局,与 CCLite 字段命名对齐。
- 增加 Windows shared memory open/close wrapper,只 open 不 create。
- 增加 Windows named event open/wait/signal/close wrapper,只 wait/signal 不 reset。
- 增加 IPC 超时参数和稳定错误码。
- 抽象 worker transport 为 mock 和 Windows IPC 两个后端。
- 接入 COMMAND_EVENT wait、command block 读取、ack/state/error 写回和 DONE_EVENT signal。
- 补充 IPC INIT/STOP、100 step 空耦合、超时和错误路径 smoke。
- 更新文档,明确 event reset 责任属于 CCLite。
阶段 D:Surface/Facet 完整导出
- 梳理 boundary facet 字段来源,确认 facet_id、elem_id、face_id、node_ids。
- 增加 surface_id 导出占位规则,未指定 surface 时返回 0 并写 warning。
- 增加 material_id、section_id、valid_flags、shell_thickness 和 mass_per_area 导出字段。
- 增加当前构型 normal 归一化检查和退化 facet invalid flag。
- 增加退化三角形、退化四边形、实体面厚度为 0、壳厚度和面密度测试。
- 支持
*SURFACE, NAME=..., TYPE=ELEMENT的 coupling 导出过滤。 - 增加单三角形、单四边形和壳厚度导出验收 deck。
- 更新接口文档和 CCLite 联合改造建议文档。
阶段 E:外部载荷导入与诊断
- 设计独立 coupling external load 缓存,不直接暴露全局力数组。
- 增加每个 CCLite step 前清零 external load 缓存的生命周期入口。
- 将 coupling nodal force 叠加到显式动力外力路径。
- 将 coupling nodal force 叠加到静力/隐式 RHS 路径。
- 增加 source_id、load_mode 和 valid_flags 的输入校验。
- 增加本步 coupling 总力统计。
- 增加本步 coupling 总力矩统计。
- 增加按 source 汇总 coupling 载荷的诊断接口。
- 增加
femlite_cclite_load_report.csv输出。 - 增加
femlite_cclite_surface_report.csv输出。 - 增加节点力导入后显式单步响应测试。
- 增加节点力导入后静力 RHS 响应测试。
- 增加 force balance CSV 对账测试。
- 增加 VTU/PVD 输出与 worker 诊断一致性测试。
- 更新示例 README,说明 CCLite 载荷导入仍是基础节点力闭环。
暂不纳入本轮
- DEFERRED:真实 SPH-FEM penalty contact 物理验收。
- DEFERRED:FSI 工程算例。
- DEFERRED:tie/release 联合接触。
- DEFERRED:强耦合 rollback 和预测状态接口。
- DEFERRED:删除旧
sph命名接口。