Skip to content

Learning Guides

Dive right into LabOne Q with these learning guides and reference notebooks.

Session Reference

The Session Reference notebook is intended to help you learn how use the LabOne Q session, what can be saved from or loaded to this session, and some convenience functions associated with objects created using the session.

Calibration Reference

In this notebook, you'll learn how to calibrate a DeviceSetup and Experiment object in LabOne Q in multiple ways. You'll also learn how to get, set, reset, and serialize your calibration.

Experiment Reference

In the experiment reference notebook to see how parts of a LabOne Q experiment can be built.

Section Tutorial

In the section tutorial, you'll learn how to work with LabOne Q sections and how these sections fit together to provide systematic, deterministic timing in your experiments.

Pulse Library Reference

In the pulse library notebook you'll learn about the features of the pulse library

  • How to use pre-defined pulses out of the box, and how to sweep their parameters
  • How to define your own, parameterized pulses and sweep their parameters
  • How to define sampled pulses, e.g., from a numpy array

Pulse Inspector Reference

In this notebook, you'll use the experimental pulse inspector and Bloch simulator to simulate a response of a qubit to a pulse.


The pulse inspector and Bloch simulator are experimental features which are not considered stable and may change in the future.

Near-time Callbacks Guide

In the Near-time Callbacks Guide, you'll learn how to use call so that any Python function can be executed in near-time in LabOne Q. These functions are also referred to as near-time callbacks or user functions.

Callback functions can be used to:

  • control non-QCCS instruments, such as Zurich Instruments lock-in amplifiers or third-party instruments, and acquire results from these instruments
  • access and process the results the experiment has yielded so far
  • exchange waveforms between real-time loops (e.g., based on measurement results), specifically demonstrated in the following guide

Waveform Replacement Guide

In the waveform replacement guide, you'll learn how to use a callback function to exchange waveforms. This could be incorporated into experiments that use, e.g., VQE or optimal control.

Node Sweeping Notebook

In the node sweeping notebook, you'll see how instrument nodes can be swept using set_node.


Sweeping instrument nodes can lead to unintended system states. When possible, it is preferable to sweep the parameter using experiment calibration instead.

Output Simulator Tutorial

In the output simulator tutorial, you'll learn about the functionality and features of the LabOne Q output signal simulator.

DataStore Reference

This notebook contains reference material for DataStore to make it easier to store and retrieve any data and experiments. It currently supports the SQLite implementation native to Python.

Declarative DSL Guide

In declarative DSL notebook, you will learn how to use the declarative DSL style and manipulated sections to change an experiment's behavior without having to redefine the entire experiment.