Skip to main content

PyPI discord

License

QUA Language Tools

The QUA language tools package includes various tools useful while writing QUA programs and performing experiments.

It includes:

  • QUA Loops Tools - This library includes tools for parametrizing QUA for_ loops using the numpy (linspace, arange, logspace) methods or by directly inputting a numpy array.

  • Plotting Tools - This library includes tools to help handling plots from QUA programs.

  • Result Tools - This library includes tools for handling and fetching results from QUA programs, and saving them to the local file storage.

  • Units Tools - This library includes tools for using units (MHz, us, mV...) and converting data to other units (demodulated data to volts for instance).

  • Analysis Tools - This library includes tools for analyzing data from experiments. It currently has a two-states discriminator for analyzing the ground and excited IQ blobs.

  • Octave Tools - This library includes tools for controlling the Octave and extract/set the correction parameters from the calibration database.

  • Multi-user tools - This library includes tools for working with the QOP in a multi-user or multi-process setting.

  • Simulator tools - This library includes tools for creating simulations.

  • Bakery - This library introduces a new framework for creating arbitrary waveforms and storing them in the usual configuration file. It allows defining waveforms in a QUA-like manner while working with 1ns resolution (or higher).

  • External Frameworks - This library introduces drivers for integrating the OPX within external frameworks such as QCoDeS. Please refer to the examples section for more details about how to use these drivers.

  • Video Mode - This module allows the user to update some pre-defined parameters of a QUA program while fetching data from the OPX for dynamic tuning. Please refer to the examples section for more details about how to implement this module.

  • Addons:

    • Calibrations - This module allows to easily perform most of the standard single qubit calibrations from a single python file.
    • Interactive Plot Library - This package drastically extends the capabilities of matplotlib, enables easily editing various parts of the figure, copy-pasting data between figures and into spreadsheets, fitting the data and saving the figures.
    • assign_variables_to_element - Forces the given variables to be used by the given element thread. Useful as a workaround for when the compiler wrongly assigns variables which can cause gaps.
  • Config Tools - This package includes tools related to the QOP configuration file, including:

    • Integration Weights Tools - This package includes tools for the creation and manipulation of integration weights.
    • Waveform Tools - This package includes tools for creating waveforms useful for experiments with the QOP.
    • Config Helper Tools - This package includes tools for writing and updating the configuration.
    • Config GUI - This package contains a GUI for creating and visualizing the configuration file - No longer being actively developed.
    • Config Builder - This package contains an API for creating and manipulation configuration files - No longer being actively developed.
  • Control Panel- This package includes tools for directly controlling the OPX.

    • ManualOutputControl - This module allows controlling the outputs from the OPX in CW mode. Once created, it has an API for defining which channels are on. Analog channels also have an API for defining their amplitude and frequency.
    • VNA - This module allows to configure the OPX as a VNA for a given element (readout resonator for instance) and operation (readout pulse for instance) already defined in the configuration. Once created, it has an API for defining which measurements are to be run depending on the down-conversion solution used (ED: envelope detector, IR: image rejection mixer, IQ: IQ mixer).
  • Macros - This module includes convenience functions for encapsulating common QUA code.

  • Digital filters - Library of functions allowing the derivation of the digital filter taps to correct distortions.

  • Voltage Gates - The VoltageGateSequence class facilitates the creation and management of complex pulse sequences for quantum operations, allowing for dynamic voltage control, ramping, and bias compensation across multiple gate elements.

  • Wirer - The wirer tool allows for automatic allocation of arbitrary channels to an arbitrary combination of instruments.

Installation

Install the current version using pip, the --upgrade flag ensures that you will get the latest version.

pip install --upgrade qualang-tools

Note that in order use the Interactive Plot Library, you need to install using

pip install --upgrade qualang-tools[interplot]

Note that in order to run 2-Qubit Randomized Benchmarking, you need to install using

pip install --upgrade qualang-tools[two-qubit-rb]
# Note that `cirq` will only be installed if your python version exceeds 3.10. 
# Otherwise, install it separately, i.e., pip install cirq==1.2.0

Note that in order to use the data handler, you need to install using:

pip install --upgrade qualang-tools[datahandler]

Note that in order use the Config GUI or Config Builder, you need to install using

pip install --upgrade qualang-tools[configbuilder]

Support and Contribution

Have an idea for another tool? A way to improve an existing one? Found a bug in our code?

We'll be happy if you could let us know by opening an issue on the GitHub repository.

Feel like contributing code to this library? We're thrilled! Please follow this guide and feel free to contact us if you need any help, you can do it by opening an issue :)

Usage

Examples for using various tools can be found on the QUA Libraries Repository.

Examples for using the Baking toolbox, including 1-qubit randomized benchmarking, cross-entropy benchmark (XEB), high sampling rate baking and more can be found here.

Metadata

Release files for qualang-tools 0.24.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for qualang-tools 0.24.0
File Size Uploaded Provenance Actions
qualang_tools-0.24.0.tar.gz 4.4 MB Without provenance Details for qualang_tools-0.24.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for qualang-tools 0.24.0
File Interpreter ABI Platform Actions
qualang_tools-0.24.0-py3-none-any.whl Python 3 none any Details for qualang_tools-0.24.0-py3-none-any.whl

Total release size: 9.0 MB

Release files / qualang_tools-0.24.0.tar.gz

Download URL qualang_tools-0.24.0.tar.gz
Size 4.4 MB
Tags Source
SHA-256 checksum
How to use checksums
95baa17b514c3fdbd0b4956c82c65965e8a2d234f52340a9b86bc225a146f3fc
BLAKE2b-256 checksum
How to use checksums
c60426fd3456860bd4365fdb4e13f561e2d79cb2e8d48a7aa20aaf2187f7cf7e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.13

Release files / qualang_tools-0.24.0-py3-none-any.whl

Download URL qualang_tools-0.24.0-py3-none-any.whl
Size 4.5 MB
Tags Python 3
SHA-256 checksum
How to use checksums
9d7e15a201e4384e1fe1ebcd622f25c66aa5b902b608b481bfa1005a262dfe2c
BLAKE2b-256 checksum
How to use checksums
6fcd61cc06ab0b8bd428e836eb9fc690e10519d6681089f9327432910307fe07
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.13

Security for qualang-tools 0.24.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.24.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page