tda-learn:基于 .NET 10 与 TDA 框架的 STDF 数据分析示例项目

TDA Framework 示例与学习仓库 —— 半导体 STDF 数据分析从入门到实战。 核心能力以 NuGet 包公开发布:TDA(STDF V4 解析 / 统计分析 / CSV、Excel 导入导出)、TDA.GUI(趋势 / 直方图 / 箱线图 / 晶圆图等 WinForms 控件)、TDA.Report(HTML / Excel 报告)。 仓库含 17 个可运行示例,按数据读取、统计汇总、配置读写、消息日志、GUI 绘图、良率报告等主题组织,项目名即学习路径,全部通过 NuGet 引用、不依赖任何源码。环境要求 Windows + .NET 10 SDK,clone 后 dotnet build tda-examples.slnx 即可构建运行。

Branch1Tags3
FilesLast commitLast update
20 days ago
19 days ago
20 days ago
20 days ago
20 days ago
22 days ago
20 days ago
2 months ago
2 months ago
16 days ago
16 days ago
23 days ago

tda-learn

English | 简体中文

Official examples and learning material for the TDA Framework — STDF (Standard Test Data Format) V4 parsing and semiconductor test data analysis in .NET, from the first line of code to real CP/FT production workflows.

Keywords: STDF · STDF V4 · Standard Test Data Format · semiconductor test data · ATE (automatic test equipment) · CP / FT · wafer map · yield analysis · Cp / Cpk · retest · .NET 10 · C#

The TDA Framework is a .NET library for semiconductor production test data analysis: STDF V4 record-level parsing, multi-sublot and retest data correlation, statistical analysis (Cp / Cpk, distributions), NEDA CSV / Excel import and export, plus WinForms visualisation. The core library is published on NuGet:

Package What it provides NuGet
TDA Core: STDF parsing, data model, statistics, CSV / Excel import & export nuget.org/packages/TDA
TDA.GUI WinForms chart controls (trend / histogram / cumulative probability / box plot / wafer map) nuget.org/packages/TDA.GUI
TDA.Report HTML / Excel report generation nuget.org/packages/TDA.Report

The core library is distributed as NuGet packages; its source is not part of this repository. This repository contains the examples, the CLI manual and the package documentation.

Repository layout

tda-learn/
├── Examples/   # 17 runnable samples referencing the NuGet packages (1:1 mirror of the internal TDA repo)
├── CLI/        # dp command-line manual: use DataPrism without writing code (maintained here)
│   ├── README.md       # Chinese entry point: where to get it / quick start / scenario guide
│   ├── README.en.md    # English entry point
│   ├── commands.md     # command-by-command reference (syntax / options / output columns and samples)
│   └── ai-guide.md     # AI integration guide (output size tiers / exit codes / best practices)
├── packages/   # Mirror of the NuGet package READMEs (TDA / TDA.GUI / TDA.Report, English + Chinese)
├── tools/      # Maintenance scripts (ProjectReference → PackageReference conversion, package README sync)
├── AGENTS.md   # Repository guide for AI coding assistants
├── Directory.Build.props   # Shared TargetFramework
└── tda-learn.slnx          # Solution containing every sample

Requirements

  • Windows 10 (2004+) or Windows 11
  • .NET 10 SDK — all samples target net10.0-windows10.0.19041 and use WinForms

CLI tool (dp): analyse STDF without writing code

dp is the command-line interface of TDA, designed so that both engineers and AI assistants can drive DataPrism with zero code — a single command such as dp export lsum test.stdf prints the yield summary. Documentation lives in CLI/: the command reference and the AI integration guide (output size tiers, exit codes, failure modes).

Install: download the MSI from GitHub Releases or the GitCode mirror (current version: dp v2.1.5) and run it — the installer adds dp to PATH. Requires Windows 10 2004+ / Windows 11 and the .NET 10 Desktop Runtime (x64); see CLI/README.md for the full guide.

Quick start with the examples

# Restore and build every sample
dotnet build tda-learn.slnx

# Run one sample (Ex101.UseDataPrism)
dotnet run --project Examples/Ex101.UseDataPrism

Samples reference the packages above through NuGet (no TDA source required); the project name is the learning path.

Most samples open a file dialog and expect your own STDF file — real production data must never be committed to this repository. To see output without any data, run the report sample: dotnet run --project Examples/Ex701.LotYieldReport -- --demo.

Sample catalogue

Naming rule: Ex + category (hundreds digit) + index (tens / units). Category semantics are documented in Examples/README.md.

Project Topic APIs / concepts
Ex101.UseDataPrism Load a single STDF file with DataPrism and read lot metadata (LotID / SublotID / sites …) DataPrism
Ex102.ExportParamsStatistics Select several STDF files, filter test items by TestIDSet, export per-parameter statistics to CSV DataPrism, TestIDSet, CSV
Ex103.ExportRawData Parse STDF and export raw measurement data to CSV (TestID set / selector / part filter) DataPrism.ExportRawDatas()
Ex105.ExportSummary Yield / HardBin / SoftBin (per site) summary of one file as CSV DataPrism, summary export
Ex106.ExportPartSummary Export the per-part / per-device information list to CSV PartDescription, CSV
Ex201.UseMsgInConsole Graded logging (Msg: Debug / Info / Warning / Error) from a console app to file Msg
Ex202.UseMsgInWinform Trigger graded Msg logging from a WinForms app Msg
Ex203.UseMsgInConsoleAndWinform Attach both console and WinForms sinks to Msg Msg
Ex204.CfgFileForDataPrismSetup Build a DataPrismSetup with multiple sublots / retest rounds and serialise it to JSON DataPrismSetup, JSON
Ex205.CfgFileForTestIDSet TestIDSet round trip: extract test IDs from STDF to CSV, then load it back TestIDSet, CSV
Ex206.CfgFileForTestIDRenameSet Four TestIDRenameSet scenarios: generated from STDF / built manually / loaded from CSV / converted from a TestIDSet TestIDRenameSet, CSV
Ex301.UseRecordReader RecordReader basics (validate → read FAR → iterate ReadNext → dispose) and decompression modes for compressed files RecordReader, StdfDecompressionMode
Ex302.UseRecordWriter RecordReader → RecordWriter record-by-record file copy with per-type write statistics RecordReader, RecordWriter
Ex601.GUICharts All five TDA.GUI chart controls (trend / histogram / cumulative probability / box plot / wafer map) in tab pages TDA.GUI controls
Ex602.GUIEasyPlotForm EasyPlotForm: a singleton chart window in three lines of code EasyPlotForm
Ex603.FlexiblePlotForm FlexiblePlotForm: automatic multi-chart layout (1 full / 2 side-by-side / 3–4 in a 2×2 grid) FlexiblePlotForm
Ex701.LotYieldReport Render an HTML yield report from STDF / NEDA CSV / demo data through the LotYieldReport template TDA.Report, LotYieldReport

Detailed descriptions of every sample are in Examples/README.md.

License

MIT © TDA Project Contributors

Introduction

TDA Framework 示例与学习仓库 —— 半导体 STDF 数据分析从入门到实战。 核心能力以 NuGet 包公开发布:TDA(STDF V4 解析 / 统计分析 / CSV、Excel 导入导出)、TDA.GUI(趋势 / 直方图 / 箱线图 / 晶圆图等 WinForms 控件)、TDA.Report(HTML / Excel 报告)。 仓库含 17 个可运行示例,按数据读取、统计汇总、配置读写、消息日志、GUI 绘图、良率报告等主题组织,项目名即学习路径,全部通过 NuGet 引用、不依赖任何源码。环境要求 Windows + .NET 10 SDK,clone 后 dotnet build tda-examples.slnx 即可构建运行。

Customize your domain