Files
SPHLite/docs/cclite_worker_diagnostics.md
T
2026-07-05 17:00:13 +08:00

44 lines
1.3 KiB
Markdown
Raw 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 Worker Diagnostics
文档状态:0.8.x mock 设计稿
本文记录 worker 诊断输出的文件名、字段和验收边界。当前实现提供格式工具和 smoke 测试,不在真实 worker 主循环中写文件。
## 1. 输出文件
| 文件 | 内容 |
|---|---|
| `sphlite_cclite_worker.log` | worker 启动参数、命令、ack、状态和错误 |
| `sphlite_cclite_particle_report.csv` | 每步导出的粒子摘要 |
| `sphlite_cclite_force_report.csv` | 每步接收的外部力/力矩和拒绝原因 |
## 2. Worker Log 字段
```text
solver_id,command_block,data_prefix,command_id,step_id,ack_sequence,
worker_state,exported_particles,exported_facets,received_forces,
error_code,error_message
```
这些字段覆盖启动参数日志、command/data block 名称、command id、step id、ack seq、worker state、导出数量、接收 force 数量以及错误码/错误消息。
## 3. CSV 字段
particle report:
```text
step_id,region_index,export_index,external_id,phase,status,
material,section,x,y,z,vx,vy,vz
```
force report:
```text
step_id,region_index,source_id,pair_id,target_id,
fx,fy,fz,mx,my,mz,reject_reason
```
## 4. VTK 复核
worker 结果复核可继续使用现有 VTU/PVD 输出。VTU/PVD 是 SPHLite 求解输出,不替代 worker log 和 CSV 诊断。