Files

Scottxjw 0677f2ea15 docs: 添加AnalyzeCommand使用指南并更新需求文档

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-08-25 11:30:31 +08:00

6.6 KiB

Raw Permalink Blame History

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，自动执行：

Ploss 分析 - 批量分析所有日志文件
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 外，也可直接使用命令行：

# 自动扫描 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 文件？

检查：

Datas 文件夹是否存在
日志文件扩展名是否为 .DAT 或 .log
日志文件格式是否正确

Q: Qfod 标定提示"未找到纯手机日志"？

确保文件名第7字段为 无：

正确: 奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701.log
错误: 奇瑞-E5-singleMold-A00-V001-iPhone15-硬币-qfod_pure-2026081701.log

Q: Excel 文件在哪里？

输出目录：Output/{车厂}/{车型}/{手机名}/

联系支持

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

6.6 KiB Raw Permalink Blame History Unescape Escape