Skip to content
πŸŽ› Q-CTRL Open Controls
Branch: master
Clone or download
Latest commit 2fb2fb8 May 23, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci some minor problems fixed May 6, 2019
examples Updated jupyter notebook May 9, 2019
tests pre_post_gate_parameters=None changes behaviour - omits pre_post_gate… May 20, 2019
.pylintrc Initial Commit Apr 16, 2019
LICENSE Initial Commit Apr 16, 2019 Kick CircleCI off Apr 16, 2019 some minor problems fixed May 6, 2019

Q-CTRL Open Controls

Q-CTRL Open Controls is an open-source Python package that makes it easy to create and deploy established error-robust quantum control protocols from the open literature. The aim of the package is to be the most comprehensive library of published and tested quantum control techniques developed by the community, with easy to use export functions allowing users to deploy these controls on:

Anyone interested in quantum control is welcome to contribute to this project.

Table of Contents


Q-CTRL Open Controls can be install through pip or from source. We recommend the pip distribution to get the most recent stable release. If you want the latest features then install from source.


To use Q-CTRL Open Controls you will need an installation of Python. We recommend using the Anaconda distribution of Python. Anaconda includes standard numerical and scientific Python packages which are optimally compiled for your machine. Follow the Anaconda Installation instructions and consult the Anaconda User guide to get started.

We use interactive jupyter notebooks for our usage examples. The Anaconda python distribution comes with editors for these files, or you can install the jupyter notebook editor on its own.

Using PyPi

Use pip to install the latest version of Q-CTRL Open Controls.

$ pip install qctrl-open-controls

From Source

The source code is hosted on Github. The repository can be cloned using

$ git clone

Once the clone is complete, you can run the install script.

$ cd python-open-controls
$ python develop

Note: We recommend installing using develop to point your installation at the source code in the directory where you cloned the repository.

To test your installation run pytest in the python-open-controls directory.

$ pytest


Usage depends on the application. We've provided a set of example Jupyter notebooks addressing a variety of quantum control problems. Below is a short description of each notebook grouped by application. For further details on usage, use the inline documentation in the source code.

Dynamical Decoupling Sequences (DDS)

Q-CTRL Open Controls can create a large library of standard DDS which can be exported in a variety of formats.

Create a DDS

examples/creating_a_dds.ipynb demonstrates how to use Q-CTRL Open Controls to create a DDS from a large library of published dynamical decoupling protocols. It also shows how to make Custom DDS with timings, offsets and unitaries defined by the user. The notebook shows how to export a DDS for deployment in the Q-CTRL products or your quantum hardware.

Export a DDS to Qiskit

examples/running_a_dds_on_ibm_q.ipynb demonstrates how to take a DDS and convert it to a Qiskit circuit so it can be run on IBM's quantum computers. It also demonstrates using a DDS to improve the performance of a quantum circuit execution by extending the coherence time of a qubit.


See Contributing.


See Contributors.



You can’t perform that action at this time.