Package: qick
QICK: Quantum Instrumentation Control KitThe 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.TheqickPython packageA quick start guidefor setting up your board and running a Jupyter notebook exampleJupyter notebook examplesdemonstrating usageMore examples and tutorialfrom IEEE Quantum Week 2023.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.Download and InstallationFollow the quick start guide locatedhereto set up your board, installqickon your board, and run a Jupyter notebook example.DocumentationThe API documentation for QICK is available at:https://qick-docs.readthedocs.io/Thedemo notebooksare 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.UpdatesFrequent 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.ContributeYou are welcome to contribute to QICK development by forking this repository and sending pull requests.All contributions are expected to be consistent withPEP 8 -- Style Guide for Python Code.We welcome comments, bug reports, and feature requests via GitHub Issues.You can chat with us in the #qick channel on theUnitary Fund Discord, where we also haveweekly office hours.LicenseThe QICK source code is licensed under the MIT license, which you can find in the LICENSE file.
TheQICK logowas 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.