# 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 和工程级应用算例均作为后续版本预留。 ## 构建和验证 常用本地构建: ```powershell 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。