Skip to main content

A software prototype for a circuit knitting toolbox which connects user applications with runtime primitives

Project description

Stability Release Platform Python Qiskit Qiskit Nature
Docs (stable) DOI License Downloads Tests Coverage

Circuit Knitting Toolbox

Table of Contents


About

Circuit Knitting is the process of decomposing a quantum circuit into smaller circuits, executing those smaller circuits on a quantum processor(s), and then knitting their results into a reconstruction of the original circuit's outcome. Circuit knitting includes techniques such as entanglement forging, circuit cutting, and classical embedding. The Circuit Knitting Toolbox (CKT) is a collection of such tools.

Each tool in the CKT partitions a user's problem into quantum and classical components to enable efficient use of resources constrained by scaling limits, i.e. size of quantum processors and classical compute capability. It can assign the execution of "quantum code" to QPUs or QPU simulators and "classical code" to various heterogeneous classical resources such as CPUs, GPUs, and TPUs made available via hybrid cloud, on-prem, data centers, etc.

The toolbox enables users to run parallelized and hybrid (quantum + classical) workloads without worrying about allocating and managing underlying infrastructure.

The toolbox currently contains the following tools:

  • Entanglement Forging [1]
  • Circuit Cutting [2-7]

Documentation

All CKT documentation is available at https://qiskit-extensions.github.io/circuit-knitting-toolbox/.


Installation

We encourage installing CKT via pip, when possible. Users intending to use the entanglement forging tool should install the pyscf optional dependency. Users intending to use the automatic cut finding functionality in the CutQC package should install the cplex optional dependency.

pip install 'circuit-knitting-toolbox[cplex,pyscf]'

For information on installing from source, running CKT in a container, and platform support, refer to the installation instructions in the CKT documentation.


Deprecation Policy

This project is meant to evolve rapidly and, as such, does not follow Qiskit's deprecation policy. We may occasionally make breaking changes in order to improve the user experience. When possible, we will keep old interfaces and mark them as deprecated, as long as they can co-exist with the new ones. Each substantial improvement, breaking change, or deprecation will be documented in the release notes.


References

[1] Andrew Eddins, Mario Motta, Tanvi P. Gujarati, Sergey Bravyi, Antonio Mezzacapo, Charles Hadfield, Sarah Sheldon, Doubling the size of quantum simulators by entanglement forging, PRX Quantum 3, 010309 (2022).

[2] Kosuke Mitarai, Keisuke Fujii, Constructing a virtual two-qubit gate by sampling single-qubit operations, New J. Phys. 23 023021.

[3] Kosuke Mitarai, Keisuke Fujii, Overhead for simulating a non-local channel with local channels by quasiprobability sampling, Quantum 5, 388 (2021).

[4] Christophe Piveteau, David Sutter, Circuit knitting with classical communication, arXiv:2205.00016 [quant-ph].

[5] Lukas Brenner, Christophe Piveteau, David Sutter, Optimal wire cutting with classical communication, arXiv:2302.03366 [quant-ph].

[6] Wei Tang, Teague Tomesh, Martin Suchara, Jeffrey Larson, Margaret Martonosi, CutQC: Using small quantum computers for large quantum circuit evaluations, Proceedings of the 26th ACM International Conference on Architectural Support for Programming Languages and Operating Systems. pp. 473 (2021).

[7] K. Temme, S. Bravyi, and J. M. Gambetta, Error mitigation for short-depth quantum circuits, Physical Review Letters, 119(18), (2017).


License

Apache License 2.0

Project details


Download files

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

Source Distribution

circuit_knitting_toolbox-0.4.0.tar.gz (1.3 MB view details)

Uploaded Source

Built Distribution

circuit_knitting_toolbox-0.4.0-py3-none-any.whl (122.6 kB view details)

Uploaded Python 3

File details

Details for the file circuit_knitting_toolbox-0.4.0.tar.gz.

File metadata

File hashes

Hashes for circuit_knitting_toolbox-0.4.0.tar.gz
Algorithm Hash digest
SHA256 a962cc51a300a57a23f6153a86a38f17e5b4280c35bec0372846820b778d8839
MD5 0a422bf629f65a6ac0130ea3fa3cdd43
BLAKE2b-256 e033cfb2765a0ede2cac985aa6af6a958be77f1df1047689789c97025f6cb1a0

See more details on using hashes here.

File details

Details for the file circuit_knitting_toolbox-0.4.0-py3-none-any.whl.

File metadata

File hashes

Hashes for circuit_knitting_toolbox-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e4983958d4d6257eb969d59db3c269a7567e4aad78e4210513d677332c88b902
MD5 93d51abaeb45767f962aa63e6d4ef497
BLAKE2b-256 1f1697c75481f0bac9024f387910571b83609affa7ef4d58e7e6aee700757d0f

See more details on using hashes here.

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