Release SPHLite 0.8.3
This commit is contained in:
@@ -4,7 +4,7 @@
|
||||
|
||||
## 1. 架构概览
|
||||
|
||||
SPHLite 采用与 FEMLite 一致的 Fortran 95 风格过程式模块架构。核心求解器使用 Fortran 编写并遵守 Fortran 95 规范;C API/ABI、C++ 薄包装和 Python API 作为接口层提供,不作为核心求解实现语言。
|
||||
SPHLite 算法核心采用与 FEMLite 一致的 Fortran 95 风格过程式模块架构。`sphlite_core` 内的求解器、粒子/单元语义、材料、物理模块、数据库、输入解析、显式求解器和 Fortran API 继续遵守 Fortran 95 规范;worker、CLI、IPC 等外围集成层及其测试/工具性 Fortran 代码可放宽到 Fortran 2018。C API/ABI、C++ 薄包装和 Python API 作为接口层提供,不作为核心求解实现语言。
|
||||
|
||||
推荐的数据流:
|
||||
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
|
||||
## 1. 设计原则
|
||||
|
||||
SPHLite 核心使用 Fortran 95 实现,详细设计采用集中数组数据库和过程式模块协作方式。核心状态集中存放在 `sph_database` 一类模块中,物理模块围绕数据库读取通用状态、维护自身派生状态,并通过显式求解器推进。
|
||||
SPHLite 算法核心使用 Fortran 95 实现,详细设计采用集中数组数据库和过程式模块协作方式。核心状态集中存放在 `sph_database` 一类模块中,物理模块围绕数据库读取通用状态、维护自身派生状态,并通过显式求解器推进。求解器、粒子/单元语义、材料和物理模块不得引入 Fortran 2018 语法;worker、CLI、IPC 等外围集成层及其测试/工具性 Fortran 代码允许使用 Fortran 2018。
|
||||
|
||||
SPHLite 不采用面向对象的粒子类设计。输入文件中的 `*NODE` id 作为 external id 读取,数据库内部统一按 particle 管理。
|
||||
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
|
||||
## 1. 接口原则
|
||||
|
||||
SPHLite 核心使用 Fortran 95 实现。公共接口分层如下:
|
||||
SPHLite 算法核心使用 Fortran 95 实现,包括求解器、粒子/单元语义、材料和物理模块;worker、CLI、IPC 等外围集成层及其测试/工具性 Fortran 代码可放宽到 Fortran 2018。公共接口分层如下:
|
||||
|
||||
- Fortran API:核心主接口,由 Fortran 模块提供。
|
||||
- C ABI:长期稳定公共接口,统一使用 `sphlite_` 前缀。
|
||||
@@ -165,7 +165,7 @@ SPHLite 不直接依赖 FEMLite,也不依赖外部 CouplingModule。C ABI 中
|
||||
|
||||
CouplingInterface 使用中立命名,必须支持每步交换。
|
||||
|
||||
0.8.1/0.8.2 当前稳定 C ABI 清单:
|
||||
0.8.1/0.8.2/0.8.3 当前稳定 C ABI 清单:
|
||||
|
||||
```c
|
||||
int sphlite_coupling_get_region_count(int *count);
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
|
||||
## 1. 测试原则
|
||||
|
||||
SPHLite 测试体系仿照 FEMLite,采用 CMake + CTest + Python checker + release gate。核心求解器使用 Fortran 95,因此单元测试和模块测试以 Fortran 小程序为主。C ABI、C++ wrapper、Python API 和 CLI 作为接口层分别测试。
|
||||
SPHLite 测试体系仿照 FEMLite,采用 CMake + CTest + Python checker + release gate。求解器、粒子/单元语义、材料和物理模块等算法核心使用 Fortran 95;worker、CLI、IPC 等外围集成层及其测试/工具性 Fortran 代码可使用 Fortran 2018,但不得倒逼核心模块引入 Fortran 2018 语法。C ABI、C++ wrapper、Python API 和 CLI 作为接口层分别测试。
|
||||
|
||||
测试设计原则:
|
||||
|
||||
@@ -489,30 +489,34 @@ git diff --check
|
||||
|
||||
0.8.1 不验收真实 FEMLite 联合运行,不验收外部 CouplingModule/CoupleLite/CoupledLite/CouplingLite,不验收连续体一部分 FEM 一部分 SPH 的生产级连续体耦合,不验收工程级船舶水下接触爆炸舱段破坏 benchmark,不验收生产级接触搜索、接触约束、摩擦、复杂撕裂/穿孔/碎片云、焊缝失效库、大规模并行或 GPU 后端。
|
||||
|
||||
## 7.12 0.8.2 CCLite Worker Release Gate
|
||||
## 7.12 0.8.3 CCLite Worker Release Gate
|
||||
|
||||
0.8.2 默认 gate 用于 CCLite 集成预研。验收对象是 worker CLI 参数、状态/命令枚举、IPC adapter mock、命令到 SPHLite API 的映射表、v2 数据契约草案、worker 诊断格式和 CCLite mock command/data block 闭环。
|
||||
0.8.3 worker gate 用于 CCLite 集成加固。验收对象是 worker CLI 参数、capabilities 查询、状态/命令枚举、IPC adapter mock、Windows shared memory/named event self-test、命令到 SPHLite API 的映射表、AOR v1 数据契约、worker 诊断文件和 CCLite mock command/data block 闭环。
|
||||
|
||||
专项测试:
|
||||
|
||||
- `worker_protocol`
|
||||
- `worker_cli`
|
||||
- `worker_ipc`
|
||||
- `worker_ipc_selftest`
|
||||
- `worker_dispatch`
|
||||
- `worker_contract`
|
||||
- `worker_blocks`
|
||||
- `worker_reports`
|
||||
- `worker_runtime_reports`
|
||||
- `worker_mock`
|
||||
- `input_cclite_082`
|
||||
|
||||
建议命令:
|
||||
|
||||
```powershell
|
||||
ctest --test-dir build-codex-unix -R "^(worker_protocol|worker_cli|worker_ipc|worker_dispatch|worker_contract|worker_reports|worker_mock)$" --output-on-failure
|
||||
ctest --test-dir build-codex-unix -R "^(worker_protocol|worker_cli|worker_ipc|worker_ipc_selftest|worker_dispatch|worker_contract|worker_blocks|worker_reports|worker_runtime_reports|worker_mock|input_cclite_082)$" --output-on-failure
|
||||
ctest --test-dir build-codex-unix -R "^(worker|coupling_.*_08[01]|coupling_source_size_08[01])" --output-on-failure
|
||||
```
|
||||
|
||||
2026-07-05 本地结果:完整 CTest 196/196 通过,worker/coupling 专项 gate 56/56 通过,source size 相关 gate 9/9 通过,`git diff --check` 通过。无限水域爆炸示例脚本生成 VTU/PVD,`tools/publish_to_cclite.bat` dry run 通过。
|
||||
2026-07-05 本地结果:完整 CTest 200/200 通过,worker/coupling 专项 gate 55/55 通过,source size 相关 gate 9/9 通过,`git diff --check` 通过。无限水域爆炸示例脚本生成 VTU/PVD,`tools/publish_to_cclite.bat -TargetRoot ..\CCLite\SPHLite` 实际发布通过。
|
||||
|
||||
该 gate 不验收真实 Windows shared memory/named event IPC,不验收真实 CCLite 进程联调,不验收 FEM-SPH 接触搜索、接触约束、摩擦、tied/release 物理作用或生产级 FSI。
|
||||
该 gate 已验收 SPHLite 侧 Windows shared memory/named event self-test,但不验收真实外部 CCLite 进程联调,不验收 FEM-SPH 接触搜索、接触约束、摩擦、tied/release 物理作用或生产级 FSI。
|
||||
|
||||
## 8. Source Size 门禁
|
||||
|
||||
|
||||
+48
-12
@@ -1,10 +1,10 @@
|
||||
# 09 版本历史与验收记录
|
||||
|
||||
文档状态:0.8.2 发布记录
|
||||
文档状态:0.8.3 发布记录
|
||||
|
||||
## 1. 当前状态
|
||||
|
||||
SPHLite 当前发布版本为 0.8.2 CCLite worker 集成预研版本。0.8.2 在 0.8.1 中立接触耦合接口稳定化版本基础上新增 worker CLI 骨架、IPC adapter mock、命令映射、v2 数据契约草案、worker 诊断格式和 CCLite mock 命令闭环 gate。0.8.2 不交付真实 Windows shared memory/named event IPC、真实 CCLite 进程联调、真实 FEM-SPH 接触搜索、生产级 FSI 或工程级水下接触爆炸舱段破坏 benchmark。
|
||||
SPHLite 当前发布版本为 0.8.3 CCLite worker 集成加固版本。0.8.3 在 0.8.2 worker mock 契约基础上新增能力查询、Windows shared memory/named event IPC 适配器自测、AOR v1 粒子/力数据块、contact state 导入、`*SPHLITE CCLITE` 输入开关、worker 诊断文件和 CCLite mock 命令闭环加固 gate。0.8.3 不交付真实外部 CCLite 进程联调、真实 FEM-SPH 接触搜索、生产级 FSI 或工程级水下接触爆炸舱段破坏 benchmark。
|
||||
|
||||
## 2. 规划版本线
|
||||
|
||||
@@ -680,26 +680,25 @@ cmake --build build-codex-unix
|
||||
|
||||
版本定位:
|
||||
- 0.8.2 是 CCLite worker 集成预研版本。
|
||||
- 0.8.2 只稳定 worker 入口、mockable adapter、数据契约、诊断格式和 CCLite mock command/data block,不宣称真实 IPC 或真实 CCLite 联调完成。
|
||||
- 0.8.2 稳定 worker 入口、能力查询、mockable adapter、Windows shared memory/named event attach/loop 自测、数据契约、诊断格式和 CCLite mock command/data block;不宣称真实外部 CCLite 进程联调完成。
|
||||
- 0.8.2 不改变 `STATE_0_8_1` restart schema;当前版本号更新为 0.8.2,restart 格式继续兼容 0.8.1 持久状态边界。
|
||||
|
||||
完成内容:
|
||||
- 新增 CCLite coupling manifest,记录 region、particle、facet、load、contact、motion、diagnostics 和 v2 预留字段。
|
||||
- 新增 `--cclite-worker` CLI 参数解析骨架,保留普通 CLI 行为不变;完整 worker 参数当前返回受控 `UNSUPPORTED`,不宣称真实 IPC。
|
||||
- 新增 worker 状态/命令/error code、ack 序号语义、IPC adapter mock、命令到现有 SPHLite API 的动作映射表。
|
||||
- 新增 v2 数据契约草案、valid flags、contact state 扩展、拒绝原因、per-region 诊断枚举和 boundary/ghost 预留缓存清零策略。
|
||||
- 新增 worker log、particle report、force report 格式工具,并确认 VTU/PVD 可继续用于 worker 结果复核。
|
||||
- 新增 `--cclite-worker` CLI 参数解析和 `--cclite-capabilities` 能力查询,保留普通 CLI 行为不变。
|
||||
- 新增 worker 状态/命令/error code、ack 序号语义、IPC adapter mock、Windows shared memory/named event attach/loop 自测和命令到现有 SPHLite API 的动作映射表。
|
||||
- 新增 AOR v1 粒子/力数据块、valid flags、contact state 扩展、拒绝原因、stale/repeated/nonfinite 计数、总力/总力矩统计和 boundary/ghost 预留缓存清零策略。
|
||||
- 新增 `*SPHLITE CCLITE` 输入开关、worker log、particle report、force report 输出工具,并确认 VTU/PVD 可继续用于 worker 结果复核。
|
||||
- 新增 CCLite mock command/data block 闭环,覆盖 INIT、READ_INPUT、BUILD_MODEL、EXPORT_INTERFACE、IMPORT_LOADS、ADVANCE、WRITE_OUTPUT、STOP、100 step 空耦合和异常命令。
|
||||
|
||||
不交付范围:
|
||||
- 不交付真实 Windows shared memory 或 named event IPC。
|
||||
- 不交付真实 CCLite 进程联调。
|
||||
- 不交付真实外部 CCLite 进程联调。
|
||||
- 不交付真实 FEM-SPH 接触搜索、接触约束、摩擦、tied/release 物理作用或生产级 FSI。
|
||||
|
||||
验收结果:
|
||||
- `cmake --build build-codex-unix --parallel` 通过。
|
||||
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:196/196。
|
||||
- worker/coupling 专项 gate 通过:56/56。
|
||||
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:200/200。
|
||||
- worker/coupling 专项 gate 通过:55/55。
|
||||
- source size 相关 gate 通过:9/9。
|
||||
- `git diff --check` 通过。
|
||||
- `examples/infinite_underwater_explosion` 双击脚本验证通过,并生成 VTU/PVD。
|
||||
@@ -715,10 +714,47 @@ Pre-research CCLite worker integration contract
|
||||
|
||||
- add CCLite coupling manifest, worker protocol, IPC adapter mock,
|
||||
API mapping, diagnostics format and mock command loop
|
||||
- add worker CLI skeleton with controlled unsupported IPC path
|
||||
- add worker CLI, capabilities and Windows IPC self-test path
|
||||
- add worker and coupling regression gates; keep ordinary CLI behavior intact
|
||||
```
|
||||
|
||||
### 0.8.3 发布记录
|
||||
|
||||
记录日期:2026-07-05
|
||||
|
||||
本地构建目录:`build-codex-unix`
|
||||
|
||||
版本定位:
|
||||
- 0.8.3 是 CCLite worker 集成加固版本。
|
||||
- 0.8.3 将算法核心继续约束为 Fortran 95,worker、CLI、IPC 等外围集成层可放宽到 Fortran 2018。
|
||||
- 0.8.3 在 0.8.2 worker mock 契约基础上,完成 SPHLite 侧 Windows shared memory/named event attach/loop self-test、AOR v1 粒子/力数据块、contact state 导入和 worker 诊断文件。
|
||||
- 0.8.3 不改变 `STATE_0_8_1` restart schema;当前版本号更新为 0.8.3,restart 格式继续兼容 0.8.1 持久状态边界。
|
||||
|
||||
完成内容:
|
||||
- `--cclite-capabilities` 输出 solver、worker、IPC backend、command block version、data layout、平台相关 `supports_real_ipc` 和记录容量。
|
||||
- Windows 构建下新增 shared memory/named event attach、READY、命令 ack、DONE、STOP、timeout 和异常输入 self-test;非 Windows 平台仍返回受控 unsupported。
|
||||
- 新增 AOR v1 particle/force block 校验,覆盖 external id、export/internal index、valid flags、stale/repeated/nonfinite 拒绝、contact state 和总力/总力矩统计。
|
||||
- 新增 `*SPHLITE CCLITE` 输入关键词,提供 worker、region、export radius/sound speed、contact/boundary accept 开关。
|
||||
- 新增 worker runtime report 文件写入和路径管理,完善 worker log、particle report 和 force report。
|
||||
- 更新 README、06/09/11/12 号文档、worker protocol、IPC adapter、diagnostics、API mapping 和 coupling manifest。
|
||||
|
||||
不交付范围:
|
||||
- 不交付真实外部 CCLite 进程联调。
|
||||
- 不交付真实 FEM-SPH 接触搜索、接触约束、摩擦、tied/release 物理作用或生产级 FSI。
|
||||
- 不交付生产级 CCLite 载荷求解或工程级船舶水下接触爆炸舱段破坏 benchmark。
|
||||
|
||||
验收结果:
|
||||
- `cmake --build build-codex-unix --parallel` 通过。
|
||||
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:200/200。
|
||||
- worker/coupling 专项 gate 通过:55/55。
|
||||
- source size 相关 gate 通过:9/9。
|
||||
- `git diff --check` 通过。
|
||||
- `examples/infinite_underwater_explosion` 双击脚本验证通过,并生成 VTU/PVD。
|
||||
- `tools/publish_to_cclite.bat -TargetRoot ..\CCLite\SPHLite` 实际发布通过,目标 manifest 版本为 0.8.3。
|
||||
|
||||
发布记录:
|
||||
- 0.8.3 于 2026-07-05 完成本地发布 gate,并准备提交、标记 `v0.8.3` 和推送。
|
||||
|
||||
后续每个版本应记录:
|
||||
|
||||
- 完成能力。
|
||||
|
||||
@@ -1,10 +1,10 @@
|
||||
# 11 Benchmark 与验收矩阵
|
||||
|
||||
文档状态:0.8.2 发布 gate 记录
|
||||
文档状态:0.8.3 发布 gate 记录
|
||||
|
||||
## 1. 当前状态
|
||||
|
||||
0.8.2 在 0.8.1 SPHLite 侧中立接触耦合接口稳定化 gate 基础上新增 CCLite worker 集成预研 gate。0.8.2 仍不作为真实 Windows shared memory/named event IPC、真实 CCLite 进程联调、真实 FEMLite 联合运行、连续体耦合或工程级水下接触爆炸 benchmark。
|
||||
0.8.3 在 0.8.2 CCLite worker mock 契约基础上新增 SPHLite 侧 Windows shared memory/named event self-test、AOR v1 粒子/力数据块、contact state 导入、`*SPHLITE CCLITE` 输入和 worker 诊断 gate。0.8.3 仍不作为真实外部 CCLite 进程联调、真实 FEMLite 联合运行、连续体耦合或工程级水下接触爆炸 benchmark。
|
||||
|
||||
## 2. 0.1.0 Release Gate
|
||||
|
||||
@@ -511,26 +511,30 @@
|
||||
|---|---|---|
|
||||
| 2026-07-04 | `build-codex-unix` | 完整 CTest 189/189 通过,0.8.1 coupling 专项 gate 26/26 通过,0.8.0 coupling 回归 gate 24/24 通过,Water/Gas/Explosive/Solid/Shell 分类 gate 6/6、19/19、29/29、33/33、14/14 通过,0.7.0 blast 回归 gate 15/15 通过,0.7.1 blast 专项 gate 11/11 通过,source size 相关 gate 9/9 通过,`git diff --check` 通过 |
|
||||
|
||||
## 2.17 0.8.2 Release Gate
|
||||
## 2.17 0.8.3 Release Gate
|
||||
|
||||
0.8.2 默认 gate 在 0.8.1 中立耦合接口稳定化版本之上验收 CCLite worker 集成预研能力。该 gate 只验收 worker 入口、mockable IPC adapter、命令映射、数据契约、诊断格式和 CCLite mock command/data block,不验收真实 IPC、真实 CCLite 进程联调或生产级 FSI。
|
||||
0.8.3 默认 gate 在 0.8.2 worker mock 契约版本之上验收 CCLite worker 集成加固能力。该 gate 验收 worker 入口、capabilities 查询、mockable IPC adapter、SPHLite 侧 Windows shared memory/named event 自测、命令映射、AOR v1 数据块、诊断文件和 CCLite mock command/data block,不验收真实外部 CCLite 进程联调或生产级 FSI。
|
||||
|
||||
| 测试名 | 类型 | 验收点 |
|
||||
|---|---|---|
|
||||
| `worker_protocol` | C worker | worker state、command、error code 和 ack 语义 |
|
||||
| `worker_cli` | C worker | `--cclite-worker` 参数解析、缺失/冲突错误和默认值 |
|
||||
| `worker_ipc` | C worker | IPC adapter mock、READY/DONE、wait/signal、timeout 和禁止 reset |
|
||||
| `worker_ipc_selftest` | C worker | Windows shared memory/named event attach、READY、命令 ack、STOP、超时和异常输入 |
|
||||
| `worker_dispatch` | C worker | worker 命令到现有 SPHLite API 动作映射 |
|
||||
| `worker_contract` | C worker | v2 字段、valid flags、contact state、拒绝原因和 boundary/ghost 清零 |
|
||||
| `worker_reports` | C worker | worker log、particle report、force report 和 VTU/PVD 复核边界 |
|
||||
| `worker_blocks` | C worker | AOR v1 粒子/force 数据块、stale/repeated/nonfinite 拒绝和总力/总力矩统计 |
|
||||
| `worker_reports` | C worker | worker log、particle report、force report 格式化与文件写入边界 |
|
||||
| `worker_runtime_reports` | C worker | worker runtime 诊断文件 header、追加记录和路径管理 |
|
||||
| `worker_mock` | C worker | CCLite mock command/data block、100 step 空耦合和异常命令 |
|
||||
| `input_cclite_082` | Fortran input | `*SPHLITE CCLITE` worker/region/export/accept 开关和错误路径 |
|
||||
|
||||
0.8.2 不改变 `STATE_0_8_1` restart schema,不验收真实 shared memory/named event IPC、真实 CCLite 进程联调、FEM-SPH 接触搜索、接触约束、摩擦、tied/release 物理作用或生产级 FSI。
|
||||
0.8.3 不改变 `STATE_0_8_1` restart schema,不验收真实外部 CCLite 进程联调、FEM-SPH 接触搜索、接触约束、摩擦、tied/release 物理作用或生产级 FSI。
|
||||
|
||||
本地验收记录:
|
||||
| 日期 | 构建目录 | 结果 |
|
||||
|---|---|---|
|
||||
| 2026-07-05 | `build-codex-unix` | 完整 CTest 196/196 通过,worker/coupling 专项 gate 56/56 通过,source size 相关 gate 9/9 通过,`git diff --check` 通过;无限水域爆炸示例生成 VTU/PVD,发布脚本 dry run 通过 |
|
||||
| 2026-07-05 | `build-codex-unix` | 完整 CTest 200/200 通过,worker/coupling 专项 gate 55/55 通过,source size 相关 gate 9/9 通过,`git diff --check` 通过;无限水域爆炸示例生成 VTU/PVD,发布脚本实际发布到 `..\CCLite\SPHLite` 通过 |
|
||||
|
||||
## 3. 基础数值矩阵
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
文档状态:建议稿
|
||||
|
||||
本文从 `..\CCLite\sphlite_suggests.md` 提取建议,并按 SPHLite 当前 0.8.2 能力进行修订。原文件中许多 0.1.x/0.2.x 的“起步改造”在 SPHLite 侧已经由 0.8.0/0.8.1 的 `CouplingInterface` 和 0.8.2 worker mock 契约覆盖,因此本文不再原样沿用版本号,而是按“现状、缺口、建议路线和验收”重新组织。
|
||||
本文从 `..\CCLite\sphlite_suggests.md` 提取建议,并按 SPHLite 当前 0.8.3 能力进行修订。原文件中许多 0.1.x/0.2.x 的“起步改造”在 SPHLite 侧已经由 0.8.0/0.8.1 的 `CouplingInterface`、0.8.2 worker mock 契约和 0.8.3 worker IPC self-test 覆盖,因此本文不再原样沿用版本号,而是按“现状、缺口、建议路线和验收”重新组织。CCLite 0.1.9 审计新增的“真实 worker 接入闭环”建议已在第 13 节逐条响应。
|
||||
|
||||
## 1. 总体结论
|
||||
|
||||
@@ -23,9 +23,9 @@ SPHLite 独立求解器
|
||||
|
||||
## 2. 当前 SPHLite 基线
|
||||
|
||||
截至 0.8.2,SPHLite 已具备以下与 CCLite 集成相关的基础:
|
||||
截至 0.8.3,SPHLite 已具备以下与 CCLite 集成相关的基础:
|
||||
|
||||
- Fortran 95 核心求解器,C ABI、C++ 薄包装、Python `ctypes` 和 CLI 均可用。
|
||||
- Fortran 95 算法核心求解器,C ABI、C++ 薄包装、Python `ctypes` 和 CLI 均可用;worker、CLI、IPC 等外围集成层及其测试/工具性 Fortran 代码可放宽到 Fortran 2018。
|
||||
- `*SPHLITE COUPLING REGION` 输入已支持 `TYPE=CONTACT/CONTINUUM`。
|
||||
- coupling region 已支持 `EXPORT=PARTICLE/FACET/BOTH`。
|
||||
- 外部导入已支持 `IMPORT=FORCE/FACET_LOAD/MOTION`。
|
||||
@@ -36,12 +36,12 @@ SPHLite 独立求解器
|
||||
- C ABI 已提供 region info、region modes、粒子导出、facet proxy 导出、粒子力、facet load、facet pressure/traction/resultant、contact state、motion boundary、load balance 和 coupling diagnostics。
|
||||
- 输出侧已具备 CSV、summary CSV、VTU、PVD 和 restart。
|
||||
- 0.8.0/0.8.1 coupling release gate 已覆盖 mock coupling、输出、restart、Fortran/C/C++/Python/CLI 接口和 source size。
|
||||
- 0.8.2 worker release gate 已覆盖 worker CLI、协议、IPC mock、命令映射、v2 契约、诊断格式和 CCLite mock command/data block。
|
||||
- 0.8.3 worker release gate 已覆盖 worker CLI、能力查询、协议、IPC mock、Windows shared memory/named event self-test、命令映射、AOR v1 粒子/力数据块、诊断文件和 CCLite mock command/data block。
|
||||
|
||||
当前仍未交付的内容:
|
||||
|
||||
- CCLite worker/service IPC 模式。
|
||||
- Windows shared memory 与 named event 的打开、等待和响应。
|
||||
- 真实外部 CCLite worker/service 进程联调。
|
||||
- 由 CCLite 生产调度的 shared memory/named event 跨进程闭环。
|
||||
- 与真实 CCLite 进程的联合运行。
|
||||
- 真实 SPH-FEM 接触搜索、接触约束、摩擦、tied/release 和生产级 FSI。
|
||||
- 连续体一部分 FEM、一部分 SPH 的生产级强耦合。
|
||||
@@ -136,7 +136,7 @@ while true:
|
||||
|
||||
worker 只 wait/signal,不 reset event。event 生命周期和 shared memory 生命周期由 CCLite 持有。
|
||||
|
||||
当前 worker 入口参数、状态枚举、命令枚举、ack 序号和错误码记录在 [CCLite Worker Protocol](cclite_worker_protocol.md)。IPC 句柄、READY/DONE、wait/signal 和错误路径记录在 [CCLite Worker IPC Adapter](cclite_worker_ipc_adapter.md)。worker 命令到现有 API 的动作映射记录在 [CCLite Worker API Mapping](cclite_worker_api_mapping.md)。诊断输出记录在 [CCLite Worker Diagnostics](cclite_worker_diagnostics.md),mock 联调覆盖记录在 [CCLite Worker Mock Plan](cclite_worker_mock_plan.md)。0.8.x 阶段只把入口、mockable adapter 和纯逻辑协议骨架稳定下来,真实 IPC 在后续阶段实现。
|
||||
当前 worker 入口参数、状态枚举、命令枚举、ack 序号和错误码记录在 [CCLite Worker Protocol](cclite_worker_protocol.md)。IPC 句柄、READY/DONE、wait/signal 和错误路径记录在 [CCLite Worker IPC Adapter](cclite_worker_ipc_adapter.md)。worker 命令到现有 API 的动作映射记录在 [CCLite Worker API Mapping](cclite_worker_api_mapping.md)。诊断输出记录在 [CCLite Worker Diagnostics](cclite_worker_diagnostics.md),mock 联调覆盖记录在 [CCLite Worker Mock Plan](cclite_worker_mock_plan.md)。0.8.x 阶段已形成 CLI、能力查询、mock adapter、Windows shared memory/named event attach/loop self-test、worker 主循环骨架和数据块诊断输出;真实外部 CCLite 进程联调与生产级接触/FSI 仍在后续阶段验收。
|
||||
|
||||
## 5. Coupling 数据契约建议
|
||||
|
||||
@@ -274,10 +274,10 @@ EXPORT_SOUND_SPEED=YES, ACCEPT_CONTACT_STATE=YES
|
||||
|
||||
### 9.2 下一阶段:CCLite worker 通信闭环
|
||||
|
||||
- 已增加 `--cclite-worker` 参数解析骨架;真实 IPC 未实现时返回受控 `UNSUPPORTED`。
|
||||
- 已实现 command block/data block 名称抽象、READY/DONE、wait/signal 和 error code 的 mock adapter;真实 shared memory/named event 仍未实现。
|
||||
- 已支持 `INIT/READ_INPUT/BUILD_MODEL/EXPORT_INTERFACE/IMPORT_LOADS/ADVANCE/WRITE_OUTPUT/STOP` 的状态/动作映射。
|
||||
- 已完成 100 step 空耦合、空/固定粒子导出、空/粒子力/facet load 导入和异常命令的 CCLite mock 联调测试。
|
||||
- 已增加 `--cclite-worker` 参数解析骨架;非 Windows 或资源缺失时返回受控 `UNSUPPORTED`/`IPC`。
|
||||
- 已实现 command block/data block 名称抽象、READY/DONE、wait/signal、error code 的 mock adapter 和 Windows shared memory/named event attach 骨架。
|
||||
- 已支持 `INIT/READ_INPUT/BUILD_MODEL/EXPORT_INTERFACE/IMPORT_LOADS/ADVANCE/WRITE_OUTPUT/STOP` 的状态/动作映射,并接入粒子导出、粒子力导入、contact state 导入和 worker diagnostics 输出。
|
||||
- 已完成 100 step 空耦合、空/固定粒子导出、空/粒子力/contact state 导入和异常命令的 CCLite mock 联调测试,并完成 SPHLite 侧 Windows IPC self-test。
|
||||
- 已通过普通 CLI 回归,C ABI、C++ wrapper 和 Python wrapper 仍保持原有路径。
|
||||
|
||||
### 9.3 后续:数据契约 v2
|
||||
@@ -361,3 +361,45 @@ EXPORT_SOUND_SPEED=YES, ACCEPT_CONTACT_STATE=YES
|
||||
- CCLite 接触算法核心。
|
||||
- 生产级摩擦/绑定/释放约束。
|
||||
- 外部耦合模块的调度器。
|
||||
|
||||
## 13. 新增建议逐条响应
|
||||
|
||||
`..\CCLite\sphlite_suggests.md` 第 15 节新增建议的核心判断是:SPHLite 0.8.2 已具备 worker 参数识别和 mock 契约,但真实 Windows shared memory/named event IPC worker 尚未闭合。0.8.3 已补齐 SPHLite 侧 Windows IPC self-test;真实外部 CCLite 进程联调仍需由 CCLite gate 验收。SPHLite 的修订响应如下。
|
||||
|
||||
| 新建议 | SPHLite 修订响应 | 状态与落点 |
|
||||
| --- | --- | --- |
|
||||
| 完整支持 CCLite 标准 worker 参数 | 保留 `--cclite-worker --solver-id SPH --case sphlite.inp --ipc-name ... --timeout-ms ...` 作为正式入口,普通 CLI 行为不得变化;参数缺失、冲突和未知参数应返回受控错误。 | 0.8.3 已完成参数骨架、mock 测试和 SPHLite 侧 Windows IPC self-test;真实外部 CCLite 进程联调继续加严校验。 |
|
||||
| 实现真实 IPC worker 主循环 | 新增 Windows IPC adapter,打开 CCLite 创建的 command block、data block、command event 和 done event;非 Windows 平台返回明确 unsupported。 | 已完成 SPHLite 侧 attach/loop self-test;真实外部 CCLite 进程联调仍待验收。 |
|
||||
| READY 与命令 ack 回写 | worker 启动后写入 `READY`;每条命令后回写 `ack_seq`、`worker_state`、`error_code` 和短消息。 | 已写入共享内存命令块,并由 Windows IPC self-test 覆盖。 |
|
||||
| 只 wait/signal,不 reset event | SPHLite 只等待 command event、触发 done event;event reset、创建和销毁由 CCLite 持有。 | 作为不可破坏边界写入 worker gate。 |
|
||||
| 优先闭合 `SPH_TO_CCL_PARTICLE` | 共享内存数据块先支持空粒子和固定粒子,再映射真实 coupling region 粒子导出;字段以 `cclite_coupling_manifest.md` 为准。 | 已实现 particle AOR v1 数据块导出、校验和 particle report;facet 数据块待补。 |
|
||||
| 优先闭合 `CCL_TO_SPH_FORCE` | 共享内存导入先支持空 force block,再支持粒子力、接触状态和诊断字段;不得让 CCLite 直接写内部加速度/速度数组。 | 已实现 particle force/contact state ingest、stale/repeated/nonfinite 拒绝计数和 force report;facet load/motion 待补。 |
|
||||
| 导出粒子严格检查 | 导出前检查有限值、有效半径、有效质量、有效状态、有效 external id 和有效 internal/export index;不合格粒子计数并跳过。 | 已进入 worker block 校验和 particle report。 |
|
||||
| 导入 force record 严格检查 | 导入时检查 particle id、internal/export index、有限值、step_id、valid_flags 和重复/过期 epoch;无法匹配或非法记录拒绝并计数。 | 已进入 worker block 校验、force report 和 worker log total force/moment。 |
|
||||
| 增加能力查询入口 | 新增 `sphlite.exe --cclite-capabilities`,输出 solver、worker 支持、IPC backend、command block version、data layout、real IPC 支持状态和记录容量。 | 已实现;Windows 构建报告 `supports_real_ipc=yes`,非 Windows 构建报告 `supports_real_ipc=no`。 |
|
||||
| 增加 SPHLite 侧 self-test/smoke case | 在没有 FEMLite 的情况下验证 worker 启动、IPC attach、READY、空粒子导出、空 force 导入和 STOP 退出。 | 已增加 mock smoke 与 Windows IPC self-test。 |
|
||||
| 与 CCLite 先验收三类联调路径 | 先验收真实 SPHLite + mock FEM 的 1 step 空耦合、100 step 空耦合、异常输入/超时可控退出。 | SPHLite 提供 worker、能力查询和诊断;跨进程调度由 CCLite gate 负责。 |
|
||||
| mock 不等同真实耦合完成 | release note、测试名和能力查询必须区分 `mock worker`、`real IPC worker`、`real contact/FSI`。 | 0.8.2 可称为 SPHLite 侧 real IPC self-test 已覆盖,但不宣称真实外部 CCLite 联调或真实耦合完成。 |
|
||||
|
||||
## 14. 原始建议覆盖清单
|
||||
|
||||
为避免遗漏,原始建议 1 到 16 章按以下口径完整响应:
|
||||
|
||||
| 原始章节 | 响应 |
|
||||
| --- | --- |
|
||||
| 1 总体建议 | 采纳。SPHLite 保持独立求解器身份,只新增中立 CouplingInterface 和 worker/service adapter。 |
|
||||
| 2 必须保持的边界 | 采纳。SPHLite、CCLite 和 FEMLite 的职责边界写入第 3 节,禁止 FEMLite 私有结构进入公开 ABI。 |
|
||||
| 3 0.1.x 必要改造 | 已按 SPHLite 0.8.3 现状重映射。参数识别、mock 闭环和 SPHLite 侧 Windows IPC self-test 已完成,真实外部 CCLite 进程联调列为下一阶段最高优先级。 |
|
||||
| 4 Worker/Service 模式 | 部分完成。0.8.3 已有 CLI、协议、mock adapter、Windows IPC adapter self-test 和命令映射;真实外部 CCLite 进程联调待实现。 |
|
||||
| 5 Coupling Region 导出 | 大部分完成。当前 ABI 已支持 region 粒子和 facet proxy 导出;`body_id`、`contact_radius`、`sound_speed`、`valid_flags` 进入 v2 契约。 |
|
||||
| 6 外部载荷导入 | 大部分完成。粒子力、facet load、pressure/traction/resultant 已支持;source id、pair id、moment、valid flags 和真实 IPC 拒绝计数待补强。 |
|
||||
| 7 接触状态导入 | 部分完成。normal、gap、penetration、contact pressure 已有诊断;inactive/candidate/active/released/tied 枚举和 tied/release 映射作为后续增强。 |
|
||||
| 8 Boundary/Ghost 与 FSI 预留 | 采纳为预留能力。先冻结数据契约和 smoke gate,不在真实 IPC 前宣称生产级 FSI。 |
|
||||
| 9 输入文件建议 | 修订采纳。继续沿用现有 `*SPHLITE COUPLING REGION`,不新增重复 `SPH_REGION` 关键词;`*SPHLITE CCLITE` 仅作为未来辅助开关。 |
|
||||
| 10 API/ABI 建议 | 修订采纳。保留现有 ABI,新增字段只进入 `_v2` 或 worker shared memory 契约,数组展开沿用 caller-allocated buffer 风格。 |
|
||||
| 11 与 CCLite 版本路线配合 | 修订采纳。SPHLite 不照搬 CCLite 版本号,而按当前 0.8.x 基线、下一阶段真实 IPC 和长期 FSI 路线映射。 |
|
||||
| 12 测试建议 | 采纳并扩展。worker、coupling 数据、FSI/工程预留 gate 已列入第 10 节,真实 IPC self-test 作为新增 gate。 |
|
||||
| 13 诊断建议 | 采纳。worker log、particle report、force report、错误码、短消息、总力和总力矩已作为 worker diagnostics 输出。 |
|
||||
| 14 优先级建议 | 采纳并重排。真实 IPC 闭环、能力查询、粒子/force 校验和 CCLite mock 联调列为最高优先级。 |
|
||||
| 15 真实 worker 接入闭环 | 新增逐条响应见第 13 节。该建议是下一阶段 SPHLite 与 CCLite 集成的主线。 |
|
||||
| 16 总结 | 采纳。SPHLite 提供稳定 region 数据、外部载荷通道、FSI 字段和诊断,不嵌入 FEMLite 或 CCLite 算法核心。 |
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
文档状态:0.8.x 集成预研稿
|
||||
|
||||
本文记录 SPHLite 与 CCLite worker/service adapter 之间的当前数据契约。它不替代 05 号接口控制文档,也不要求 SPHLite 直接依赖 CCLite 或 FEMLite;它只把当前 0.8.2 可用的 coupling ABI、CLI 诊断、worker mock 契约和后续 v2 预留字段整理成可检查清单。
|
||||
本文记录 SPHLite 与 CCLite worker/service adapter 之间的当前数据契约。它不替代 05 号接口控制文档,也不要求 SPHLite 直接依赖 CCLite 或 FEMLite;它只把当前 0.8.3 可用的 coupling ABI、CLI 诊断、worker IPC self-test 契约和后续 v2 预留字段整理成可检查清单。
|
||||
|
||||
## 1. 范围复核
|
||||
|
||||
@@ -18,7 +18,7 @@ SPHLite 当前保持独立求解器定位。CCLite 负责 worker 启动、shared
|
||||
- contact state 支持法向、gap、penetration 和 contact pressure 导入诊断。
|
||||
- motion boundary 支持 velocity/position target 的 direct 模式。
|
||||
- 输出侧已具备 CSV、summary CSV、VTU、PVD 和 restart。
|
||||
- release gate 已覆盖 0.8.0/0.8.1 coupling 输入、导入、导出、restart、Fortran/C/C++/Python/CLI、0.8.2 worker mock 和 source size。
|
||||
- release gate 已覆盖 0.8.0/0.8.1 coupling 输入、导入、导出、restart、Fortran/C/C++/Python/CLI、0.8.2 worker mock、0.8.3 worker IPC self-test 和 source size。
|
||||
|
||||
当前仍不承诺的能力:
|
||||
|
||||
@@ -284,21 +284,40 @@ v2 particle export 草案字段:
|
||||
|---|---|
|
||||
| `source_id` | 数据来源,CCLite 或其他外部模块负责分配 |
|
||||
| `pair_id` | SPH-FEM 或 SPH-boundary 配对 id |
|
||||
| `body_id` | 船体部件、舱段或刚体分组 id |
|
||||
| `contact_radius` | 由 `h`、section 或接触参数计算的等效接触半径 |
|
||||
| `sound_speed` | phase/EOS 对应声速 |
|
||||
| `valid_flags` | 逐字段有效性位 |
|
||||
| `body_id` | 船体部件、舱段或刚体分组 id;当前默认 `-1` 表示未分配 |
|
||||
| `contact_radius` | 由 `h`、section 或接触参数计算的等效接触半径;worker AOR v1 临时采用 `2h`,不改变内部核函数半径 |
|
||||
| `sound_speed` | phase/EOS 对应声速;当前 worker AOR v1 没有稳定 EOS 查询时使用正占位值并通过 `valid_flags` 标识 |
|
||||
| `valid_flags` | 逐字段有效性位;当前定义覆盖 position、velocity、normal、pressure、density、sound speed、moment、interface pressure 和 interface velocity |
|
||||
|
||||
v2 force/contact/boundary 草案字段:
|
||||
|
||||
| 接口 | 新增字段 |
|
||||
|---|---|
|
||||
| particle force import v2 | `source_id`、`pair_id`、`moment[3]`、`valid_flags` |
|
||||
| contact state import v2 | `source_id`、`pair_id`、`contact_state`、`valid_flags` |
|
||||
| particle force import v2 | `source_id`、`pair_id`、`export_index`、`internal_index`、`moment[3]`、`valid_flags` |
|
||||
| contact state import v2 | `source_id`、`pair_id`、`contact_state`、`contact_normal[3]`、`contact_gap`、`contact_penetration`、`contact_pressure`、`valid_flags` |
|
||||
| boundary state import v2 | `boundary_state_id`、`ghost_state_id`、`position[3]`、`velocity[3]`、`normal[3]`、`pressure`、`density`、`sound_speed`、`interface_pressure`、`interface_velocity[3]`、`state_mode`、`valid_flags` |
|
||||
|
||||
C++ wrapper 应保留薄包装风格,把 v2 字段暴露为 POD/`std::vector` 容器;Python wrapper 应继续使用 `ctypes` caller-allocated buffer 风格,并提供 debug dict 视图。二者均不应引入 CCLite 私有类型。
|
||||
|
||||
补充约定:
|
||||
|
||||
- `source_id` 由 CCLite 或其他外部耦合模块分配,用于追踪 contact pair、facet 或边界来源;SPHLite 只保存和回显,不解释其内部结构。
|
||||
- `pair_id` 与 contact state 同步使用,用于标记同一接触对的 persistence;没有 contact state 时可为 0。
|
||||
- `moment[3]` 是 Solid/Shell 和后续壳粒子接触的预留字段;当前粒子力导入只使用 `force[3]`,但 force report 会保留 moment。
|
||||
|
||||
worker force block header 当前记录:
|
||||
|
||||
| 字段 | 含义 |
|
||||
|---|---|
|
||||
| `stale_count` | 被拒绝的过期 step force record 数量 |
|
||||
| `repeated_count` | 被拒绝的重复 force record 数量 |
|
||||
| `contact_count` | 可映射到 contact state 导入的记录数量 |
|
||||
| `total_force[3]` | 有效 force record 的导入总力 |
|
||||
| `total_moment[3]` | 有效 force record 的导入总力矩 |
|
||||
- `interface_pressure` 和 `interface_velocity[3]` 是 pressure projection/Riemann FSI 预留字段;当前不驱动生产级 FSI。
|
||||
- `sphlite_coupling_apply_boundary_states` 的草案接口只导入外部 boundary/ghost 状态,不规定 Water/Gas/Solid/Shell 如何参与邻域求和。
|
||||
- boundary/ghost 缓存容量应由后续 v2 ABI 或 worker data block 显式给出;每个 coupling step 开始前清零,避免 stale boundary state。
|
||||
|
||||
## 13. Diagnostics Draft
|
||||
|
||||
外部载荷和接触诊断扩展的目标是让每条导入记录“可追踪、可拒绝、可复现”。当前预留枚举见 `sph_worker_contract`,建议长期暴露以下类别:
|
||||
@@ -322,7 +341,7 @@ C++ wrapper 应保留薄包装风格,把 v2 字段暴露为 POD/`std::vector`
|
||||
|
||||
## 14. Boundary And Ghost Draft
|
||||
|
||||
boundary/ghost 当前是预留能力,而非生产级 FSI。`sphlite_worker_boundary_state_t` 只描述外部状态缓存和清零策略:
|
||||
boundary/ghost 当前是预留能力,而非生产级 FSI。`sphlite_worker_boundary_state_t` 只描述外部状态缓存和清零策略;`sphlite_worker_boundary_state_clear` 是当前 smoke gate,用于保证状态可以完整清零。
|
||||
|
||||
| 字段 | 语义 |
|
||||
|---|---|
|
||||
|
||||
@@ -0,0 +1,49 @@
|
||||
# SPHLite CCLite Input Keyword
|
||||
|
||||
文档状态:0.8.x worker adapter 输入关键词草案
|
||||
|
||||
`*SPHLITE CCLITE` 是 SPHLite 侧 worker 集成提示关键词。它只保存 SPHLite 对 CCLite worker 数据交换的本地偏好,不生成几何、网格或粒子,不替代 CCLite 配置文件,也不负责匹配外部 FEM 区域。
|
||||
|
||||
## 1. 语法
|
||||
|
||||
```text
|
||||
*SPHLITE CCLITE, WORKER=YES, REGION=ALL,
|
||||
EXPORT_RADIUS=YES, EXPORT_SOUND_SPEED=YES,
|
||||
ACCEPT_CONTACT_STATE=YES, ACCEPT_BOUNDARY_STATE=NO
|
||||
```
|
||||
|
||||
所有选项均在关键词行内给出;当前不读取后续数据行。
|
||||
|
||||
## 2. 选项
|
||||
|
||||
| 选项 | 默认值 | 含义 |
|
||||
|---|---|---|
|
||||
| `WORKER` | `YES` | 当前输入文件声明可用于 SPHLite worker 模式;`NO` 表示不启用该提示 |
|
||||
| `REGION` | `ALL` | SPHLite 侧 coupling region 名称;`ALL` 表示由 worker 导出全部启用 region |
|
||||
| `EXPORT_RADIUS` | `YES` | worker 粒子数据块是否导出 `contact_radius` |
|
||||
| `EXPORT_SOUND_SPEED` | `YES` | worker 粒子数据块是否导出 `sound_speed` |
|
||||
| `ACCEPT_CONTACT_STATE` | `YES` | worker 是否接受 CCLite 写入的 contact state |
|
||||
| `ACCEPT_BOUNDARY_STATE` | `NO` | boundary/ghost state 预留开关,当前只保存配置 |
|
||||
|
||||
布尔选项接受 `YES/NO`、`ON/OFF`、`TRUE/FALSE`、`1/0`。
|
||||
|
||||
## 3. 与 Coupling Region 的关系
|
||||
|
||||
- `*SPHLITE COUPLING REGION` 仍定义 SPHLite 侧导出/导入 region、集合、phase/material/section 过滤、`EXPORT`、`IMPORT`、`LOAD_MODE`、`DISTRIBUTION` 和 `CONTACT_STATE`。
|
||||
- `*SPHLITE CCLITE, REGION=...` 只引用 region 名称,不创建 region。
|
||||
- `EXPORT_RADIUS` 和 `EXPORT_SOUND_SPEED` 对应 worker AOR 粒子数据块字段。
|
||||
- `ACCEPT_CONTACT_STATE=YES` 只有在 region 自身设置 `CONTACT_STATE=IMPORT` 时才会产生实际导入。
|
||||
- `ACCEPT_BOUNDARY_STATE` 为后续 boundary/ghost/FSI 数据块预留。
|
||||
|
||||
## 4. 当前实现边界
|
||||
|
||||
当前解析结果保存到 SPHLite database:
|
||||
|
||||
- `cclite_worker_enabled`
|
||||
- `cclite_region_name`
|
||||
- `cclite_export_radius`
|
||||
- `cclite_export_sound_speed`
|
||||
- `cclite_accept_contact_state`
|
||||
- `cclite_accept_boundary_state`
|
||||
|
||||
当前 worker 数据块仍以 `cclite_coupling_manifest.md` 为准;本关键词不改变求解器时间推进、材料模型或 CouplingInterface 的数值算法。
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
文档状态:0.8.x mock 设计稿
|
||||
|
||||
本文记录 worker 命令到 SPHLite 现有 API 的映射。当前实现为动作映射表,用于保证命令分发表不遗漏关键 ABI;真实执行将在 IPC 数据块和 worker 主循环稳定后接入。
|
||||
本文记录 worker 命令到 SPHLite 现有 API 的映射。当前实现包含动作映射表和真实 IPC 主循环骨架;主循环已接入 `INIT`、`READ_INPUT`、`BUILD_MODEL`、`EXPORT_INTERFACE` 粒子数据块、`IMPORT_LOADS` 粒子力与 contact state 数据块、`ADVANCE`、`WRITE_OUTPUT` 和 `STOP` 的基础路径。
|
||||
|
||||
## 1. 命令映射
|
||||
|
||||
@@ -34,10 +34,10 @@ SPHLite API status 0 -> worker OK
|
||||
SPHLite API status 非 0 -> worker INTERNAL
|
||||
```
|
||||
|
||||
真实执行阶段应在返回 `INTERNAL` 前读取 `sphlite_get_last_error`,并把 last error 写入 worker log 和 command block error message。
|
||||
后续应在返回 `INTERNAL` 前读取 `sphlite_get_last_error`,并把 last error 写入 worker log 和 command block error message。
|
||||
|
||||
## 3. 验收边界
|
||||
|
||||
本阶段只保证命令到动作的映射完整,并提供 mock 测试。它不保证 shared memory 数据布局、真实载荷导入、真实推进或真实 CCLite 联调已经完成。
|
||||
本阶段保证命令到动作的映射完整,并提供 mock 测试和真实 IPC attach 骨架。它不保证真实 CCLite 跨进程联调、facet load/contact/motion 完整导入或生产级接触/FSI 已完成。
|
||||
|
||||
v2 预留字段、valid flags、contact state 扩展、拒绝原因和 boundary/ghost 缓存语义记录在 [CCLite Coupling Manifest](cclite_coupling_manifest.md),并由 `sph_worker_contract` 的 smoke 测试守住命名和清零策略。
|
||||
|
||||
@@ -1,43 +1,71 @@
|
||||
# CCLite Worker Diagnostics
|
||||
|
||||
文档状态:0.8.x mock 设计稿
|
||||
文档状态:0.8.x worker adapter 当前实现说明
|
||||
|
||||
本文记录 worker 诊断输出的文件名、字段和验收边界。当前实现提供格式工具和 smoke 测试,不在真实 worker 主循环中写文件。
|
||||
本文记录 worker 诊断输出的文件名、字段和验收边界。当前实现已经提供 log、particle report 和 force report 的路径解析、header 写入、记录追加和单元测试;真实跨进程 CCLite 联调仍需后续 self-test 验收。
|
||||
|
||||
## 1. 输出文件
|
||||
|
||||
| 文件 | 内容 |
|
||||
|---|---|
|
||||
| `sphlite_cclite_worker.log` | worker 启动参数、命令、ack、状态和错误 |
|
||||
| `sphlite_cclite_particle_report.csv` | 每步导出的粒子摘要 |
|
||||
| `sphlite_cclite_force_report.csv` | 每步接收的外部力/力矩和拒绝原因 |
|
||||
| `sphlite_cclite_worker.log` | worker 启动参数、IPC 名称、命令、ack、状态、导出/导入计数、总力、总力矩和错误信息 |
|
||||
| `sphlite_cclite_particle_report.csv` | 每次 `EXPORT_INTERFACE` 导出的粒子摘要和拒绝原因 |
|
||||
| `sphlite_cclite_force_report.csv` | 每次 `IMPORT_LOADS` 接收的外部力、力矩、接触状态和拒绝原因 |
|
||||
|
||||
路径规则:
|
||||
|
||||
- `--log` 指向 worker log 文件。
|
||||
- particle report 和 force report 默认写入 `--log` 所在目录。
|
||||
- 未提供 `--log` 时使用当前工作目录下的默认文件名。
|
||||
|
||||
## 2. Worker Log 字段
|
||||
|
||||
```text
|
||||
solver_id,command_block,data_prefix,command_id,step_id,ack_sequence,
|
||||
solver_id,case_file,ipc_name,command_block,data_prefix,command_event,
|
||||
done_event,timeout_ms,worker_id,command_id,step_id,ack_sequence,
|
||||
worker_state,exported_particles,exported_facets,received_forces,
|
||||
error_code,error_message
|
||||
total_fx,total_fy,total_fz,total_mx,total_my,total_mz,
|
||||
nonfinite_particles,error_code,error_message
|
||||
```
|
||||
|
||||
这些字段覆盖启动参数日志、command/data block 名称、command id、step id、ack seq、worker state、导出数量、接收 force 数量以及错误码/错误消息。
|
||||
说明:
|
||||
|
||||
- `command_block`、`data_prefix`、`command_event`、`done_event` 来自 worker IPC adapter。
|
||||
- `exported_particles` 来自粒子数据块 header。
|
||||
- `exported_facets` 当前保留为 0,等待 facet 数据块接入。
|
||||
- `received_forces`、`total_force` 和 `total_moment` 来自 force 数据块分析结果。
|
||||
- `nonfinite_particles` 记录导出粒子状态非有限拒绝计数。
|
||||
- `error_code` 和 `error_message` 记录启动、READY、命令执行和异常退出路径。
|
||||
|
||||
## 3. CSV 字段
|
||||
|
||||
particle report:
|
||||
|
||||
```text
|
||||
step_id,region_index,export_index,external_id,phase,status,
|
||||
material,section,x,y,z,vx,vy,vz
|
||||
step_id,region_index,export_index,internal_index,external_id,
|
||||
phase,status,material,section,x,y,z,vx,vy,vz,reject_reason
|
||||
```
|
||||
|
||||
force report:
|
||||
|
||||
```text
|
||||
step_id,region_index,source_id,pair_id,target_id,
|
||||
fx,fy,fz,mx,my,mz,reject_reason
|
||||
step_id,region_index,source_id,pair_id,target_id,export_index,
|
||||
internal_index,fx,fy,fz,mx,my,mz,contact_state,reject_reason
|
||||
```
|
||||
|
||||
## 4. VTK 复核
|
||||
拒绝原因使用 worker 契约中的枚举名称:
|
||||
|
||||
worker 结果复核可继续使用现有 VTU/PVD 输出。VTU/PVD 是 SPHLite 求解输出,不替代 worker log 和 CSV 诊断。
|
||||
- `unmatched_particle`
|
||||
- `nonfinite_force`
|
||||
- `nonfinite_contact`
|
||||
- `invalid_weight`
|
||||
- `stale_epoch`
|
||||
- `repeated_import`
|
||||
|
||||
## 4. 当前边界
|
||||
|
||||
- worker 已能把有效 particle force 映射到 `sphlite_coupling_apply_particle_forces`。
|
||||
- worker 已能把 active/candidate/tied contact state 映射到 `sphlite_coupling_apply_contact_state`。
|
||||
- stale step、重复 force record、非有限值和无效权重会在进入 CouplingInterface 前拒绝并计数。
|
||||
- facet export、facet load 和 motion boundary 的真实数据块仍是后续工作。
|
||||
- VTU/PVD 仍是 SPHLite 求解输出复核手段,不替代 worker log 和 CSV 诊断。
|
||||
|
||||
@@ -1,14 +1,15 @@
|
||||
# CCLite Worker IPC Adapter
|
||||
|
||||
文档状态:0.8.x mock 设计稿
|
||||
文档状态:0.8.x IPC 骨架说明
|
||||
|
||||
本文记录 SPHLite 侧 worker IPC adapter 的边界。当前实现是 mockable adapter,不打开真实 Windows shared memory 或 named event;真实 IPC 后续实现时应复用这里的句柄、状态和错误路径。
|
||||
本文记录 SPHLite 侧 worker IPC adapter 的边界。当前实现保留 mockable adapter,并新增 Windows shared memory/named event attach、wait、signal 和 close 路径;Windows 构建的能力查询报告 `supports_real_ipc=yes`,非 Windows 构建仍报告 `supports_real_ipc=no`。真实外部 CCLite 进程联调仍未验收。
|
||||
|
||||
## 1. 模块边界
|
||||
|
||||
IPC adapter 只负责:
|
||||
|
||||
- 保存 command block、data block、command event 和 done event 名称。
|
||||
- 打开 CCLite 预创建的 command/data shared memory 和 named event。
|
||||
- 写入 `READY` 和 `DONE` 状态。
|
||||
- 等待 command event。
|
||||
- signal done event。
|
||||
@@ -23,7 +24,7 @@ IPC adapter 不负责:
|
||||
|
||||
## 2. 句柄抽象
|
||||
|
||||
当前 `sphlite_worker_ipc_t` 保存以下名称:
|
||||
当前 `sphlite_worker_ipc_t` 保存以下名称和平台句柄:
|
||||
|
||||
| 字段 | 默认命名 |
|
||||
|---|---|
|
||||
@@ -33,6 +34,8 @@ IPC adapter 不负责:
|
||||
| `command_event` | `<ipc_name>.command_event` |
|
||||
| `done_event` | `<ipc_name>.done_event` |
|
||||
|
||||
真实 Windows IPC 路径只打开 CCLite 持有的资源,不创建、不 reset、不销毁 CCLite 的资源。SPHLite 仅在自身退出时关闭本进程句柄和 view。
|
||||
|
||||
调用方也可以通过 CLI 的 `--command-block` 和 `--data-prefix` 覆盖默认名称。
|
||||
|
||||
## 3. 状态流程
|
||||
@@ -60,7 +63,7 @@ loop:
|
||||
| shared memory 或 event 尚未打开 | `IPC` |
|
||||
| wait 超时 | `TIMEOUT` |
|
||||
| event reset 尝试 | `CONFLICT` |
|
||||
| Windows 真实 IPC 尚未实现 | `UNSUPPORTED` |
|
||||
| 非 Windows 真实 IPC | `IPC` |
|
||||
| Windows IPC 资源不存在或 attach 失败 | `IPC` |
|
||||
| 非 Windows 真实 IPC | `UNSUPPORTED` |
|
||||
|
||||
mock 模式用于 CTest,不代表真实 IPC 能力完成。
|
||||
mock 模式用于 CTest,不代表真实 CCLite 进程联调完成;Windows IPC self-test 只证明 SPHLite 侧可打开、等待、响应和关闭标准 IPC 资源。
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
文档状态:0.8.x worker adapter 骨架说明
|
||||
|
||||
本文记录 SPHLite 侧 CCLite worker 入口的参数、状态、命令和错误语义。当前实现只完成 CLI 解析、纯逻辑状态/命令枚举和测试;Windows shared memory、named event 和真实 CCLite 联调仍未实现。
|
||||
本文记录 SPHLite 侧 CCLite worker 入口的参数、状态、命令和错误语义。当前实现已完成 CLI 解析、能力查询、状态/命令枚举、mock 测试和 Windows shared memory/named event attach 骨架;真实 CCLite 跨进程联调、生产级接触/FSI 仍未完成。
|
||||
|
||||
## 1. CLI 参数
|
||||
|
||||
@@ -34,7 +34,15 @@ sphlite.exe model.inp --check
|
||||
sphlite.exe model.inp --run --output result
|
||||
```
|
||||
|
||||
当前所有必填 worker 参数齐全时,程序会返回受控的 `UNSUPPORTED`,表示 IPC 阶段尚未实现。
|
||||
当前所有必填 worker 参数齐全时,程序会尝试打开 CCLite 创建的 IPC 资源。若资源不存在或平台不支持,会返回受控的 `IPC` 或 `UNSUPPORTED` 错误,不退回普通 CLI。
|
||||
|
||||
能力查询:
|
||||
|
||||
```text
|
||||
sphlite.exe --cclite-capabilities
|
||||
```
|
||||
|
||||
`--cclite-capabilities` 必须单独使用,输出 key=value 能力清单。Windows 构建中 `supports_real_ipc=yes` 表示 SPHLite 侧 shared memory/named event attach、wait、signal 和 close 路径已进入 self-test;非 Windows 构建仍报告 `supports_real_ipc=no`。该标志不代表真实外部 CCLite 进程联调或生产级 FSI 已完成。
|
||||
|
||||
## 2. 状态枚举
|
||||
|
||||
@@ -54,10 +62,10 @@ sphlite.exe model.inp --run --output result
|
||||
| `INIT` | 清理 worker 侧状态;允许从 `ERROR` 恢复到可继续状态 |
|
||||
| `READ_INPUT` | 后续映射到 `sphlite_read_inp` |
|
||||
| `BUILD_MODEL` | 后续映射到 `sphlite_build_model` |
|
||||
| `EXPORT_INTERFACE` | 后续映射到 coupling region count/info、particle export 和 facet export |
|
||||
| `IMPORT_LOADS` | 后续映射到 particle force、facet pressure/traction/resultant、contact state 和 motion boundary 导入 |
|
||||
| `ADVANCE` | 后续映射到 `sphlite_advance_explicit` 或 worker 控制的子步循环 |
|
||||
| `WRITE_OUTPUT` | 后续映射到 `sphlite_write_output` |
|
||||
| `EXPORT_INTERFACE` | 映射到 coupling region count/info 和 particle export 数据块;facet export 后续补齐 |
|
||||
| `IMPORT_LOADS` | 映射到空导入、particle force 数据块和 contact state 导入;facet load 和 motion boundary 后续补齐 |
|
||||
| `ADVANCE` | 映射到 `sphlite_advance_explicit`,`dt<=0` 时使用稳定时间步估计 |
|
||||
| `WRITE_OUTPUT` | 映射到 `sphlite_write_output` |
|
||||
| `STOP` | 写入完成状态后退出 worker |
|
||||
|
||||
未知命令进入 `ERROR`,错误码为 `UNKNOWN_COMMAND`。
|
||||
|
||||
Reference in New Issue
Block a user