wafermap

Browser-first wafer map visualization for semiconductor test data.

Zero runtime dependencies · ~40 kB min+gz (core entry). Pure ES modules with TypeScript types — works in React, Svelte, Vue, plain HTML, or a Web Worker.

Project Portal: Docs & Interactive Demos →

Questions, ideas, or want to show off a wafer map you built? Use GitHub Discussions.

wafermap renders interactive wafer maps from semiconductor prober output. Hard bins, soft bins, test values, retest runs, edge exclusion, and spec limits are native inputs.

• Geometry inference — pass full physical dimensions or raw prober step positions; die pitch, wafer diameter, and coordinate origin are resolved automatically
• renderWaferMap — interactive canvas map with toolbar, zoom/pan, tooltips, die selection, and summary panel
• renderWaferGallery — lot-level card grid with shared controls and click-to-expand
• Insights tab (insights: { enabled: true }) — an in-toolbar chart suite (yield, bin pareto, capability, boxplot, histogram, correlation, scatter) computed from the same wafer/lot data, for one wafer or the whole gallery
• analyzeWaferMap / analyzeWaferLot — spatial analysis across rings, quadrants, sectors, and reticle positions; failure cluster detection; lot trend series
• Pure ES modules, no server, no runtime dependencies — works in React, Svelte, Vue, plain HTML, or a Web Worker

npm install @wafertools/wafermap

import { buildWaferMap } from '@wafertools/wafermap';
import { renderWaferMap } from '@wafertools/wafermap/render';

const result = buildWaferMap({
  results: rows.map(r => ({ x: +r.x, y: +r.y, hbin: +r.hbin })),
});

renderWaferMap(document.getElementById('map'), result);

Note the two import paths. The renderers (renderWaferMap, renderWaferGallery, toCanvas) live only at @wafertools/wafermap/render, so importing them from the root package will fail. That keeps the root entry DOM-free — usable in Node for a build-and-analyse pipeline, and tree-shakeable when you only need the geometry, data and stats layers.

Building an app with wafermap (developers):

• Quick start
• Developer Guide
• SvelteKit · React · Vue 3 integration guides
• API Reference
• Using wafermap with an AI coding agent — rules to paste into Claude Code / Codex / Copilot / Cursor, also shipped as AGENTS.md in this package
• Architecture · Performance · Troubleshooting
• Live examples — or download them to run and edit locally, offline, with the library bundled in

Using an app built with wafermap (test / device / yield engineers):

• Application User Guide — also embedded in apps via the toolbar help button
• Glossary

• tsmap — cross-platform desktop app for loading STDF, ATDF, CSV, and JSON wafer data

npm install
npm run dev

Serves the documentation site locally from docs/, including the example pages under docs/examples/.