In this lesson

If you open the same kind of data every day, or you want another tool to open it for you, clicking through the dialogs gets tiresome. This lesson shows how to open data from a link or the command line, and how to save your setup so you only have to make it once.

• Open data from a link or the command line
• Use the definitions files: tests, splits, bins and plots
• See and reset what tsmap remembers

From a link

Another application, or a colleague's message, can open the web app on a data file. The link holds the address of the file:

…/app/?dataUrl=<encoded URL>&dataFormat=csv

Name the format: stdf, atdf, csv, json, parquet or zip.

The lab link

The labs in these lessons use this kind of link. This one opens the sample CSV:

Open the sample CSV

The data server must allow pages from other websites to read the file (this is called CORS). If the fetch fails, the log says so.

More in the user guide

The command line

On the desktop app, name files when you launch it, and they open without a single click:

tsmap lot1.stdf lot2.stdf
tsmap lot1.stdf --splits my-splits.csv
tsmap lot1.stdf --plots my-plots.json
tsmap --url https://… --url-format stdf

tsmap --help lists everything. Launching again hands the files to the running window.

tsmap --help

The first lines of what it prints:

tsmap [OPTIONS] [FILE...]

Options:
  --list <FILE>         A text file of data-file paths, one per line
  --tests <FILE>        A test-selection list; pre-fills the selector
  --splits <FILE>       A wafer-splits CSV, applied once loaded
  --bins <FILE>         A bin-definitions CSV, applied over the data
  --setup <FILE>        A setup file: diameter, edge exclusion, reticle, ...
  --plots <FILE>        A plots file, added to your saved plots

More options

Options let a launch carry its own setup.

• --wafer-diameter, --edge-exclusion, --reticle: the dialogs' values, for that launch
• --tests fills in the test selector; --list reads a list of paths
• A tsmap://open?url=… link opens the desktop app from a web page

More in the user guide

Data behind a login

Data often sits behind a login, and a link should not carry a password.

• Use a presigned URL, which builds the access into the address
• --url-headers auth.txt sends a token from a file (desktop)
• See the integration guide and a live demo

The rest of the Help menu

• Support tsmap… opens the page on how to support the project
• About tsmap… shows the version

The rest of the Preferences menu

• Reset saved settings… is covered after the definitions files
• Record load timings is for bug reports only: it adds timing lines to the log. Leave it off otherwise

Start from a template

You can save a template and edit it before you have any data. It is the easiest way to get a layout right.

Four CSV files and one JSON

Where each is covered:

• CSV: test definitions (lesson 01), splits (04), bin definitions and the setup file (here)
• JSON: plots and sweeps (10)
• Every format is in the user guide

Setup file…

If you set the same geometry for every lot of a product, save it once. The last rows of Setup ▾ (diameter, edge exclusion, reticle, retests, value filter) can be saved as one file for a product or a site, and loaded again from Setup ▾ → Setup file…: Save… writes it, Load… reads one, and the ▾ lists recent files. On the command line, --setup applies one for a single launch.

The Setup file window

STDF, ATDF and the rest

A table has only bin numbers, so every bin is a bare number until you load definitions. STDF and ATDF files can carry bin names, but you can load definitions for them as well. Bin colours from a file can be switched off under Colour scheme.

In the column mapping

For a table, you can name the bins in the column mapping before you continue: Name bins… opens the bin table over the bins in the sample of rows it holds (add a rare one by number), and Load bin definitions… reads a file. Both are next to Pass bin(s).

Nothing is sent anywhere

Loaded wafer data is not affected by a reset. Saved settings stay on this machine, and tsmap does not upload your data.

Recap

• A link or the command line opens data with no clicking
• Templates show the exact layout of every definitions file
• Reset saved settings… shows and forgets what tsmap remembers

That is the whole app, from loading a file to automating it.

More in the user guide