Examples 范例程序说明
本目录包含 TDA Framework 的系列范例程序(Examples),按分类编号组织,每个范例对应一个独立可运行的 .NET 项目。
范例程序列表
| 范例程序 | 描述 |
|---|---|
| Ex101.UseDataPrism | 演示 DataPrism 的多种构造方式、数据处理流程及各阶段数据访问方法(直接打印到控制台) |
| Ex102.ExportParamsStatistics | 批量统计多个 STDF 文件中测试参数的摘要(Mean / Stdev / 百分位数等),按多种匹配模式导出为 CSV |
| Ex103.ExportRawData | 用 DataPrism 解析 STDF 并导出 raw data 到 CSV,支持按 TestID 集合 / 选择器 / Part 过滤 |
| Ex105.ExportSummary | 导出 HBin / SBin 统计摘要(Yield、Bin 分布)到 CSV,支持自定义格式与多批次合并导出 |
| Ex106.ExportPartSummary | 导出每颗 Part/Device 的信息列表(Pass/Fail、HardBin/SoftBin、坐标、数据来源等)到 CSV |
| Ex201.UseMsgInConsole | 演示在控制台程序中使用 Msg 消息系统:自动/显式初始化、六级日志、结构化 Tag 与对象日志等 |
| Ex202.UseMsgInWinform | 演示在 WinForm 程序中通过界面按钮触发 Msg 各级别日志输出、日志过滤与配置管理 |
| Ex203.UseMsgInConsoleAndWinform | 演示在「控制台 + WinForm」混合宿主中使用 Msg 消息系统 |
| Ex204.CfgFileForDataPrismSetup | 演示构建含多 Sublot / 多轮复测的 DataPrismSetup,并序列化 / 反序列化为 JSON 配置文件(绝对 / 相对路径两种风格) |
| Ex205.CfgFileForTestIDSet | 演示 TestIDSet 配置文件的读写流程:从 STDF 导出全部 TestID 到 CSV,再读回并打印 |
| Ex206.CfgFileForTestIDRenameSet | 演示 TestIDRenameSet 配置文件的创建、读写与从 TestIDSet 转换 |
| Ex301.UseRecordReader | 演示 RecordReader 读取 STDF 文件:基本工作流、显式关闭、通用 / 强类型逐条读取,及解压模式(Buffered / Streaming)对比 |
| Ex302.UseRecordWriter | 演示用 RecordReader 逐条读取源文件、RecordWriter 写入新文件,展示 STDF 完整读写流程及写入统计摘要 |
| Ex601.GUICharts | 演示 TDA.GUI 全部 5 种图表控件(趋势图 / 直方图 / 累积概率图 / 箱线图 / 晶圆图)在同一窗口 Tab 页中的展示 |
| Ex602.GUIEasyPlotForm | 演示 EasyPlotForm 快速绘图窗口与 DataGridView 联动:多选参数自动绘图 |
| Ex603.FlexiblePlotForm | 演示 FlexiblePlotForm 按需多图布局:根据选中图表数量自动适配(1 图全屏 / 2 图左右 / 3~4 图 2×2 网格) |
| Ex701.LotYieldReport | 演示 TDA.Report 良率报告模板:从 STDF / NEDA CSV / 演示数据生成单文件自包含的 HTML 良率报告 |
项目命名格式
以 Ex601.GUICharts 为例:
-
Ex表示这是一个 Example(范例)项目 -
Ex后的数字,百位表示 Example 项目的分类编号,取值为十六进制 1 ~ F,不同值含义为:百位 分类 包含范例 1 DataPrism 数据访问与导出 Ex101 ~ Ex106 2 Msg 日志工具与 TDA 配置文件 Ex201 ~ Ex206 3 STDF 记录级读写(RecordReader / RecordWriter) Ex301 ~ Ex302 6 TDA.GUI 可视化控件 Ex601 ~ Ex603 7 TDA.Report 报告 Ex701 -
Ex后的十位与个位为该分类下的范例序号;同一范例内的多个演示场景以扩展编号区分(如Ex10301、Ex10311,末两位表示子演示序号,数字越大演示越进阶) -
点号(
.)后为该范例的用途描述名,如UseRecordReader、GUIEasyPlotForm
Ex1xx:DataPrism 数据访问与导出
Ex101.UseDataPrism
演示 DataPrism 的多种构造方式、数据处理流程及各阶段数据访问方法。所有演示均直接打印数据到控制台,不导出文件。默认运行 Ex10101,其余演示通过取消 Program.cs 中注释启用。
| 演示文件 | 说明 |
|---|---|
Ex10101_UseDataPrism |
最简流程:弹窗选 STDF → Load() → DoStatisticAnalysis() → 打印 MIR/SDR 元数据(LotID、SublotID、站点、Part/测试项数量等) |
Ex10102_DifferentInputFormats |
三种不同的 DataPrism 构造方式 |
Ex10103_AccessMetaInfoAndRawData |
Load() 后访问元信息与原始测试值 |
Ex10104_AccessStatistics |
分析后访问统计数据与 Bin 汇总 |
Ex10105_ApplyTestIDRename |
ApplyTestIDRename 过滤与重命名 TestID |
Ex102.ExportParamsStatistics
批量打开多个 STDF 文件,统计指定测试参数的摘要(TestedCnt、FailedCnt、Mean、Stdev、P1/P5/P50/P95/P99 等),导出为 CSV。支持宽格式 / 长格式两种布局,以及按 TestText / TestNumber 两种方式匹配参数。默认运行 Ex10203。
| 演示文件 | 说明 |
|---|---|
Ex10201_ExportParamsStatistics |
宽格式导出统计结果 |
Ex10202_ExportParamsStatisticsLongFormat |
长格式导出(直接匹配) |
Ex10203_ExportStatisticsByTestText |
基于 TestText 匹配参数后导出 |
Ex10204_ExportStatisticsByTestNumber |
基于 TestNumber 匹配参数后导出 |
Ex103.ExportRawData
选取 STDF 文件后用 DataPrism 解析,将 raw data(原始测试值)导出为 CSV。默认运行 Ex10301。
| 演示文件 | 说明 |
|---|---|
Ex10301_ExportDataWithSpecifiedTestIDs |
指定 TestID 集合导出对应测试项数据 |
Ex10302_ExportDataWithTestIDSelector |
通过 TestID 选择器(交互式)导出 |
Ex10311_ExportDataWithPartFilter |
先按 Part 过滤,再导出数据 |
Ex105.ExportSummary
将 DataPrism 分析结果中的 Yield / HBin / SBin 统计摘要导出为 CSV。默认运行 Ex10506。
| 演示文件 | 说明 |
|---|---|
Ex10501_ExportSummary |
调用 DataPrism.ExportSummary 一次导出 Yield + HBin + SBin 三个区块 |
Ex10502_ExportSummaryCustomizeFormat |
自定义输出格式后导出 |
Ex10503_ExportSummaryMultiLot |
多批次(IEnumerable)数据合并导出 |
Ex10504_ExportYield |
只导出 Yield(Qty 统计)区块,输出 <stem>.yield.csv |
Ex10505_ExportHBin |
只导出 HBin 区块,输出 <stem>.hbin.csv |
Ex10506_ExportSBin |
只导出 SBin 区块;并演示 csvWriter 重载把三个区块拼进同一个 CSV |
Ex106.ExportPartSummary
将每个 Part/Device 的判定信息列表导出到 CSV:Pass/Fail 结果、HardBin/SoftBin、芯片坐标、数据来源(批次 / 轮次)等字段。
Ex2xx:Msg 日志工具与 TDA 配置文件
Ex201.UseMsgInConsole
在纯控制台程序中演示 Msg 消息系统的完整用法,默认 5 个演示全部运行。
| 演示文件 | 说明 |
|---|---|
Ex20101_AutoInitAndSixLevels |
自动初始化并输出六级日志(Debug ~ Fatal 等) |
Ex20102_ExplicitInitWithConfig |
显式初始化并加载配置 |
Ex20103_StructuredTagLogging |
结构化 Tag 日志 |
Ex20104_StructuredObjectAndException |
结构化对象与异常日志 |
Ex20105_BlankLineAndLegacyApi |
空行控制与旧 API 兼容用法 |
Ex202.UseMsgInWinform
在 WinForm 程序中通过窗体工具栏按钮触发 Msg 各级别消息输出,演示 WinForm 环境下的日志行为,并提供 Tag 输入、异常模拟、日志级别过滤与配置管理等界面功能。
Ex203.UseMsgInConsoleAndWinform
在「控制台 + WinForm」混合宿主程序中使用 Msg:控制台窗口输出日志的同时,WinForm 窗体可通过按钮触发消息,展示双输出目标的日志用法。
Ex204.CfgFileForDataPrismSetup
演示如何通过代码构建 DataPrismSetup 配置(描述一个 Lot 的所有 Sublot、测试轮次、STDF 文件路径与复测 HardBin 范围),并序列化 / 反序列化为 JSON 配置文件。默认运行 Ex20401 与 Ex20402。目录下 ExampleSetupFiles/ 提供示例配置文件。
| 演示文件 | 说明 |
|---|---|
Ex20401_DataPrismSetupWithAbsolutePaths |
使用绝对路径风格构建并读写 JSON |
Ex20402_DataPrismSetupWithRelativePaths |
使用相对路径风格构建并读写 JSON |
Ex205.CfgFileForTestIDSet
演示 TestIDSet 配置文件的完整读写流程:打开 STDF → 将全部 TestID 导出到 CSV → 重新加载 CSV 并打印。
| 演示文件 | 说明 |
|---|---|
Ex20501_TestIDSetCfgFileWriteRead |
TestIDSet 配置文件写出与读回 |
Ex206.CfgFileForTestIDRenameSet
演示 TestIDRenameSet 配置文件的创建、读写与转换。默认运行 Ex20601。
| 演示文件 | 说明 |
|---|---|
Ex20601_ProfileFromStdfAndSaveCsv |
从 STDF 文件生成 Profile 并保存为 CSV |
Ex20602_CreateProfileManuallyAndSaveCsv |
手动构建 Profile 并保存为 CSV |
Ex20603_LoadProfileFromCsv |
从 CSV 加载 Profile |
Ex20604_ConvertFromTestIDSet |
从 TestIDSet 转换为 TestIDRenameSet |
Ex3xx:STDF 记录级读写
Ex301.UseRecordReader
演示 RecordReader 读取 STDF 文件的核心用法:选择文件与格式校验 → 初始化 → 读取文件头(FAR)→ 按基类 / 具体类型逐条读取记录 → 显式关闭或自动释放资源,以及对压缩 STDF 文件(.gz/.zip/.tar.gz)的解压模式配置。默认运行 Ex30101。
| 演示文件 | 说明 |
|---|---|
Ex30101_BasicWorkflow |
基本工作流:IsValidStdFile 校验 → new RecordReader(file) → 读 FAR → ReadNext() 迭代 → using 自动释放 |
Ex30102_HowToCloseRecordReader |
显式调用 Close() 控制读取器生命周期(而非依赖 using 自动释放) |
Ex30103_ReadRecordsAsGeneralRecordType |
以通用 Record 类型读取所有记录并打印 |
Ex30104_ReadRecordAsSpecificRecordType |
按 TypeID 将记录转换为具体强类型后打印,获取各类型专属数据 |
Ex30105_ConfigurationDemo |
对比 StdfDecompressionMode.Buffered(全量解压、可随机访问)与 Streaming(流式解压、内存恒定)两种构造模式;建议用压缩文件运行 |
Ex302.UseRecordWriter
演示 RecordReader + RecordWriter 的完整读写流程:弹窗选取源 STDF → 校验 → 逐条 ReadNext() 读取 → 逐条 WriteRecord() 写入同目录下的 .copy.stdf 新文件,最后通过 RecordWriter.RecordCount / TotalRecords 打印各类型 Record 的写入统计摘要。
| 演示文件 | 说明 |
|---|---|
Ex30201_CopyStdfFile |
将源 STDF 逐条 Record 拷贝为新文件并输出统计摘要 |
说明:原分类 Ex4xx(STDF 记录级解析)与 Ex5xx(RecordWriter)已并入本分类,分别由 Ex301(读取)与 Ex302(写入)承接,分类编号 4、5 空出。
Ex6xx:TDA.GUI 可视化
Ex601.GUICharts
演示 TDA.GUI 全部 5 种图表控件——趋势图(TrendChart)、直方图(HistogramChart)、累积概率图(CumulativeProbabilityChart)、箱线图(BoxPlotChart)、晶圆图(WaferMapChart),通过 MainForm 的 Tab 页分页展示;窗体提供 TestCase 选择与数据参数量(1/2/3)选择以观察不同渲染效果。
Ex602.GUIEasyPlotForm
演示 EasyPlotForm 快速绘图窗口与主窗体的联动用法:MainForm 以 DataGridView 列出各参数及其统计数据,用户可多选行,选中的参数将自动绘制到内嵌的 EasyPlotForm 中,无需手动编写 WinForm 布局代码。
Ex603.FlexiblePlotForm
演示 FlexiblePlotForm 的按需多图布局能力:MainForm 左侧列出参数并选择图表布局,右侧展示 FlexiblePlotForm;调用方可自由组合趋势图 / 直方图 / 累积概率图 / 箱线图,窗体根据选中的图表数量自动适配布局(1 图全屏、2 图左右分栏、3~4 图 2×2 网格)。
Ex7xx:TDA.Report 报告
Ex701.LotYieldReport
演示 TDA.Report 的 LotYieldReport 报告模板,从测试数据生成单文件自包含的 HTML 良率报告(图表经 ChartService 直出 PNG 并以 base64 data URI 内嵌)。
用法(命令行):
Ex701.LotYieldReport <input.stdf> [-o out.html]
Ex701.LotYieldReport input.neda_raw.csv [-o out.html]
Ex701.LotYieldReport --demo [-o out.html] # 生成演示数据并出报告
| 演示文件 | 说明 |
|---|---|
Ex70101_BuildLotYieldReport |
全流程:加载数据(STDF / NEDA CSV / demo)→ 适配为结构化摘要 → 渲染参数图表 → 模板装配 → 输出 HTML |