Finalize CCLite 0.2.10 release candidate
This commit is contained in:
@@ -0,0 +1,104 @@
|
||||
# CCLite 0.2.x 发布说明
|
||||
|
||||
## 1. 版本定位
|
||||
|
||||
0.2.x 是 CCLite 的基础 SPH 粒子-FEM facet penalty contact 版本。该版本在 0.1.x 主控、IPC、mock worker、AoR v1 和空耦合闭环基础上,首次形成可自动验收的接触力闭环。
|
||||
|
||||
发布候选号:
|
||||
|
||||
```text
|
||||
CCLite 0.2.10
|
||||
```
|
||||
|
||||
## 2. 已完成功能
|
||||
|
||||
0.2.x 完成以下能力:
|
||||
|
||||
1. `.inp` 支持 `*CCLITE SURFACE INTERACTION`,并支持 `NORMAL=PENALTY`、`KN`、`CN`、`FRICTION=0`;
|
||||
2. `.inp` 支持 `*CCLITE CONTACT PAIR`,并支持 `TYPE=SPH_PARTICLE_TO_FEM_FACE`;
|
||||
3. SPH particle view 可从 AoR v1 `SPH_TO_CCL_PARTICLE` payload 构建;
|
||||
4. FEM facet view 可从 AoR v1 `FEM_TO_CCL_FACET` payload 构建;
|
||||
5. Vec3、AABB、point-segment、point-triangle 和四边形拆三角形最小路径已进入测试;
|
||||
6. uniform hash grid 可生成并去重 SPH particle-FEM facet 候选对;
|
||||
7. 窄相可生成 gap、penetration、normal、shape weight 和跳过原因计数;
|
||||
8. 法向 penalty force 和基础法向阻尼可生成 SPH 接触力;
|
||||
9. FEM 节点反力按 shape weight 分配,满足作用-反作用合力平衡;
|
||||
10. `CCL_TO_SPH_FORCE` 和 `CCL_TO_FEM_LOAD` 可写入非空载荷并被 mock worker 消费;
|
||||
11. `contact_report.csv`、`candidate_report.csv`、`force_balance.csv` 和 `ipc_report.csv` 可由 checker 自动检查;
|
||||
12. `V020_GEOMETRY_PRIMITIVES`、`V020_SINGLE_PARTICLE_WALL`、`V020_MULTI_PARTICLE_PLANE`、`V020_FORCE_BALANCE` 已进入回归;
|
||||
13. `V020_SINGLE_REAL_WORKER_SMOKE` 已形成真实 worker gate 报告,当前状态为 `CONTROLLED_PROTOCOL_GAP`。
|
||||
|
||||
## 3. 验证状态
|
||||
|
||||
0.2.10 发布候选验证范围:
|
||||
|
||||
1. 0.1.x smoke、parser、IPC、command/data block 和空耦合回归;
|
||||
2. 0.2.x contact parser、interface view、geometry、broad phase、narrow phase、penalty force 单元测试;
|
||||
3. 双 mock worker 的接触 controller 集成测试;
|
||||
4. 单粒子撞面、多粒子压面、force balance 算例;
|
||||
5. 真实 worker 能力查询、attach 探测和 gate 报告检查;
|
||||
6. UTF-8 without BOM 检查;
|
||||
7. 干净构建目录重建与全量测试。
|
||||
|
||||
当前自动测试集合包含 37 个 CTest 测试项。0.2.10 发布候选提交前已执行:
|
||||
|
||||
```text
|
||||
build-codex-gcc: 37/37 PASS
|
||||
build-codex-gcc-clean-0210-unix: 37/37 PASS
|
||||
cclite --version: CCLite 0.2.10
|
||||
```
|
||||
|
||||
## 4. 真实 Worker Gate
|
||||
|
||||
真实 worker gate 编号:
|
||||
|
||||
```text
|
||||
V020_SINGLE_REAL_WORKER_SMOKE
|
||||
```
|
||||
|
||||
当前结论:
|
||||
|
||||
```text
|
||||
EXTERNAL_WORKERS_READY_CCLITE_PROTOCOL_ADAPTER_REQUIRED
|
||||
gate_status: CONTROLLED_PROTOCOL_GAP
|
||||
```
|
||||
|
||||
含义:
|
||||
|
||||
1. SPHLite 和 FEMLite 均可报告 CCLite worker 能力;
|
||||
2. 两侧均报告 Windows shared memory/named event 的真实 IPC 后端能力;
|
||||
3. 两侧 worker CLI 均能进入真实 IPC attach 尝试;
|
||||
4. CCLite 与真实 worker 的命名、command block 和 data header 仍需要 adapter;
|
||||
5. 0.2.x 不声明真实 SPHLite/FEMLite 外部进程物理联调完成。
|
||||
|
||||
详细记录见 `docs/07_real_worker_access_audit.md`。
|
||||
|
||||
## 5. 未完成能力
|
||||
|
||||
以下能力不属于 0.2.x 已完成范围:
|
||||
|
||||
1. Coulomb 摩擦;
|
||||
2. 完整 edge fallback;
|
||||
3. 四边形双线性投影;
|
||||
4. 壳厚度高级接触;
|
||||
5. contact persistence;
|
||||
6. 自动 penalty 参数估计;
|
||||
7. 接触稳定时间步;
|
||||
8. 接触能量诊断;
|
||||
9. tied coupling 和 release;
|
||||
10. pressure projection、boundary/ghost particle 和 Riemann FSI;
|
||||
11. SoA v2 性能布局;
|
||||
12. Linux/MPI 生产后端;
|
||||
13. 工程级水下爆炸或船体局部破坏算例。
|
||||
|
||||
## 6. 后续 0.3.x 入口条件
|
||||
|
||||
0.3.x 建议从以下方向开始:
|
||||
|
||||
1. 完整 edge fallback 验收;
|
||||
2. 四边形接触一致性补强;
|
||||
3. 壳厚度几何和接触距离补强;
|
||||
4. contact persistence 初步;
|
||||
5. 真实 SPHLite/FEMLite adapter 的 1 step 和 100 step 空耦合 gate。
|
||||
|
||||
0.3.x 开发不得把 0.2.x 的 `CONTROLLED_PROTOCOL_GAP` 解释为真实外部物理联调已经完成。
|
||||
@@ -45,6 +45,8 @@ CCLite 负责 SPHLite 与 FEMLite 之间的数据交换、接触/耦合算法和
|
||||
|
||||
## 2.1 源码目录
|
||||
|
||||
本节给出长期推荐结构。0.2.10 当前实现已按职责拆分,但目录名以现有仓库为准,见 2.3。
|
||||
|
||||
```text
|
||||
CCLite/
|
||||
├── Makefile
|
||||
@@ -115,7 +117,30 @@ CCLite/
|
||||
└── docs/
|
||||
```
|
||||
|
||||
## 2.2 命名约定
|
||||
## 2.2 0.2.10 当前实现目录
|
||||
|
||||
0.2.10 发布候选中的实际源码边界为:
|
||||
|
||||
```text
|
||||
src/
|
||||
app/ cclite 主程序入口
|
||||
common/ 版本、错误码和日志
|
||||
case/ .inp 解析、case model 和校验
|
||||
controller/ worker 调度、step loop、接触流程和诊断调用
|
||||
diagnostics/ run.log、ipc、candidate、contact 和 force balance 输出
|
||||
geometry/ Vec3、AABB、最近点和基础几何
|
||||
search/ uniform hash grid 和候选对
|
||||
contact/ 窄相接触和 penalty force
|
||||
transfer/ SPH/FEM interface view 与 load buffer
|
||||
interface_data/ command block、data block 和 AoR v1 record
|
||||
ipc/ Windows shared memory 和 named event
|
||||
platform/ worker 进程启动、等待和终止
|
||||
mock_workers/ mock SPH/FEM worker service
|
||||
```
|
||||
|
||||
0.2.10 不把接触算法写入 SPHLite 或 FEMLite 内部;真实 worker 接入仍由 `docs/07_real_worker_access_audit.md` 中的 adapter gate 管理。
|
||||
|
||||
## 2.3 命名约定
|
||||
|
||||
```text
|
||||
ccl_ Fortran procedure/module 前缀
|
||||
@@ -1103,4 +1128,3 @@ Windows API、句柄、事件、共享内存映射只在 IPC 层出现。接触
|
||||
# 18. 总结
|
||||
|
||||
CCLite 详细设计以三独立进程和本机共享内存为核心:CCLite 负责主控与接触算法,SPHLite/FEMLite 负责各自求解。Fortran95 保持算法核心简洁稳定,Fortran2018 与 C/C++ 薄层承担共享内存和 IPC。第一版交付重点是 `.inp` 主控、Windows/gfortran 通信闭环、显式同步 SPH-FEM penalty 接触和完整诊断。
|
||||
|
||||
|
||||
@@ -113,8 +113,8 @@ CCLite 负责创建和销毁所有共享内存和 named event。求解器 worker
|
||||
示例:
|
||||
|
||||
```text
|
||||
CCLITE_CASE001_COMMAND_SPH
|
||||
CCLITE_CASE001_COMMAND_FEM
|
||||
CCLITE_CASE001_CCL_COMMAND_SPH
|
||||
CCLITE_CASE001_CCL_COMMAND_FEM
|
||||
CCLITE_CASE001_SPH_TO_CCL_PARTICLE
|
||||
CCLITE_CASE001_FEM_TO_CCL_FACET
|
||||
CCLITE_CASE001_CCL_TO_SPH_FORCE
|
||||
@@ -149,6 +149,13 @@ femlite.exe --cclite-worker --solver-id FEM --case femlite.inp --ipc-name CCLITE
|
||||
| `--workdir` | 否 | worker 工作目录 |
|
||||
| `--timeout-ms` | 否 | worker 默认等待超时 |
|
||||
|
||||
0.2.10 实现状态:
|
||||
|
||||
1. CCLite mock worker 已按本文档 generic command/data block 完成 0.1.x 空耦合和 0.2.x 基础接触验收;
|
||||
2. 真实 SPHLite/FEMLite worker 已可进行能力查询和真实 IPC attach 探测;
|
||||
3. 真实 worker 与 CCLite generic block 之间仍需 solver-specific adapter;
|
||||
4. `V020_SINGLE_REAL_WORKER_SMOKE` 当前结果为 `CONTROLLED_PROTOCOL_GAP`,不得解释为真实外部进程物理联调完成。
|
||||
|
||||
## 3.2 worker 行为
|
||||
|
||||
worker 模式下,求解器不得自行完整运行到结束,而是等待 CCLite 命令。
|
||||
|
||||
@@ -1849,7 +1849,9 @@ FSI 算例应优先使用小规模、可解释模型,避免过早使用复杂
|
||||
3. 单粒子撞刚性面;
|
||||
4. 多粒子压平面;
|
||||
5. 力平衡测试;
|
||||
6. CCLite + 至少一个真实 worker 集成测试。
|
||||
6. `V020_SINGLE_REAL_WORKER_SMOKE`:至少一条真实 worker 路径通过,或输出包含阻塞字段的 `CONTROLLED_PROTOCOL_GAP` 报告。
|
||||
|
||||
0.2.x 的 A 层算法验收以 mock worker 为主。真实 worker gate 用于防止接口风险被隐藏;在 adapter 通过前,不把 `supports_real_ipc=yes` 解释为真实 SPH-FEM 外部物理联调完成。
|
||||
|
||||
## 11.3 0.3.x 壳、边缘与四边形接触
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
## 1. 审计结论
|
||||
|
||||
CCLite 0.2.9 将真实 worker 审计提升为 `V020_SINGLE_REAL_WORKER_SMOKE` gate。该 gate 的目的不是声明真实 SPHLite/FEMLite 外部进程物理联调完成,而是确认当前 worker 能力、统一入口、协议差异和后续 adapter 缺口。
|
||||
CCLite 0.2.9 将真实 worker 审计提升为 `V020_SINGLE_REAL_WORKER_SMOKE` gate。0.2.10 发布候选继续复用该 gate 作为真实 worker 接入边界。该 gate 的目的不是声明真实 SPHLite/FEMLite 外部进程物理联调完成,而是确认当前 worker 能力、统一入口、协议差异和后续 adapter 缺口。
|
||||
|
||||
当前结论为:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user