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:

Custom quantum hardware
Publicly available cloud quantum computers
The Q-CTRL product suite

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

Installation¶

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.

Requirements¶

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 git@github.com:qctrl/python-open-controls.git

Once the clone is complete, you have two options:

Using setup.py
```
cd python-open-controls
python setup.py develop
```
Note: We recommend installing using develop to point your installation at the source code in the directory where you cloned the repository.
Using Poetry
```
cd python-open-controls
./setup-poetry.sh
```
Note: if you are on Windows, you’ll need to install Poetry manually, and use:
```
cd python-open-controls
poetry install
```

Once installed via one of the above methods, test your installation by running pytest in the python-open-controls directory.

pytest

Usage¶

See the Jupyter notebooks.

Reference¶

Contents:

qctrlopencontrols package
- Subpackages
- Module contents

Licence¶

Licence