Files
2026-07-06 09:45:38 +08:00

3.4 KiB
Raw Permalink Blame History

CCLite

CCLite(Coupling & Contact Lite)是面向 SPHLite 与 FEMLite 的 SPH-FEM 耦合、接触联合仿真软件。

本软件基于 Fortran 开发,算法核心采用 Fortran95 风格实现;数据交换、进程通信和共享内存映射可采用 Fortran2018 与必要的 C/C++ 薄封装。默认编译器为 gfortran。

软件定位

CCLite、SPHLite、FEMLite 均保持独立主控程序形态。CCLite 作为联合仿真的主控程序,负责:

  1. 启动和调度 SPHLite、FEMLite;
  2. 建立本机共享内存和控制 IPC;
  3. 读取 CCLite 自身 Abaqus 风格 .inp 控制文件;
  4. 交换 SPH/FEM 界面状态;
  5. 执行 SPH-FEM 接触搜索、接触判定和界面力传递;
  6. 输出接触、耦合、通信、时间步和力平衡诊断。

CCLite 不替代 SPHLite 或 FEMLite,不负责 SPH/FEM 内部求解、材料本构、网格生成或粒子生成。

当前状态

当前发布候选:0.2.10。

0.2.x 已完成基础 SPH 粒子到 FEM facet 的法向 penalty contact 最小闭环:

  1. Windows / gfortran / 本机共享内存;
  2. CCLite Controller + SPHLite/FEMLite 独立进程;
  3. 大数据共享内存交换,小命令控制 IPC;
  4. Abaqus 风格 .inp 输入;
  5. *CCLITE SURFACE INTERACTION 和 *CCLITE CONTACT PAIR;
  6. SPH particle view、FEM facet view 和 AoR v1 payload;
  7. Vec3、AABB、point-segment、point-triangle 和四边形拆三角形最小路径;
  8. uniform hash grid 宽相、窄相 gap/penetration/normal/shape weight;
  9. 法向 penalty force、基础法向阻尼和 FEM 节点力分配;
  10. CCL_TO_SPH_FORCE 与 CCL_TO_FEM_LOAD 非空写回;
  11. contact_report.csv、candidate_report.csv、force_balance.csv 和 ipc_report.csv;
  12. Python checker 自动验收几何、接触方向、力平衡和真实 worker gate。

真实 SPHLite/FEMLite worker 已进入受控 gate:当前 worker 能力查询和真实 IPC attach 探测可用,但 CCLite 侧协议/命名 adapter 尚未完成进程级联调,因此状态为 CONTROLLED_PROTOCOL_GAP。这不等价于真实 SPH-FEM 外部进程物理联调完成。

Linux 共享内存、MPI、显隐耦合、强耦合、Coulomb 摩擦、tied/release、FSI、SoA v2 和工程级应用算例均作为后续版本预留。

构建和验证

常用本地构建:

cmake -S . -B build-codex-gcc
cmake --build build-codex-gcc --config Debug
ctest --test-dir build-codex-gcc -C Debug --output-on-failure

0.2.10 发布候选应通过 0.1.x 空耦合回归、0.2.x 几何/搜索/接触/力写回验证、真实 worker gate 报告检查和 UTF-8 without BOM 检查。

文档

当前文档位于 docs/:

  1. 01_requirements.md:软件需求规格说明书;
  2. 02_architectural_design_specification.md:概要设计说明书;
  3. 03_detailed_design.md:详细设计说明书;
  4. 04_mathematical_model_and_algorithms.md:数学模型与算法说明;
  5. 05_interface_control_document.md:接口控制文档;
  6. 06_test_and_verification_plan.md:测试与验证计划;
  7. 07_real_worker_access_audit.md:真实 worker 最小接入审计;
  8. v1.x_development_plan.md:0.1.x 开发计划;
  9. v2.x_development_plan.md:0.2.x 开发计划;
  10. 0.1.x_interface_constants.md:0.1.x 接口常量冻结记录;
  11. 0.1.x_release_notes.md:0.1.x 发布说明;
  12. 0.2.x_release_notes.md:0.2.x 发布说明。

编码要求

本仓库文档均使用中文,文件编码为 UTF-8 without BOM。