Skip to main content

A tool for Quantum Circuit Mapping

Project description

PyPI OS License: MIT CI Python-CI Bindings Documentation codecov

MQT QMAP - A tool for Quantum Circuit Compilation

A tool for quantum circuit compilation developed as part of the Munich Quantum Toolkit (MQT)[^1] by the Chair for Design Automation at the Technical University of Munich. It builds upon our quantum functionality representation (QFR).

Documentation

If you have any questions, feel free to contact us via quantum.cda@xcit.tum.de or by creating an issue on GitHub.

Getting Started

Overview Paper

QMAP is available via PyPI for Linux, macOS, and Windows and supports Python 3.8 to 3.11.

(venv) $ pip install mqt.qmap

Compiling a given quantum circuit to a certain device is as easy as

from mqt import qmap
from qiskit import QuantumCircuit
from qiskit.providers.fake_provider import FakeLondon

circ = QuantumCircuit(3)
circ.h(0)
circ.cx(0, 1)
circ.cx(0, 2)

circ_mapped, results = qmap.compile(circ, arch=FakeLondon())

Optimizing a Clifford circuit is as easy as

from mqt import qmap
from qiskit import QuantumCircuit

circ = QuantumCircuit(2)
circ.h(1)
circ.cx(0, 1)
circ.h(0)
circ.h(1)

circ_opt, results = qmap.optimize_clifford(circ)

Detailed documentation on all available methods, options, and input formats is available at ReadTheDocs.

System Requirements and Building

The implementation is compatible with any C++17 compiler, a minimum CMake version of 3.19, and Python 3.8+. Please refer to the documentation on how to build the project.

Building (and running) is continuously tested under Linux, macOS, and Windows using the latest available system versions for GitHub Actions.

References

QMAP has been developed based on methods proposed in the following papers:

[1] R. Wille and L. Burgholzer. MQT QMAP: Efficient Quantum Circuit Mapping. In International Symposium on Physical Design (ISPD), 2023.

[2] A. Zulehner, A. Paler, and R. Wille. An Efficient Methodology for Mapping Quantum Circuits to the IBM QX Architectures. IEEE Transactions on Computer Aided Design of Integrated Circuits and Systems (TCAD), 2018.

[3] R. Wille, L. Burgholzer, and A. Zulehner. Mapping Quantum Circuits to IBM QX Architectures Using the Minimal Number of SWAP and H Operations. In Design Automation Conference (DAC), 2019.

[4] S. Hillmich, A. Zulehner, and R. Wille. Exploiting Quantum Teleportation in Quantum Circuit Mapping. In Asia and South Pacific Design Automation Conference (ASP-DAC), 2021.

[5] L. Burgholzer, S. Schneider, and R. Wille. Limiting the Search Space in Optimal Quantum Circuit Mapping. In Asia and South Pacific Design Automation Conference (ASP-DAC), 2022.

[6] T. Peham, L. Burgholzer, and R. Wille. On Optimal Subarchitectures for Quantum Circuit Mapping. arXiv:2210.09321, 2022.

[7] S. Schneider, L. Burgholzer, and R. Wille. A SAT Encoding for Optimal Clifford Circuit Synthesis. In Asia and South Pacific Design Automation Conference (ASP-DAC), 2023.

[^1]: The Munich Quantum Toolkit was formerly known under the acronym JKQ and developed by the Institute for Integrated Circuits at the Johannes Kepler University Linz).

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

mqt.qmap-2.1.3.tar.gz (3.8 MB view details)

Uploaded Source

Built Distributions

mqt.qmap-2.1.3-cp311-cp311-win_amd64.whl (7.9 MB view details)

Uploaded CPython 3.11 Windows x86-64

mqt.qmap-2.1.3-cp311-cp311-manylinux_2_28_x86_64.whl (13.0 MB view details)

Uploaded CPython 3.11 manylinux: glibc 2.28+ x86-64

mqt.qmap-2.1.3-cp311-cp311-macosx_11_0_arm64.whl (9.3 MB view details)

Uploaded CPython 3.11 macOS 11.0+ ARM64

mqt.qmap-2.1.3-cp311-cp311-macosx_10_15_x86_64.whl (10.8 MB view details)

Uploaded CPython 3.11 macOS 10.15+ x86-64

mqt.qmap-2.1.3-cp310-cp310-win_amd64.whl (7.9 MB view details)

Uploaded CPython 3.10 Windows x86-64

mqt.qmap-2.1.3-cp310-cp310-manylinux_2_28_x86_64.whl (13.0 MB view details)

Uploaded CPython 3.10 manylinux: glibc 2.28+ x86-64

mqt.qmap-2.1.3-cp310-cp310-macosx_11_0_arm64.whl (9.3 MB view details)

Uploaded CPython 3.10 macOS 11.0+ ARM64

mqt.qmap-2.1.3-cp310-cp310-macosx_10_15_x86_64.whl (10.8 MB view details)

Uploaded CPython 3.10 macOS 10.15+ x86-64

mqt.qmap-2.1.3-cp39-cp39-win_amd64.whl (7.9 MB view details)

Uploaded CPython 3.9 Windows x86-64

mqt.qmap-2.1.3-cp39-cp39-manylinux_2_28_x86_64.whl (13.0 MB view details)

Uploaded CPython 3.9 manylinux: glibc 2.28+ x86-64

mqt.qmap-2.1.3-cp39-cp39-macosx_11_0_arm64.whl (9.3 MB view details)

Uploaded CPython 3.9 macOS 11.0+ ARM64

mqt.qmap-2.1.3-cp39-cp39-macosx_10_15_x86_64.whl (10.8 MB view details)

Uploaded CPython 3.9 macOS 10.15+ x86-64

mqt.qmap-2.1.3-cp38-cp38-win_amd64.whl (7.9 MB view details)

Uploaded CPython 3.8 Windows x86-64

mqt.qmap-2.1.3-cp38-cp38-manylinux_2_28_x86_64.whl (13.0 MB view details)

Uploaded CPython 3.8 manylinux: glibc 2.28+ x86-64

mqt.qmap-2.1.3-cp38-cp38-macosx_11_0_arm64.whl (9.3 MB view details)

Uploaded CPython 3.8 macOS 11.0+ ARM64

mqt.qmap-2.1.3-cp38-cp38-macosx_10_15_x86_64.whl (10.8 MB view details)

Uploaded CPython 3.8 macOS 10.15+ x86-64

File details

Details for the file mqt.qmap-2.1.3.tar.gz.

File metadata

  • Download URL: mqt.qmap-2.1.3.tar.gz
  • Upload date:
  • Size: 3.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.2

File hashes

Hashes for mqt.qmap-2.1.3.tar.gz
Algorithm Hash digest
SHA256 b76b7147ea5cb64a8acdc369de5cb35a9e31f691a5c8890f779f6d411912654c
MD5 9b3b6ac369bce91e637fbb0b3e10fcf3
BLAKE2b-256 83b29992242ec9cd59f60a941b3e39186a2c8a8679e3524afe505cc1674c6dba

See more details on using hashes here.

File details

Details for the file mqt.qmap-2.1.3-cp311-cp311-win_amd64.whl.

File metadata

File hashes

Hashes for mqt.qmap-2.1.3-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 41ebe8bb315c59ed6f97de385c1859a4cffab71132bc93324d60ddc2ab3f7810
MD5 e628e469bf038774c48abf51297c7e43
BLAKE2b-256 da3384f03b23ecda22fccc4afdf7d94229c094cacfbd08ebcf15142ea9218b72

See more details on using hashes here.

File details

Details for the file mqt.qmap-2.1.3-cp311-cp311-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for mqt.qmap-2.1.3-cp311-cp311-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 4c13176a5a02dfeaa56672f62c39873ae6a07f1872a812f05240e3d7fff244e5
MD5 341e9d82138148281858ece1941cd191
BLAKE2b-256 7f137f83650bc71e1aeabd445195759caaaf9c752fd064c08087bcc4f1ec11ac

See more details on using hashes here.

File details

Details for the file mqt.qmap-2.1.3-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for mqt.qmap-2.1.3-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 37b6ac94511e3000ccb1a5a79b4212d04ee2216539a3ee96777bb995e4c2359c
MD5 e8c0275dc25da6b0aeb05d625236dedf
BLAKE2b-256 ba40d965d23db075e006dbdb06aa7e13e176c8b337d6dd15db507a6a254cc403

See more details on using hashes here.

File details

Details for the file mqt.qmap-2.1.3-cp311-cp311-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for mqt.qmap-2.1.3-cp311-cp311-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 d6e560a2fcece294838668957d8c82a69c3ecb3323eabeeb55a02990c1ca041a
MD5 c18cb4fdace5794fe1421bcbf98b1174
BLAKE2b-256 e3403cb934cb839e7cd3d7efadf4908b2851fc67197e46e85e73702609c8ec4a

See more details on using hashes here.

File details

Details for the file mqt.qmap-2.1.3-cp310-cp310-win_amd64.whl.

File metadata

File hashes

Hashes for mqt.qmap-2.1.3-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 6779d619cc1a668d2ea6f97aa22196736e99f76b7651c3272c29b03658a71a32
MD5 5c74e5b1f3453e0db31b51f4cd62dcb9
BLAKE2b-256 8b6fe7c4fcc5477d102a4125acd0ea44b5b32533f1edd66780504a2b5d2c3036

See more details on using hashes here.

File details

Details for the file mqt.qmap-2.1.3-cp310-cp310-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for mqt.qmap-2.1.3-cp310-cp310-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 b4be4575f425219043cbfc924b66adbe1d31b939db280b6a53b07ac19e31509e
MD5 b7d53381449c19b7607a0403656d46fe
BLAKE2b-256 c61b6e34ee0a62268395771f46bb7658da052b4ade20059ae55aa70f11db53f0

See more details on using hashes here.

File details

Details for the file mqt.qmap-2.1.3-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for mqt.qmap-2.1.3-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 16c15a711a4dfb21ce7747690708b837e68179b4058dc4b1de73c374e7e08fa7
MD5 c7e27cdc761398eaaf59d539f3b2096a
BLAKE2b-256 92b17790f674dea8cb07e9d01015792c5228c81ec1ef29adaee64352c4b93eaf

See more details on using hashes here.

File details

Details for the file mqt.qmap-2.1.3-cp310-cp310-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for mqt.qmap-2.1.3-cp310-cp310-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 58f8f445730da335a130fe9a85eabf70cf780d7a2ecc9ae288559aa8e0bfacaa
MD5 60c589ebef9a403c9f200a56378dcab8
BLAKE2b-256 6887a644c714ea2d18c385c2da1f50996a3289fabb21b04bfd0abc75f9577e6c

See more details on using hashes here.

File details

Details for the file mqt.qmap-2.1.3-cp39-cp39-win_amd64.whl.

File metadata

  • Download URL: mqt.qmap-2.1.3-cp39-cp39-win_amd64.whl
  • Upload date:
  • Size: 7.9 MB
  • Tags: CPython 3.9, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.2

File hashes

Hashes for mqt.qmap-2.1.3-cp39-cp39-win_amd64.whl
Algorithm Hash digest
SHA256 3e5a50d9fdbc3a3de415108861eab10e65c8b291993bf12556d104baaa7f99fc
MD5 c3291e04d3a89571c2ac6fecaa8d0935
BLAKE2b-256 d1819994364f952c0d2ede1be7c3328b7654abdf24ca8224fca36903abcf9cd3

See more details on using hashes here.

File details

Details for the file mqt.qmap-2.1.3-cp39-cp39-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for mqt.qmap-2.1.3-cp39-cp39-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 913f15a870c9dda624e05b4c25a22a4f66148f1691dc2e32bbc9ac464b83c8e7
MD5 b74e5c817dcd67e1e71ee9419807fbef
BLAKE2b-256 516ed50d6c1d336af1bf426a3fea954257d70bb02dc77a54f5b1a6bfe8f8928c

See more details on using hashes here.

File details

Details for the file mqt.qmap-2.1.3-cp39-cp39-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for mqt.qmap-2.1.3-cp39-cp39-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 dba63fe2948be5953deb8081def19b2813d7cd123478e145bc0b4be7c73af4a9
MD5 bc6c821707c05c52a9a9a3e7bb594877
BLAKE2b-256 e2a118bfbd30681ba9e44e1e5de93134d072eae7906ebe66179b411ac6ca284c

See more details on using hashes here.

File details

Details for the file mqt.qmap-2.1.3-cp39-cp39-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for mqt.qmap-2.1.3-cp39-cp39-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 4604793ca76e88439531fb8a5d56b2afe1ff138d899b086f217e5f7ca1a2d64c
MD5 6980237a9340abe3e0e03c2ab8be82fb
BLAKE2b-256 d2b5e0b163db600cbc6c5096313894d5cb14eda00d433fec53d0d84ad01a35d5

See more details on using hashes here.

File details

Details for the file mqt.qmap-2.1.3-cp38-cp38-win_amd64.whl.

File metadata

  • Download URL: mqt.qmap-2.1.3-cp38-cp38-win_amd64.whl
  • Upload date:
  • Size: 7.9 MB
  • Tags: CPython 3.8, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.2

File hashes

Hashes for mqt.qmap-2.1.3-cp38-cp38-win_amd64.whl
Algorithm Hash digest
SHA256 bacfa4418a8ee5e423243f946ca010b9c914c47e616140adc4dec665a167f879
MD5 4638925ab864d21b48dd20fe869825cf
BLAKE2b-256 d98f06f197c5d58f498c326419c5453033bd900de7825f1efee003db508c58c6

See more details on using hashes here.

File details

Details for the file mqt.qmap-2.1.3-cp38-cp38-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for mqt.qmap-2.1.3-cp38-cp38-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 38a61f63641accbc35d7bf57b1841fe7b8830f9c3d23365db3a90f590016937c
MD5 6b1e8de219bfc9fa505e61f06a70d853
BLAKE2b-256 bbd6432a866b0a7762f0513f0ebdd6be2a8cd8d9a882040d5fd997cd653cc2ea

See more details on using hashes here.

File details

Details for the file mqt.qmap-2.1.3-cp38-cp38-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for mqt.qmap-2.1.3-cp38-cp38-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 756ad25098748c4e02503d054b2660853486395039bfb309db3516cfad688567
MD5 9e48d0ccea9e38e2ccbe1cfb44c30315
BLAKE2b-256 5b2e86b6cda8836c5c74e25de525dd1e867895aecd2df0d388c682390f69e569

See more details on using hashes here.

File details

Details for the file mqt.qmap-2.1.3-cp38-cp38-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for mqt.qmap-2.1.3-cp38-cp38-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 b577d50b7e76783890ddc403af5fb17af540af70a0e0311cc4c1a14e8efc7fdc
MD5 13a965cd5a6444e550bb3272bc592429
BLAKE2b-256 f5243eae8a2495617d9211d37b463a77f467093fc7f7f964550d7ab61b65ff01

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