WCTDataMiner/docs/AnalyzeCommand使用指南.md

# 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/{车厂}/{车型}/{手机名}/`

---

## 联系支持

如有问题，请联系开发团队。