Overview

Machine learning models for automated analysis of quantum device data. Models power the analysis step of Control’s calibration loop, replacing hours of manual interpretation with structured, automated results. Use them during device tune-up and characterization to quickly extract key device parameters from your measurement data.

Regardless of the specific model, the SDK always wraps the response in a ModelResultInfo object:

FieldTypeDescription
idstrUnique identifier for the execution
modelstrName of the executed model
created_atdatetimeTimestamp (UTC) when the execution was created
input_file_namestrName of the uploaded input file
input_file_sizeintSize of the input file in bytes
outputDictModel‑specific output (boolean or dictionary)

Model Versioning

Some of our models use a versioning scheme (v0, v1, etc.) where higher numbers generally indicate improved accuracy and performance. When selecting a model version, consider:

  • Newer versions typically offer better accuracy and robustness
  • Specialized versions for specific data types or conditions
  • Performance variations based on your measurement characteristics

We recommend testing multiple versions to find the optimal one for your quantum device data.

Charge Stability Diagram Analysis

ModelDescriptionInput ShapeOutput KeysEndpoints
charge-stability-diagram-segmenter-v0Segments a charge stability diagram into different regions(128, 128)segmentationRun
charge-stability-diagram-binary-classifier-v0-16x16Classifies a charge stability diagram as no dot, single, or double dot(16, 16)classificationRun
charge-stability-diagram-binary-classifier-v1-16x16Classifies a charge stability diagram as no dot, single, or double dot(16, 16)classificationRun
charge-stability-diagram-binary-classifier-v2-16x16Classifies a charge stability diagram as no dot, single, or double dot(16, 16)classificationRun
charge-stability-diagram-binary-classifier-v3-16x16Classifies a charge stability diagram as no dot, single, or double dot(16, 16)classification, scoreRun
charge-stability-diagram-binary-classifier-v0-48x48Classifies a charge stability diagram as no dot, single, or double dot(48, 48)classification, scoreRun
charge-stability-diagram-binary-classifier-v1-48x48Classifies a charge stability diagram as no dot, single, or double dot(48, 48)classification, scoreRun
charge-stability-diagram-transition-detector-v0Detects the locations of charge transition lines in a charge stability diagram(n, m)transition_linesRun
charge-stability-diagram-transition-detector-v1Detects the locations of charge transition lines in a charge stability diagram(n, m)transition_linesRun
charge-stability-diagram-transition-detector-v2Detects the locations of charge transition lines in a charge stability diagram(n, m)transition_linesRun
charge-stability-diagram-transition-detector-v3Detects the locations of charge transition lines in a charge stability diagram(n, m)transition_linesRun

You can see how to use the charge stability diagram models on the Charge Stability Diagram Models page.

Coulomb Blockade Analysis

ModelDescriptionInput ShapeOutput KeysEndpoints
coulomb-blockade-classifier-v0Determines if a current measurement exhibits Coulomb blockade characteristics(n, )classificationRun
coulomb-blockade-classifier-v1Determines if a current measurement exhibits Coulomb blockade characteristics(n, )classificationRun
coulomb-blockade-classifier-v2Determines if a current measurement exhibits Coulomb blockade characteristics(128, )classification, scoreRun
coulomb-blockade-classifier-v3Determines if a current measurement exhibits Coulomb blockade characteristics(128, )classification, scoreRun
coulomb-blockade-peak-detector-v0Detects the locations of Coulomb blockade peaks in current measurement(n, )peak_indicesRun
coulomb-blockade-peak-detector-v1Detects the locations of Coulomb blockade peaks in current measurement(n, )peak_indicesRun
coulomb-blockade-peak-detector-v1-miniDetects the locations of Coulomb blockade peaks in current measurement(n, )peak_indicesRun
coulomb-blockade-peak-detector-v2Detects the locations of Coulomb blockade peaks in current measurement(n, )peak_indicesRun

You can see how to use the Coulomb Blockade models on the Coulomb Blockade Models page.

Note: coulomb-blockade-peak-detector-v1-mini is a quicker version of coulomb-blockade-peak-detector-v1 that gives a good trade-off between accuracy and speed.

Coulomb Diamond Analysis

ModelDescriptionInput ShapeOutput KeysEndpoints
coulomb-diamond-segmenter-v0Segments a Coulomb diamond conductance grid to Coulomb diamond regions(n, m)segmentationRun
coulomb-diamond-detector-v0Detects the vertices of Coulomb diamond structures from a binary mask(n, m)diamond_verticesRun
coulomb-diamond-detector-v1Detects the vertices of Coulomb diamond structures directly from conductance data(n, n)diamond_verticesRun
coulomb-diamond-detector-v2Detects the vertices of Coulomb diamond structures directly from conductance data(n, n)diamond_verticesRun

You can see how to use the Coulomb Diamond models on the Coulomb Diamond Models page.

Pinch-off Analysis

ModelDescriptionInput ShapeOutput KeysEndpoints
pinch-off-classifier-v0Determines if a current measurement exhibits pinch-off characteristics(n, )classificationRun
pinch-off-parameter-extractor-v0Extracts key parameters from pinch-off measurements (cut_off_voltage, transition_voltage, saturation_voltage)(n, )cut_off_index, transition_index, saturation_indexRun

You can see how to use the Pinch-off models on the Pinch-off Models page.

Turn-on Analysis

ModelDescriptionInput ShapeOutput KeysEndpoints
turn-on-classifier-v0Determines if a current measurement exhibits turn-on characteristics(n, )classificationRun
turn-on-parameter-extractor-v0Extracts the threshold voltage from turn-on measurements(n, )threshold_indexRun

You can see how to use the Turn-on models on the Turn-on Models page.

Resonator Spectroscopy Analysis

ModelDescriptionInput ShapeOutput KeysEndpoints
resonator-dip-finder-v0Detects resonator dips in spectroscopy magnitude traces(n,)dip_indicesRun

You can see how to use the Resonator Dip Finder model on the Resonator Dip Finder page.

QEC Decoding (NVIDIA Ising Decoding)

ModelDescriptionInput ShapeOutput KeysEndpoints
ising-decoding-v1-fastLow-latency AI pre-decoder for surface code QEC (0.9M params, R=9)(batch, 4, T, D, D)logits, variant, batch_sizeRun
ising-decoding-v1-accurateHigher-accuracy AI pre-decoder for surface code QEC (1.8M params, R=13)(batch, 4, T, D, D)logits, variant, batch_sizeRun

These models accept detector syndrome tensors as 5D NumPy arrays and return correction logits. See the QEC Decoding page for details and code examples.

Agents

AgentDescriptionInputEndpoints
ising-calibration-v1Analyses quantum calibration plots using the NVIDIA Ising Calibration VLMimage_base64, prompt (optional)Run

See the NVIDIA Ising Calibration page for details and code examples.