Tool State - Atomscale Documentation

The Tool State workflow processes instrument log files from synthesis tools, extracts timeseries data for each parameter, and runs signal analysis to characterize oscillation behavior and decay.

Overview
Technical

What It Does

The tool state pipeline takes raw log files uploaded from an instrument and produces structured timeseries that you can plot, compare across runs, and monitor for anomalies. The pipeline handles format parsing, data cleaning, signal analysis, and anomaly detection in a single pass.

Supported Formats

The pipeline supports three input formats:

Format	Description
Tool logs	CSV log files from synthesis tools. Extracts Ratio Pyrometer and SC Pyrometer temperature readings, then runs signal analysis.
Generic CSV	Any delimited file (CSV, TSV, or other). The pipeline auto-detects the delimiter and header offset, coerces columns to numeric types, and extracts time axes automatically.
MOCVD recipe XML	Recipe definition files. The pipeline expands compact recipe steps into a dense timeseries with interpolation.

Outputs

For tool logs, the pipeline produces:

Output	Description
`ratio_pyrometer`	Raw Ratio Pyrometer temperature timeseries
`sc_pyrometer`	Raw SC Pyrometer temperature timeseries
`median_period_seconds`	Median oscillation period extracted from peak analysis, per segment
`decay_constant_minutes`	Exponential decay time constant fitted to peak envelopes
`decay_fit`	Interpolated decay fit curve
`{property}_anomaly_score`	Embedding-based anomaly score (0 to 1) for each property
`{property}_anomaly_class`	Classification label for detected anomalies
`{property}_forecast`	Predicted value based on current trajectory
`{property}_z_score`	Z-score deviation metric for each property (legacy)
`{property}_ema_z_score`	EMA residual z-score for each property (legacy)

For generic CSV files, the pipeline produces a timeseries for each numeric column in the file, plus the same anomaly detection metrics.