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

75 lines
3.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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。