MQT QMAP - A Tool for Mapping Quantum Circuits onto various Hardware Technologies

MQT QMAP is an open-source C++17 and Python library for mapping quantum circuits onto various hardware technologies developed as part of the Munich Quantum Toolkit (MQT) [1].

This documentation provides a comprehensive guide to the MQT QMAP library, including installation instructions, demo notebooks, and detailed API documentation. The source code of MQT QMAP is publicly available on GitHub at munich-quantum-toolkit/qmap, while pre-built binaries are available via PyPI for all major operating systems and all modern Python versions. MQT QMAP is fully compatible with Qiskit 1.0 and above.

We recommend you to start with the installation instructions or by reading our overview paper [1]. Then proceed to the mapping page, the synthesis/optimization page, the neutral atom state preparation page, or the zoned neutral atom compiler, and read the reference documentation. If you are interested in the theory behind QMAP, have a look at the publications in the publication list.

We appreciate any feedback and contributions to the project. If you want to contribute, you can find more information in the Contribution guide. If you are having trouble with the installation or the usage of QMAP, please let us know at our Support page or by reaching out to us at quantum.cda@xcit.tum.de.

User Guide

• Installation
  • Building from source for performance
  • Integrating MQT QMAP into your project
• Quantum Circuit Mapping
  • Exact Mapping
  • Heuristic Mapping
• Synthesis of Clifford Circuits
  • Clifford Circuits
  • Using QMAP for Optimal Synthesis
• Neutral Atom Logical State Preparation
• Zoned Neutral Atom Compiler
  • Example: GHZ State on Neutral Atom Architecture
• References
• Changelog
  • Unreleased
  • 3.2.0 - 2025-07-16
  • 3.1.3 - 2025-05-28
  • 3.1.2 - 2025-05-27
  • 3.1.1 - 2025-05-27
  • 3.1.0 - 2025-05-26
  • 3.0.0 - 2025-05-08
  • 2.8.0 - 2024-11-18
• Upgrade Guide
  • Unreleased
  • 3.2.0
  • 3.1.0
  • 3.0.0

Developers

• Contributing
• Support
• Development Guide

---

[1]

The Munich Quantum Toolkit (MQT) is a collection of software tools for quantum computing developed by the Chair for Design Automation at the Technical University of Munich as well as the Munich Quantum Software Company (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.