239 lines
6.6 KiB
Markdown
239 lines
6.6 KiB
Markdown
# WCT DataAnalyzer 使用指南
|
||
|
||
## 快速开始
|
||
|
||
### 1. 准备日志文件
|
||
|
||
将日志文件放入 `Datas` 文件夹（与 `Gpulse.WCT.DataAnalyzer.exe` 同级目录）：
|
||
|
||
```
|
||
Gpulse.WCT.DataAnalyzer.exe
|
||
analyze.bat
|
||
Datas/
|
||
├── 奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.dat
|
||
├── 奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701.log
|
||
└── 奇瑞-E5-singleMold-A00-V001-iPhone15-硬币-qfod_foreign-2026081701.log
|
||
```
|
||
|
||
### 2. 运行分析
|
||
|
||
双击 `analyze.bat`，自动执行：
|
||
|
||
1. **Ploss 分析** - 批量分析所有日志文件
|
||
2. **Qfod 标定** - 自动配对纯手机和异物日志
|
||
|
||
```
|
||
========================================
|
||
WCT DataAnalyzer 分析工具
|
||
========================================
|
||
|
||
[1/2] 执行 Ploss 分析...
|
||
扫描 Datas 文件夹:
|
||
总计: 4 个日志文件
|
||
纯手机: 2 个
|
||
异物: 2 个
|
||
|
||
=== Ploss 分析 ===
|
||
[OK] Output\奇瑞\E5\iPhone15\奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.xlsx
|
||
...
|
||
|
||
[2/2] 执行 Qfod 标定...
|
||
扫描 Datas 文件夹:
|
||
总计: 4 个日志文件
|
||
纯手机: 2 个
|
||
异物: 2 个
|
||
|
||
=== Qfod 标定 ===
|
||
[OK] Output\奇瑞\E5\iPhone15\奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701_qfod.xlsx
|
||
...
|
||
|
||
========================================
|
||
分析完成
|
||
========================================
|
||
|
||
输出目录: ...Output
|
||
```
|
||
|
||
---
|
||
|
||
## 文件命名规范
|
||
|
||
日志文件名格式：
|
||
|
||
```
|
||
车厂-车型-TX面板-TX硬件-TX软件-RX类型-异物类型-测试目的-年月日测试次数.扩展名
|
||
```
|
||
|
||
### 字段说明
|
||
|
||
| 位置 | 字段 | 说明 | 示例 |
|
||
|-----|------|------|------|
|
||
| 1 | 车厂 | 制造商名称 | 奇瑞、比亚迪 |
|
||
| 2 | 车型 | 车型代号 | E5、汉 |
|
||
| 3 | TX面板 | 发射端面板类型 | singleMold |
|
||
| 4 | TX硬件 | 发射端硬件版本 | A00 |
|
||
| 5 | TX软件 | 发射端软件版本 | V001 |
|
||
| 6 | RX类型 | 接收端类型（手机名） | iPhone15 |
|
||
| **7** | **异物类型** | **区分纯手机/异物** | **无**=纯手机，**硬币**=异物 |
|
||
| 8 | 测试目的 | 测试类型 | ploss_test、qfod_pure |
|
||
| 9 | 日期序号 | yyyyMMddNN | 2026081701 |
|
||
|
||
> **第9段约束**：必须为连续的 8 位日期（`yyyyMMdd`）+ 序号（至少 1 位整数），**日期与序号之间无分隔符**。
|
||
> 正例：`2026081701`（2026-08-17，序号 01）、`202608172`（序号 2）。
|
||
> 反例：`20260817-01`（含分隔符，会被 FileNameParser 拒绝）、`2026-08-1701`（含短横线）。
|
||
|
||
### 异物类型（第7字段）
|
||
|
||
- `无` → 纯手机日志
|
||
- 其他值（如`硬币`、`钥匙`）→ 异物日志
|
||
|
||
---
|
||
|
||
## 分析类型
|
||
|
||
### 1. Ploss 分析
|
||
|
||
批量分析所有日志文件，生成 Excel 报告。
|
||
|
||
**输出目录结构**：
|
||
```
|
||
Output/
|
||
└── {车厂}/
|
||
└── {车型}/
|
||
└── {手机名}/
|
||
└── {原文件名}.xlsx
|
||
```
|
||
|
||
**示例**：
|
||
```
|
||
输入: Datas/奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.dat
|
||
输出: Output/奇瑞/E5/iPhone15/奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.xlsx
|
||
```
|
||
|
||
**Excel 内容**：
|
||
- 9 个功率段（350/500/750/1000/1250/1500/1750/2000/2250 W）
|
||
- 每个功率段：理论Δp、VPA
|
||
- 统计值：最大值、最小值、平均值、中位数、标定值
|
||
|
||
---
|
||
|
||
### 2. Qfod 标定
|
||
|
||
自动配对纯手机日志和异物日志，计算标定阈值。
|
||
|
||
**自动识别规则**：
|
||
- 文件名第7字段 = `无` → 纯手机日志
|
||
- 文件名第7字段 ≠ `无` → 异物日志
|
||
|
||
**输出**：
|
||
- 阈值计算：`Threshold = (纯手机ΔQ最大值 + 异物ΔQ最小值) / 2`
|
||
- 统计值：ΔQ 绝对值的最大/最小/平均/中位数
|
||
|
||
> **阈值与统计的量纲**：阈值使用**有符号 ΔQ**（纯手机为正、异物为负时阈值可为负，如样例 `Threshold: -22`）；
|
||
> 统计行（Q最大/最小/平均/中位数）使用 **|ΔQ| 绝对值**。两者刻意不同，勿混用。
|
||
|
||
---
|
||
|
||
## 命令行用法
|
||
|
||
除双击 `analyze.bat` 外，也可直接使用命令行：
|
||
|
||
```bash
|
||
# 自动扫描 Datas 文件夹并分析
|
||
Gpulse.WCT.DataAnalyzer.exe analyze --type ploss --auto
|
||
Gpulse.WCT.DataAnalyzer.exe analyze --type qfod --auto
|
||
|
||
# 指定单个文件
|
||
Gpulse.WCT.DataAnalyzer.exe analyze --type ploss --file "日志文件路径.dat"
|
||
|
||
# 指定输出路径
|
||
Gpulse.WCT.DataAnalyzer.exe analyze --type ploss --file "日志路径" --output "输出路径.xlsx"
|
||
|
||
# Qfod 标定（指定纯手机和异物日志）
|
||
Gpulse.WCT.DataAnalyzer.exe analyze --type qfod --pure "纯手机日志" --foreign "异物日志"
|
||
```
|
||
|
||
---
|
||
|
||
## 输出示例
|
||
|
||
### 默认输出文件名规则
|
||
|
||
| 命令 | 默认输出名（未指定 `--output` 时） |
|
||
|------|----------------------------------|
|
||
| Ploss | `{原文件名}.xlsx`（如 `…-ploss_test-2026081701.xlsx`） |
|
||
| Qfod | `{纯手机文件名}_qfod.xlsx`（如 `…-qfod_pure-2026081701_qfod.xlsx`，自动加 `_qfod` 后缀） |
|
||
|
||
指定 `--output/-o` 时按用户给定路径输出（父目录不存在会自动创建）。
|
||
|
||
### Ploss 分析
|
||
|
||
```
|
||
扫描 Datas 文件夹:
|
||
总计: 4 个日志文件
|
||
纯手机: 4 个
|
||
异物: 0 个
|
||
|
||
=== 批量 Ploss 分析 ===
|
||
|
||
Excel report saved to: Output\奇瑞\E5\iPhone15\奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.xlsx
|
||
|
||
=== Ploss Analysis: 奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.dat ===
|
||
Total: 35, Errors: 0
|
||
Power segments found: 350, 500, 750
|
||
|
||
[完成] 已分析 4 个文件
|
||
```
|
||
|
||
### Qfod 标定
|
||
|
||
```
|
||
扫描 Datas 文件夹:
|
||
总计: 4 个日志文件
|
||
纯手机: 2 个
|
||
异物: 2 个
|
||
|
||
=== Qfod 标定 ===
|
||
|
||
自动配对:
|
||
纯手机: 奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701.log
|
||
异物: 奇瑞-E5-singleMold-A00-V001-iPhone15-硬币-qfod_foreign-2026081701.log
|
||
|
||
Excel report saved to: Output\奇瑞\E5\iPhone15\奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701_qfod.xlsx
|
||
|
||
=== Qfod Calibration ===
|
||
Pure phone: 奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701.log
|
||
Foreign object: 奇瑞-E5-singleMold-A00-V001-iPhone15-硬币-qfod_foreign-2026081701.log
|
||
Threshold: -22
|
||
Pure margin: 27, Foreign margin: -27
|
||
```
|
||
|
||
---
|
||
|
||
## 常见问题
|
||
|
||
### Q: 没有生成 Excel 文件？
|
||
|
||
检查：
|
||
1. `Datas` 文件夹是否存在
|
||
2. 日志文件扩展名是否为 `.DAT` 或 `.log`
|
||
3. 日志文件格式是否正确
|
||
|
||
### Q: Qfod 标定提示"未找到纯手机日志"？
|
||
|
||
确保文件名第7字段为 `无`：
|
||
```
|
||
正确: 奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701.log
|
||
错误: 奇瑞-E5-singleMold-A00-V001-iPhone15-硬币-qfod_pure-2026081701.log
|
||
```
|
||
|
||
### Q: Excel 文件在哪里？
|
||
|
||
输出目录：`Output/{车厂}/{车型}/{手机名}/`
|
||
|
||
---
|
||
|
||
## 联系支持
|
||
|
||
如有问题，请联系开发团队。
|