real-time-control

This repository contains ARTIQ real-time control software for trapped-ion quantum networks.

An initial list of fundamental building blocks for real-time control of trapped-ion quantum networks have been identified and developed, which includes ion/qubit initialization, gate operations, and readout etc. These building blocks are developed in a modular manner, and can be composed and combined flexibly to implement more complex functions.

The key features of this software include:

• The modular design of real-time control functions. All real-time control functions run on a node (e.g., Q-node) can be thought of as a set of building blocks arranged into specific time-ordered sequences. These building blocks can be conveniently grouped together into self-contained sub-sequences, each with a clear purpose. This means that all building blocks needed to achieve a specific task are grouped in order to form a sub-sequence. This refactoring process can be repeated to create a hierarchical, tree-like structure with a top-level sequence composed of sub-sequences, which are in turn made up of other sub-sequences, and so on down to the basic elemental sub-sequences that cannot be further decomposed.
• Support for the “scan” capabilities. The ability to scan a parameter across a range of values is crucial for many quantum network operations, particularly for “calibration routines”, which form a specialized category of scans. Calibration routines are essential for monitoring and addressing physiological variations of the testbed conditions to achieve optimal performance.

ARTIQ dashboard on Linux/UNIX

This software has been tested with ARTIQ 7 and ARTIQ 8. Initial development was performed using ARTIQ 7.

Run the dashboard scripts from the exp directory so that the relative experiments/ path is resolved correctly:

cd exp
chmod +x launch_dashboard.sh terminate_dashboard.sh
./launch_dashboard.sh

This starts the ARTIQ session in the background and scans the experiment repository. To tear down the dashboard and its ARTIQ processes, run:

cd exp
./terminate_dashboard.sh

Note: terminate_dashboard.sh force-stops all processes whose command contains artiq for the current user. Save any work and make sure no other ARTIQ sessions need to remain running before executing it.

License

QuantNet Real-time Control is Copyright (c) 2026, The Regents of the University of California, through Lawrence Berkeley National Laboratory, and the University of California, Berkeley. Except where otherwise noted, it is distributed under the terms in the LICENSE file.

The files in exp/datasets/scan_framework are derived from the NIST ARTIQ Scan Framework and are licensed under LGPL-3.0-only. See the included license notice for details.