Skip to main content

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

Project description

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

Uploaded Source

Built Distribution

circuit_knitting_toolbox-0.3.0-py3-none-any.whl (120.3 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for circuit_knitting_toolbox-0.3.0.tar.gz
Algorithm Hash digest
SHA256 5c43a5417d60c2aef2f732a9c25fcd106f95072eefe1c29f6d94644cd86e50ac
MD5 69e982f3b7c4243d02f5ddf74e66ea20
BLAKE2b-256 779b1e0216607396c0b2cd9fd8a67311129dbac4d17991eb1f02c43f4dbe870a

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for circuit_knitting_toolbox-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 76ead307d6b9f87a665049405a9cb81304f2eada1019243ec26bee507e41197d
MD5 8d7357ffd85db491a26bcdabbf0e3454
BLAKE2b-256 02338c517e6e3ce539bf17cdcf781bc968f30bac80e91f0c4a52f57cee59e4bc

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