stdf-reader

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

STDF Reader Skill

STDF Reader 技能工具

This skill provides access to the STDF Reader CLI tool for parsing and analyzing semiconductor STDF test data files.

本技能工具可调用STDF Reader CLI工具，用于解析和分析半导体STDF测试数据文件。

Prerequisites

前置要求

Install via pip (python version 3.9+):

bash

pip install stdf-reader

Use the virtual environment for running any commands:

bash

source .venv/bin/activate

通过pip安装（Python版本3.9及以上）：

bash

pip install stdf-reader

使用虚拟环境运行所有命令：

bash

source .venv/bin/activate

Available Commands

可用命令

1. Convert STDF to CSV (most common)

1. 将STDF转换为CSV（最常用）

Parse one or more STDF files into a CSV log for analysis:

bash

stdf-reader convert-csv <stdf_file(s)> [-o output_name]

Options:

```
--ignore-tnum
```
— Ignore test number (match by name only)
```
--ignore-chnum
```
— Ignore channel number in test name
```
--no-merge
```
— Output separate CSV per file (default: merge into one)

Example:

bash

stdf-reader convert-csv input.stdf

将一个或多个STDF文件解析为CSV日志以便分析：

bash

stdf-reader convert-csv <stdf_file(s)> [-o output_name]

选项：

```
--ignore-tnum
```
— 忽略测试编号（仅按名称匹配）
```
--ignore-chnum
```
— 忽略测试名称中的通道编号
```
--no-merge
```
— 每个文件输出单独的CSV（默认：合并为一个）

示例：

bash

stdf-reader convert-csv input.stdf

Output: input.stdf_csv_log.csv

输出：input.stdf_csv_log.csv

stdf-reader convert-csv lot1.stdf lot2.stdf -o merged_output

Output: merged_output_csv_log.csv

输出：merged_output_csv_log.csv

undefined

undefined

2. Convert STDF to XLSX

2. 将STDF转换为XLSX

Parse STDF file into a formatted Excel table (shows all record types):

bash

stdf-reader convert-xlsx <stdf_file>

将STDF文件解析为格式化的Excel表格（显示所有记录类型）：

bash

stdf-reader convert-xlsx <stdf_file>

3. Convert Diagnosis STDF to ASCII

3. 将诊断STDF转换为ASCII

Convert STDF V4-2007.1 files with STR/PSR diagnosis records to ASCII CSV:

bash

stdf-reader convert-diag <stdf_file>

将包含STR/PSR诊断记录的STDF V4-2007.1文件转换为ASCII格式的CSV：

bash

stdf-reader convert-diag <stdf_file>

4. Extract Single Record Type

4. 提取单一记录类型

Extract a specific STDF record type (DTR, GDR, TSR) to CSV:

bash

stdf-reader extract-record <stdf_file> --type DTR

将特定STDF记录类型（DTR、GDR、TSR）提取为CSV：

bash

stdf-reader extract-record <stdf_file> --type DTR

5. Generate Analysis Report

5. 生成分析报告

Generate comprehensive XLSX report from CSV (includes data statistics, bin summary, wafer map):

bash

stdf-reader report <csv_file(s)> [-o output.xlsx]

从CSV生成全面的XLSX报告（包含数据统计、Bin汇总、晶圆图）：

bash

stdf-reader report <csv_file(s)> [-o output.xlsx]

6. Generate Correlation Report

6. 生成相关性报告

Compare means across 2+ STDF files merged in a single CSV:

bash

stdf-reader correlation <csv_file(s)> [-o output.xlsx]

比较合并到单个CSV中的2个及以上STDF文件的均值：

bash

stdf-reader correlation <csv_file(s)> [-o output.xlsx]

7. Generate Site-to-Site Correlation

7. 生成站点间相关性报告

Compare test data across different test sites:

bash

stdf-reader s2s <csv_file(s)> [-o output.xlsx] [--cherry-pick "1,3,5"]

Options:

```
--cherry-pick "1,3,5"
```
— Site numbers to pick, comma-separated

比较不同测试站点的测试数据：

bash

stdf-reader s2s <csv_file(s)> [-o output.xlsx] [--cherry-pick "1,3,5"]

选项：

```
--cherry-pick "1,3,5"
```
— 要选择的站点编号，以逗号分隔

8. Generate PDF Charts

8. 生成PDF图表

Generate PDF with trendline + histogram charts for selected tests:

bash

undefined

为选定测试生成包含趋势线+直方图的PDF：

bash

undefined

By regex pattern

通过正则表达式匹配

stdf-reader pdf <csv_file> --regex "IDD.*"

All tests

所有测试

stdf-reader pdf <csv_file> --all

Specific tests

特定测试

stdf-reader pdf <csv_file> --tests "210 - IDD_Static <> curr"


Options:
- `--no-limits` — Don't plot failure limit lines
- `--group-by-file` — Group trends by file instead of by site

stdf-reader pdf <csv_file> --tests "210 - IDD_Static <> curr"


选项：
- `--no-limits` — 不绘制故障限制线
- `--group-by-file` — 按文件而非站点分组趋势

9. Extract Sub-CSV

9. 提取子CSV

Extract only specific tests from a CSV file:

bash

stdf-reader extract-tests <csv_file> --regex "VDD.*"

从CSV文件中仅提取特定测试：

bash

stdf-reader extract-tests <csv_file> --regex "VDD.*"

10. List Tests

10. 列出测试项

List all test instances in a CSV file:

bash

stdf-reader list-tests <csv_file>
stdf-reader list-tests <csv_file> --filter "IDD.*"

列出CSV文件中的所有测试实例：

bash

stdf-reader list-tests <csv_file>
stdf-reader list-tests <csv_file> --filter "IDD.*"

11. Transpose CSV

11. 转置CSV

Swap rows and columns in a CSV file:

bash

stdf-reader transpose <csv_file>

交换CSV文件中的行和列：

bash

stdf-reader transpose <csv_file>

Typical Workflow

典型工作流程

Convert STDF to CSV:
```
convert-csv input.stdf
```
List available tests:
```
list-tests input.stdf_csv_log.csv
```
Report:
```
report input.stdf_csv_log.csv
```

PDF charts:

pdf input.stdf_csv_log.csv --regex "pattern"

转换：将STDF转为CSV：
```
convert-csv input.stdf
```
列出可用测试项：
```
list-tests input.stdf_csv_log.csv
```
生成报告：
```
report input.stdf_csv_log.csv
```

生成PDF图表：

pdf input.stdf_csv_log.csv --regex "pattern"

Output File Naming

输出文件命名规则

```
convert-csv
```
→
```
{input}_csv_log.csv
```
```
convert-xlsx
```
→
```
{input}_excel.xlsx
```
```
convert-diag
```
→
```
{input}_diag_log.csv
```
```
extract-record
```
→
```
{input}_{TYPE}_Rec.csv
```

report

→

{base}_analysis_report_{timestamp}.xlsx

correlation

→

{base}_correlation_report_{timestamp}.xlsx

s2s

→

{base}_s2s_correlation_table{timestamp}.xlsx

```
pdf
```
→
```
{input}_results.pdf
```

All outputs default to the same directory as the input unless

-o

is specified.

```
convert-csv
```
→
```
{input}_csv_log.csv
```
```
convert-xlsx
```
→
```
{input}_excel.xlsx
```
```
convert-diag
```
→
```
{input}_diag_log.csv
```
```
extract-record
```
→
```
{input}_{TYPE}_Rec.csv
```

report

→

{base}_analysis_report_{timestamp}.xlsx

correlation

→

{base}_correlation_report_{timestamp}.xlsx

s2s

→

{base}_s2s_correlation_table{timestamp}.xlsx

```
pdf
```
→
```
{input}_results.pdf
```

所有输出默认与输入文件位于同一目录，除非指定

-o

参数。