Skip to main content

PyPI OS License: MIT CI CD Documentation codecov

MQT Banner

MQT QCEC - A tool for Quantum Circuit Equivalence Checking

A tool for quantum circuit equivalence checking developed as part of the Munich Quantum Toolkit (MQT). It builds upon MQT Core, which forms the backbone of the MQT.

Documentation

Key Features

  • Complementary equivalence checking engines: Decision-diagram construction, Alternating DD, Simulation-based falsification, and ZX-calculus rewriting—coordinated in an automated equivalence checking flow to prove equivalence or quickly find counterexamples.
  • Approximate equivalence checking with the projective Hilbert--Schmidt distance, including a standalone hybrid Schrödinger--Feynman checker for shallow circuits with few cross-cut gates. Guide
  • Compilation flow verification: validate transpiled/compiled circuits incl. layout permutations and measurements. Guide
  • Parameterized circuits: prove or refute equivalence with symbolic parameters. Guide
  • Partial equivalence: compare measured output distributions, handling ancillary and garbage qubits. Guide
  • Python-first API and Qiskit integration: pass QuantumCircuit or OpenQASM; one-call verify() or verify_compilation(). Quickstart • API
  • Efficient and portable: C++20 core with DD engines and ZX backend, prebuilt wheels for Linux/macOS/Windows via PyPI.

If you have any questions, feel free to create a discussion or an issue on GitHub.

Contributors and Supporters

The Munich Quantum Toolkit (MQT) is developed by the Chair for Design Automation at the Technical University of Munich and supported by MQSC. Among others, it is part of the Munich Quantum Software Stack (MQSS) ecosystem, which is being developed as part of the Munich Quantum Valley (MQV) initiative.

MQT Partner Logos

Thank you to all the contributors who have helped make MQT QCEC a reality!

Contributors to munich-quantum-toolkit/qcec

The MQT will remain free, open-source, and permissively licensed—now and in the future. We are firmly committed to keeping it open and actively maintained for the quantum computing community.

To support this endeavor, please consider:

Sponsor the MQT

Getting Started

MQT QCEC is available via PyPI.

uv pip install mqt.qcec

The following code gives an example on the usage:

from mqt import qcec

# verify the equivalence of two circuits provided as qasm files
result = qcec.verify("circ1.qasm", "circ2.qasm")

# print the result
print(result.equivalence)

Detailed documentation and examples are available at ReadTheDocs.

System Requirements and Building

Building the project requires a C++ compiler with support for C++20 and CMake 3.28 or newer. For details on how to build the project, please refer to the documentation. Building (and running) is continuously tested under Linux, macOS, and Windows using the latest available system versions for GitHub Actions. MQT QCEC is compatible with all officially supported Python versions.

Cite This

Please cite the work that best fits your use case.

MQT QCEC (the tool)

When citing the software itself or results produced with it, cite the MQT QCEC paper:

@article{burgholzerQCECJKQTool2021,
  title        = {{{QCEC}}: {{A JKQ}} tool for quantum circuit equivalence checking},
  author       = {Burgholzer, Lukas and Wille, Robert},
  year         = 2021,
  month        = feb,
  journal      = {Software Impacts},
  doi          = {10.1016/j.simpa.2020.100051}
}

The Munich Quantum Toolkit (the project)

When discussing the overall MQT project or its ecosystem, cite the MQT Handbook:

@inproceedings{mqt,
  title        = {The {{MQT}} Handbook: {{A}} Summary of Design Automation Tools and Software for Quantum Computing},
  shorttitle   = {{The MQT Handbook}},
  author       = {Wille, Robert and Berent, Lucas and Forster, Tobias and Kunasaikaran, Jagatheesan and Mato, Kevin and Peham, Tom and Quetschlich, Nils and Rovara, Damian and Sander, Aaron and Schmid, Ludwig and Schoenberger, Daniel and Stade, Yannick and Burgholzer, Lukas},
  year         = 2024,
  booktitle    = {IEEE International Conference on Quantum Software (QSW)},
  doi          = {10.1109/QSW62656.2024.00013},
  eprint       = {2405.17543},
  eprinttype   = {arxiv},
  addendum     = {A live version of this document is available at \url{https://mqt.readthedocs.io}}
}

Peer-Reviewed Research

When citing the underlying methods and research, please reference the most relevant peer-reviewed publications from the list below:

[1] L. Burgholzer and R. Wille. Advanced Equivalence Checking for Quantum Circuits. IEEE Transactions on Computer-Aided Design of Integrated Circuits and Systems (TCAD), 2021.

[2] L. Burgholzer, R. Raymond, and R. Wille. Verifying Results of the IBM Qiskit Quantum Circuit Compilation Flow. In IEEE International Conference on Quantum Computing and Engineering (QCE), 2020.

[3] L. Burgholzer, R. Kueng, and R. Wille. Random Stimuli Generation for the Verification of Quantum Circuits. In Asia and South Pacific Design Automation Conference (ASP-DAC), 2021.

[4] L. Burgholzer and R. Wille. Handling Non-Unitaries in Quantum Circuit Equivalence Checking. In Design Automation Conference (DAC), 2022.

[5] T. Peham, L. Burgholzer, and R. Wille. Equivalence Checking of Quantum Circuits with the ZX-Calculus. IEEE Journal on Emerging and Selected Topics in Circuits and Systems (JETCAS), 2022.

[6] T. Peham, L. Burgholzer, and R. Wille. Equivalence Checking of Parameterized Quantum Circuits: Verifying the Compilation of Variational Quantum Algorithms. In Asia and South Pacific Design Automation Conference (ASP-DAC), 2023.


Acknowledgements

The Munich Quantum Toolkit has been supported by the European Research Council (ERC) under the European Union's Horizon 2020 research and innovation program (grant agreement No. 101001318), the Bavarian State Ministry for Science and Arts through the Distinguished Professorship Program, as well as the Munich Quantum Valley, which is supported by the Bavarian state government with funds from the Hightech Agenda Bayern Plus.

MQT Funding Footer

Metadata

Release files for mqt-qcec 3.12.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mqt-qcec 3.12.0
File Size Uploaded Provenance Actions
mqt_qcec-3.12.0.tar.gz 340.7 kB With provenance Details for mqt_qcec-3.12.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for mqt-qcec 3.12.0
File Actions
mqt_qcec-3.12.0-cp315-abi3t-win_arm64.whl CPython 3.15 abi3t Windows ARM64 Details for mqt_qcec-3.12.0-cp315-abi3t-win_arm64.whl
mqt_qcec-3.12.0-cp315-abi3t-win_amd64.whl CPython 3.15 abi3t Windows x86-64 Details for mqt_qcec-3.12.0-cp315-abi3t-win_amd64.whl
mqt_qcec-3.12.0-cp315-abi3t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.15 abi3t Linux glibc 2.27+ x86-64, Linux glibc 2.28+ x86-64 Details for mqt_qcec-3.12.0-cp315-abi3t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
mqt_qcec-3.12.0-cp315-abi3t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl CPython 3.15 abi3t Linux glibc 2.26+ ARM64, Linux glibc 2.28+ ARM64 Details for mqt_qcec-3.12.0-cp315-abi3t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
mqt_qcec-3.12.0-cp315-abi3t-macosx_13_0_arm64.whl CPython 3.15 abi3t macOS 13.0+ ARM64 Details for mqt_qcec-3.12.0-cp315-abi3t-macosx_13_0_arm64.whl
mqt_qcec-3.12.0-cp311-abi3-win_arm64.whl CPython 3.11 abi3 Windows ARM64 Details for mqt_qcec-3.12.0-cp311-abi3-win_arm64.whl
mqt_qcec-3.12.0-cp311-abi3-win_amd64.whl CPython 3.11 abi3 Windows x86-64 Details for mqt_qcec-3.12.0-cp311-abi3-win_amd64.whl
mqt_qcec-3.12.0-cp311-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.11 abi3 Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 Details for mqt_qcec-3.12.0-cp311-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
mqt_qcec-3.12.0-cp311-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl CPython 3.11 abi3 Linux glibc 2.26+ ARM64, Linux glibc 2.28+ ARM64 Details for mqt_qcec-3.12.0-cp311-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
mqt_qcec-3.12.0-cp311-abi3-macosx_13_0_arm64.whl CPython 3.11 abi3 macOS 13.0+ ARM64 Details for mqt_qcec-3.12.0-cp311-abi3-macosx_13_0_arm64.whl

Total release size: 4.9 MB

Release files / mqt_qcec-3.12.0.tar.gz

Download URL mqt_qcec-3.12.0.tar.gz
Size 340.7 kB
Tags Source
SHA-256 checksum
How to use checksums
6014160c67f2a15b7bbe6b6f2712b76aaa70ac7ec0f1477fcc04702effeaed0c
BLAKE2b-256 checksum
How to use checksums
6b3c33d052d88f13e2cc0c1346ecd6e9c9fc74d32658f01afeedb50d9e2c4559
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Release files / mqt_qcec-3.12.0-cp315-abi3t-win_arm64.whl

Download URL mqt_qcec-3.12.0-cp315-abi3t-win_arm64.whl
Size 708.6 kB
Tags CPython 3.15 Windows ARM64 abi3t
SHA-256 checksum
How to use checksums
7457cbc572aff8b0283ff5ac287544bcfe55489e91de983b79e6c0e3d3a90acf
BLAKE2b-256 checksum
How to use checksums
52272a594a616b94f095e32f225b9e93d1068e8c16f0335b5c7b280c9357a111
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Release files / mqt_qcec-3.12.0-cp315-abi3t-win_amd64.whl

Download URL mqt_qcec-3.12.0-cp315-abi3t-win_amd64.whl
Size 525.9 kB
Tags CPython 3.15 Windows x86-64 abi3t
SHA-256 checksum
How to use checksums
27362deec92194b1afd4d32d92c523d8d5a0267fe31ca543959a50773c8b5497
BLAKE2b-256 checksum
How to use checksums
5f8122f52ceddac32188c6fce47e9bea8fdc15acdec693eb9449b2a7ec3ba097
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Release files / mqt_qcec-3.12.0-cp315-abi3t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL mqt_qcec-3.12.0-cp315-abi3t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 413.7 kB
Tags CPython 3.15 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 abi3t
SHA-256 checksum
How to use checksums
0d3989dc30f05b618e75be082763b7e28531fcfb2d6bcd2e04ece0b358a8ddc7
BLAKE2b-256 checksum
How to use checksums
a2dd84b411acff73bec281bcccaa02fcdf11c1d648ba5c20bf4b4f3c4ac95685
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Release files / mqt_qcec-3.12.0-cp315-abi3t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl

Download URL mqt_qcec-3.12.0-cp315-abi3t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
Size 375.9 kB
Tags CPython 3.15 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64 abi3t
SHA-256 checksum
How to use checksums
2594b60ed3eede0e1fc2ecedae031eadd88a1b9b48b89c1c62d8b3e7756d1e7c
BLAKE2b-256 checksum
How to use checksums
e3cad1e554a4a796e00d7329938651bedd61ee4dd81d8bc53406f680f88ee221
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Release files / mqt_qcec-3.12.0-cp315-abi3t-macosx_13_0_arm64.whl

Download URL mqt_qcec-3.12.0-cp315-abi3t-macosx_13_0_arm64.whl
Size 272.1 kB
Tags CPython 3.15 abi3t macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
386e378c239c313a7ef880c0c174f88df29fdcf7c232fd7861d09e01df03a928
BLAKE2b-256 checksum
How to use checksums
8127c574727c5741058f93279fd4eaf5f96701273146b2825ee89cd9baffd69f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Release files / mqt_qcec-3.12.0-cp311-abi3-win_arm64.whl

Download URL mqt_qcec-3.12.0-cp311-abi3-win_arm64.whl
Size 686.4 kB
Tags CPython 3.11 Windows ARM64 abi3
SHA-256 checksum
How to use checksums
7b1c0dcb6f7c0962a7adc8b6a7a6bc8f33e0be921ef973c5c1e9aa04d1758bb4
BLAKE2b-256 checksum
How to use checksums
fb549613c9ac443665cf501548dcd17d369cfcb5d7c56fd08a65ad5d059db464
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Release files / mqt_qcec-3.12.0-cp311-abi3-win_amd64.whl

Download URL mqt_qcec-3.12.0-cp311-abi3-win_amd64.whl
Size 509.8 kB
Tags CPython 3.11 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
e122fba65851b4eee0a7812fde2bf18facf012c1c8aa58e31e45239372ff47bf
BLAKE2b-256 checksum
How to use checksums
47d407729f43b9603420a0ad98e5069c26f070cbfa290952ca0caea9b2fa2664
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Release files / mqt_qcec-3.12.0-cp311-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL mqt_qcec-3.12.0-cp311-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 413.5 kB
Tags CPython 3.11 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
8e5a18dcf7f613d5086505d773aca79290c3d0cb10f577917c4eca15d1a671bf
BLAKE2b-256 checksum
How to use checksums
6f5930b4caf1dcf22bf2578eeb2d3b468cb7b58a89bef35c1f6617d2b847e2e9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Release files / mqt_qcec-3.12.0-cp311-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl

Download URL mqt_qcec-3.12.0-cp311-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
Size 375.6 kB
Tags CPython 3.11 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
01c564c8f6a4e334ea7acf87aaa071e26cb4cbf29d0275f20cf7e407fc630df1
BLAKE2b-256 checksum
How to use checksums
71b5377cfb96c5f1193b34e5064019d81067c8d2b1551bef7d980ddbdc0f2aac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Release files / mqt_qcec-3.12.0-cp311-abi3-macosx_13_0_arm64.whl

Download URL mqt_qcec-3.12.0-cp311-abi3-macosx_13_0_arm64.whl
Size 272.3 kB
Tags CPython 3.11 abi3 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
3338e83cb1aaab4efbb71dc41be530c104275c8c9834fee60e5623cce51ae27a
BLAKE2b-256 checksum
How to use checksums
ae92765b0b0d247e41126747faae99aebc49306fd3f78576dbd82b29f7c45030
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Security for mqt-qcec 3.12.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 11 files in this release have been uploaded with provenance metadata.

Select from 11 files

Attestation for mqt_qcec-3.12.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

3.12.0 This release

11 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page