Skip to main content

Quantum Instrumentation Controller Kit software library

Project description

QICK logo

QICK: Quantum Instrumentation Control Kit

The QICK is a kit of firmware and software to use the Xilinx RFSoC to control quantum systems.

It consists of:

  • Firmware for the ZCU111, ZCU216, and RFSoC4x2 evaluation boards. We generally recommend using the newer generation of RFSoCs (ZCU216 and RFSoC4x2) for better overall performance.
  • The qick Python package
  • A quick start guide for setting up your board and running a Jupyter notebook example
  • Jupyter notebook examples demonstrating usage

Other examples and tutorials (compatibility with the current QICK software is not guaranteed):

Note: The firmware and software here is still very much a work in progress. This is an alpha release. We strive to be consistent with the APIs but cannot guarantee backwards compatibility.

Announcements

The QICK group at Fermilab is currently hiring two engineering positions, where the primary focus will be firmware development for QICK.

Download and Installation

Follow the quick start guide located here to set up your board, install qick on your board, and run a Jupyter notebook example.

If you want your board's state to persist between notebooks or scripts, you should install Pyro4 on your board and run QICK in a Pyro server: Pyro demo

If you would like to save the instrument configuration for every measurement using QCoDeS, you can also install this QCoDeS driver.

If you're interested in using QICK to control and read out NV centers or other quantum defects, you might be interested in QICK-DAWG which extends QICK with pulses and measurement programs specific to that application.

Documentation

The API documentation for QICK is available at: https://qick-docs.readthedocs.io/

The demo notebooks are intended as a tutorial. The first demos explain important features of the QICK system and walk you through how to write working QICK programs. The later demos provide examples of useful measurements you might make with the QICK. We recommend that new users read and understand all of the demos.

Updates

Frequent updates to the QICK firmware and software are made as pull requests. Each pull request will be documented with a description of the notable changes, including any changes that will require you to change your code. We hope that this will help you decide whether or not to update your local code to the latest version. We strive for, but cannot guarantee, bug-free and fully functional pull requests. We also do not guarantee that the demo notebooks will keep pace with every pull request, though we make an effort to update the demos after major API changes.

Our version numbering follows the format major.minor.PR, where PR is the number of the most recently merged pull request. This will result in the PR number often skipping values, and occasionally decreasing. The tagged release of a new minor version will have the format major.minor.0.

Tagged releases can be expected periodically. We recommend that everyone should be using at least the most recent release. We guarantee the following for releases:

  • The demo notebooks will be compatible with the QICK library, and will follow our current best recommendations for writing QICK programs.
  • The firmware images for all supported boards will be fully compatible with the library and the demo notebooks.
  • Release notes will summarize the pull request notes and explain both breaking API changes (what you need to change in your code) and improvements (why you should move to the new release).

We recommend that you "watch" this repository on GitHub to get automatic notifications of pull requests and releases.

Contribute

You are welcome to contribute to QICK development by forking this repository and sending pull requests.

All contributions are expected to be consistent with PEP 8 -- Style Guide for Python Code.

We welcome comments, bug reports, and feature requests via GitHub Issues.

Find us on the Unitary Fund Discord: chat with us in the #qick channel or the weekly office hours.

License

The QICK source code is licensed under the MIT license, which you can find in the LICENSE file. The QICK logo was designed by Dr. Christie Chiu.

You are free to use this software, with or without modification, provided that the conditions listed in the LICENSE file are satisfied.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qick-0.2.297.tar.gz (16.6 MB view details)

Uploaded Source

Built Distribution

qick-0.2.297-py3-none-any.whl (17.1 MB view details)

Uploaded Python 3

File details

Details for the file qick-0.2.297.tar.gz.

File metadata

  • Download URL: qick-0.2.297.tar.gz
  • Upload date:
  • Size: 16.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for qick-0.2.297.tar.gz
Algorithm Hash digest
SHA256 cc7df4f69416850fe49485bb909897ebb3a3369edfaf430e14dbc12c4d33e460
MD5 5d6cf8afcd67b69dba12f177719c3676
BLAKE2b-256 78badb25a5d56106c2ccc009a144f109ed6d3f994005885f217fcae2982bebc8

See more details on using hashes here.

Provenance

The following attestation bundles were made for qick-0.2.297.tar.gz:

Publisher: wheels.yml on openquantumhardware/qick

Attestations:

File details

Details for the file qick-0.2.297-py3-none-any.whl.

File metadata

  • Download URL: qick-0.2.297-py3-none-any.whl
  • Upload date:
  • Size: 17.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for qick-0.2.297-py3-none-any.whl
Algorithm Hash digest
SHA256 f171041d136e9672648b96c83a1ec0661f3341db8428a031ded63c5e278f9e1f
MD5 90d17f852963efed0b8fbac0e5b7ef01
BLAKE2b-256 0dfd472392eb6d0d3f6c29625d786c9a90a189d495caa19319c8a2d85bc1a2d3

See more details on using hashes here.

Provenance

The following attestation bundles were made for qick-0.2.297-py3-none-any.whl:

Publisher: wheels.yml on openquantumhardware/qick

Attestations:

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page