Finalize CCLite 0.1.8 release candidate
This commit is contained in:
@@ -0,0 +1,86 @@
|
||||
# CCLite 0.1.x 接口常量冻结记录
|
||||
|
||||
本文记录 0.1.x 已用于测试和 mock worker 闭环的接口常量。0.2.x 起若修改这些常量,必须同步升级 ABI/layout 并补兼容说明。
|
||||
|
||||
## 1. Worker 启动参数
|
||||
|
||||
正式参数:
|
||||
|
||||
```text
|
||||
--cclite-worker --solver-id <SPH|FEM> --case <solver.inp> --ipc-name <prefix> --timeout-ms <milliseconds>
|
||||
```
|
||||
|
||||
兼容别名:
|
||||
|
||||
1. `--ipc-prefix`:0.1.5 早期 mock worker 参数,0.1.7 起仅作为兼容;
|
||||
2. `--solver-input`:0.1.5 早期 mock worker 参数,0.1.7 起仅作为兼容。
|
||||
|
||||
## 2. Solver Id
|
||||
|
||||
| id | 名称 |
|
||||
| --- | --- |
|
||||
| 1 | `SPH` |
|
||||
| 2 | `FEM` |
|
||||
| 3 | `CCL` |
|
||||
|
||||
## 3. Command Id
|
||||
|
||||
| id | 名称 |
|
||||
| --- | --- |
|
||||
| 1 | `INIT` |
|
||||
| 2 | `READ_INPUT` |
|
||||
| 3 | `BUILD_MODEL` |
|
||||
| 4 | `EXPORT_INTERFACE` |
|
||||
| 5 | `IMPORT_LOADS` |
|
||||
| 6 | `ADVANCE` |
|
||||
| 7 | `WRITE_OUTPUT` |
|
||||
| 99 | `STOP` |
|
||||
|
||||
## 4. Worker State
|
||||
|
||||
| id | 名称 |
|
||||
| --- | --- |
|
||||
| 1 | `STARTING` |
|
||||
| 2 | `READY` |
|
||||
| 3 | `BUSY` |
|
||||
| 4 | `DONE` |
|
||||
| 5 | `ERROR` |
|
||||
| 6 | `STOPPED` |
|
||||
|
||||
## 5. Data Layout
|
||||
|
||||
| id | 名称 | 0.1.x 状态 |
|
||||
| --- | --- | --- |
|
||||
| 1 | `AOR_V1` | 已实现 |
|
||||
| 2 | `SOA_V2` | 0.8.x 预留,0.1.x 拒绝 |
|
||||
|
||||
## 6. Block Role
|
||||
|
||||
| role | 名称 | 0.1.x 状态 |
|
||||
| --- | --- | --- |
|
||||
| 101 | `SPH_TO_CCL_PARTICLE` | 已实现,mock 可写空 block |
|
||||
| 102 | `SPH_TO_CCL_FACET` | 预留 |
|
||||
| 201 | `FEM_TO_CCL_FACET` | 已实现,mock 可写空 block |
|
||||
| 301 | `CCL_TO_SPH_FORCE` | 已定义,0.1.x 写空 block |
|
||||
| 302 | `CCL_TO_FEM_LOAD` | 已定义,0.1.x 写空 block |
|
||||
| 401 | `CCL_DIAGNOSTIC` | 已定义 |
|
||||
| 901 | `CCL_COMMAND_SPH` | 已定义 |
|
||||
| 902 | `CCL_COMMAND_FEM` | 已定义 |
|
||||
|
||||
## 7. Buffer State
|
||||
|
||||
| id | 名称 |
|
||||
| --- | --- |
|
||||
| 0 | `EMPTY` |
|
||||
| 1 | `WRITING` |
|
||||
| 2 | `READY` |
|
||||
| 3 | `READING` |
|
||||
| 4 | `CONSUMED` |
|
||||
| 5 | `ERROR` |
|
||||
|
||||
## 8. 0.1.x 验收算例
|
||||
|
||||
| 算例 | 状态 |
|
||||
| --- | --- |
|
||||
| `V010_EMPTY_COUPLING` | 通过,mock SPH/FEM worker 完成 100 step 空耦合 |
|
||||
| 真实 worker gap audit | 通过,输出受控缺口报告,不声明真实 worker 已接入 |
|
||||
@@ -0,0 +1,47 @@
|
||||
# CCLite 0.1.x 发布说明
|
||||
|
||||
## 1. 发布定位
|
||||
|
||||
0.1.x 是 CCLite 的主控、通信、mock worker 和验证闭环版本。该版本完成 Windows/gfortran/本机共享内存下的工程骨架和空耦合闭环,不包含真实 SPH-FEM 接触力、摩擦、tied coupling、FSI 或 Linux/MPI 生产实现。
|
||||
|
||||
## 2. 已完成功能
|
||||
|
||||
1. `cclite` 独立主控程序;
|
||||
2. Abaqus 风格 `.inp` 解析和 `check/dry-run/run` 入口;
|
||||
3. Windows shared memory 与 named event 薄封装;
|
||||
4. command block、seq/ack、heartbeat 和 timeout;
|
||||
5. data block header、AoR v1 record 和空载荷 block;
|
||||
6. mock SPH/FEM worker service 模式;
|
||||
7. 1 step 与 100 step 空耦合集成测试;
|
||||
8. `run.log`、`ipc_report.csv`、`force_balance.csv`;
|
||||
9. Python checker 生成 `verification_report.json`;
|
||||
10. 真实 SPHLite/FEMLite worker 接入审计和受控缺口报告。
|
||||
|
||||
## 3. 验证结果
|
||||
|
||||
本地 0.1.8 验证项:
|
||||
|
||||
1. 全量 CTest 通过;
|
||||
2. `V010_EMPTY_COUPLING` checker 输出 `PASS`;
|
||||
3. UTF-8 without BOM 检查通过;
|
||||
4. 干净构建目录重建和测试通过;
|
||||
5. 真实 worker audit 输出 `CONTROLLED_GAP`。
|
||||
|
||||
## 4. 真实 worker 状态
|
||||
|
||||
当前本地审计结果:
|
||||
|
||||
1. SPHLite 0.8.2 能识别 worker CLI,但真实 Windows IPC 返回受控 unsupported;
|
||||
2. FEMLite 0.6.3 尚未识别 CCLite worker 参数;
|
||||
3. 0.1.x 的可执行验收路径仍是 CCLite mock worker;
|
||||
4. 0.2.x 前必须先在 SPHLite/FEMLite 侧补齐 worker adapter。
|
||||
|
||||
## 5. 进入 0.2.x 的条件
|
||||
|
||||
0.2.x 可以在以下基础上开发基础 penalty contact:
|
||||
|
||||
1. SPH particle 与 FEM facet AoR v1 数据布局已冻结;
|
||||
2. CCLite 可按 step 调度两个 worker;
|
||||
3. 空 force/load 写回路径已存在;
|
||||
4. checker 可自动判定通信闭环;
|
||||
5. 真实 worker 缺口已记录,不会误判为物理算法完成。
|
||||
@@ -134,8 +134,8 @@ SPHLite 和 FEMLite 必须增加 CCLite worker/service 模式。
|
||||
推荐命令行:
|
||||
|
||||
```powershell
|
||||
sphlite.exe --cclite-worker sphlite.inp --ipc-prefix CCLITE_CASE001 --solver-name SPH
|
||||
femlite.exe --cclite-worker femlite.inp --ipc-prefix CCLITE_CASE001 --solver-name FEM
|
||||
sphlite.exe --cclite-worker --solver-id SPH --case sphlite.inp --ipc-name CCLITE_CASE001 --timeout-ms 5000
|
||||
femlite.exe --cclite-worker --solver-id FEM --case femlite.inp --ipc-name CCLITE_CASE001 --timeout-ms 5000
|
||||
```
|
||||
|
||||
最小参数:
|
||||
@@ -143,9 +143,9 @@ femlite.exe --cclite-worker femlite.inp --ipc-prefix CCLITE_CASE001 --solver-nam
|
||||
| 参数 | 必填 | 含义 |
|
||||
| --- | --- | --- |
|
||||
| `--cclite-worker` | 是 | 进入 CCLite worker/service 模式 |
|
||||
| input file | 是 | 求解器自己的 `.inp` 文件 |
|
||||
| `--ipc-prefix` | 是 | CCLite 创建的共享对象前缀 |
|
||||
| `--solver-name` | 是 | `SPH` 或 `FEM` |
|
||||
| `--solver-id` | 是 | `SPH` 或 `FEM` |
|
||||
| `--case` | 是 | 求解器自己的 `.inp` 文件 |
|
||||
| `--ipc-name` | 是 | CCLite 创建的共享对象前缀 |
|
||||
| `--workdir` | 否 | worker 工作目录 |
|
||||
| `--timeout-ms` | 否 | worker 默认等待超时 |
|
||||
|
||||
|
||||
Reference in New Issue
Block a user