Quantum Operation Quantum Operation
Yes we use reduplication
qoqo is a toolkit to represent quantum circuits by HQS Quantum Simulations.
This repository contains two components:
- roqoqo: the core rust library
- qoqo: the python interface to roqoqo
What roqoqo/qoqo is:
- A toolkit to represent quantum operations and circuits
- A thin runtime to run quantum measurements
- A way to serialize quantum circuits and measurement information
- A set of optional interfaces to devices, simulators and toolkits (e.g. qoqo_qest, qoqo_mock, qoqo_qasm)
What roqoqo/qoqo is not:
- A decomposer translating circuits to a specific set of gates
- A quantum circuit optimizer
- A collection of quantum algorithms
roqoqo provides:
- A circuit struct to represent quantum programs
- Single-Qubit, Two-Qubit and Multi-Qubit Operations that can be executed (decomposed) on any universal quantum computer
- PRAGMA Operations that only apply to certain hardware, simulators or annotate circuits with additional information
- Classical Registers and Measurement operations to use with a quantum program
- Measurement structs for evaluating observable measurements based on projective measurements from quantum hardware or simulator readouts
- A Backend trait defining a standard for interfacing from qoqo to other toolkits, hardware and simulators that can return measured values
- Serialize and deserialize support for circuits and measurement information via the serde crate.
This software is still in the beta stage. Functions and documentation are not yet complete and breaking changes can occur.
To use roqoqo in a Rust project simply add
roqoqo = {version="0.8"}to the [dependencies] section of the project Cargo.toml.
qoqo provides a full python interface to the underlying roqoqo library, including:
- A circuit class to represent quantum programs
- Single-Qubit, Two-Qubit and Multi-Qubit Operations that can be executed (decomposed) on any universal quantum computer
- PRAGMA Operations that only apply to certain hardware, simulators or annotate circuits with additional information
- Classical Register and Measurement operations to use with a quantum program
- Measurement structs for evaluating observable measurements based on projective measurements from quantum hardware or simulator readouts
- A DoUnitary class combining circuits and measurement information in complete quantum programms with a simple interface
- Serialization to json and deserialization from json for circuits and measurement information. Serialization support can easily be expanded to other targets with the help of the serde crate.
On Linux and macOS on x86 precompiled packages can be found on PyPi and installed via
pip install qoqoFor other platforms we recommend using the source distribution from PyPi to build a python package for qoqo locally via pip. The install requires the maturin tool (also available via pip) and a working rust toolchain. Specifically for macOS on Apple Silicon the following build command should be used:
RUSTFLAGS="-C link-arg=-undefined -C link-arg=dynamic_lookup" pip install qoqoAlternatively one can check out the latest tagged version from github and use the maturin tool to build a python package for qoqo locally and install it via pip.
Please note that the package should be built from the top level directory of the workspace selecting the qoqo package with the -m qoqo/Cargo.toml option.
Specifically for macOS on Apple Silicon the following build command should be used.
RUSTFLAGS="-C link-arg=-undefined -C link-arg=dynamic_lookup" maturin build -m qoqo/Cargo.toml --release
pip install target/wheels/$NAME_OF_WHEELWhen using qoqo in a rust project providing a python interface add
qoqo = {version="0.9", default-features=false}to the [dependencies] section of the project Cargo.toml.
For an expanded collection of Examples see the jupyter notebooks in qoqo/examples. The examples require the qoqo_quest and qoqo_mock interfaces.
We welcome contributions to the project. If you want to contribute code, please have a look at CONTRIBUTE.md for our code contribution guidelines.