75 lines
3.4 KiB
Markdown
75 lines
3.4 KiB
Markdown
# 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。
|