wafermap¶
A JavaScript library for rendering interactive wafer maps from semiconductor test data. Hard bins, soft bins, test values, retest runs, edge exclusion, and spec limits are native inputs — no pre-processing required.
import { buildWaferMap } from '@wafertools/wafermap';
import { renderWaferMap } from '@wafertools/wafermap/render';
const result = buildWaferMap({ results });
renderWaferMap(document.getElementById('map'), result);
Which docs are for you?¶
Building an application with wafermap? You're a developer integrating the library into a test-data app. Follow this path:
- Quick Start — a working map in 5 minutes
- Developer Guide — walkthroughs from first map to lot gallery with findings
- SvelteKit · React · Vue 3 — wiring it into your framework
- API Reference — every type, option, and return value
Using an application built on wafermap? You're a test, device, or yield engineer reading wafer maps in an app someone built with this library. You need exactly one page:
- Application User Guide — reading the map, plot modes, toolbar, findings, Insights tab
- Glossary — if a term on screen is unfamiliar
Evaluating the library? Judge it quickly:
- Showcase — all features on one page
- wafermap vs Plotly.js — side-by-side timings and features
- Performance — measured cost by wafer size and option
- Detection Analysis — benchmark validation of the pattern-detection systems
Find a task¶
| I want to… | Read |
|---|---|
| Render my first map | Quick Start |
| Load real CSV data | Guide §3 |
| Show bins, yield, and pass/fail colours | Guide §5 |
| Plot parametric test values with spec limits | Guide §6 |
| Handle retests | Guide §7 |
| React to hover, click, and die selection | Guide §9 |
| Add statistical findings / pattern detection | Guide §10 · Pattern Detection |
| Show a whole lot as a gallery | Guide §12 |
| Add the Insights chart suite | Guide §14 |
| Keep the UI responsive on big lots | Web Worker (Guide §17) · Performance |
| Use it in React / Vue / SvelteKit | React · Vue 3 · SvelteKit |
| Fix a blank map or wrong yield | Troubleshooting |
| Understand the package layers | Architecture |
What it covers¶
Geometry. Pass full physical dimensions or raw prober step positions — die pitch, wafer diameter, and coordinate origin are inferred when not supplied. Retest policy (last, first, best, worst), edge exclusion, and reticle overlays are supported directly.
Rendering. renderWaferMap produces an interactive canvas map with toolbar, zoom/pan, tooltips, die selection, and summary panel. renderWaferGallery renders a full lot as a responsive card grid with shared controls and click-to-expand.
Analysis. analyzeWaferMap runs spatial analysis across rings, quadrants, sectors, and reticle positions, and detects contiguous failure clusters and edge arcs. analyzeWaferLot adds lot-level trend series and cross-wafer patterns. Results wire directly into the summary panel.
Integration. Pure ES modules, no server, no runtime dependencies. Works in React, Svelte, Vue, plain HTML, or a Web Worker.