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.5.0.tar.gz (1.3 MB view details)

Uploaded Source

Built Distribution

circuit_knitting_toolbox-0.5.0-py3-none-any.whl (122.1 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for circuit_knitting_toolbox-0.5.0.tar.gz
Algorithm Hash digest
SHA256 118c552ef52e2304ab0671fdbf1d5ba13f591d6a9a04c43e762525655a452eb5
MD5 44929b128b6717da6178207cd91c9fd8
BLAKE2b-256 aa4111b8d6ee2b182a2a61ced6aa072b8899887f2ea7d4b1a03f0859065a32ba

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for circuit_knitting_toolbox-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1db54c723c923cc66d2dfa87090a28e863d86247cc6742a90effea0b57ba2904
MD5 dd818845c26661e5d006808de3782f77
BLAKE2b-256 893d662ed3c163c4ce94fcce29549920fb14f4405c67fb86be8f3489f59873b7

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