Files
FemLite/todo.md
T
shenw 0440ed5a64
FemLite CI / build-test (push) Has been cancelled
Release FemLite 0.6.4
2026-07-05 17:23:34 +08:00

4.6 KiB
Raw Blame History

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-worker CLI 入口,不影响原 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 命名接口。