MQT QMAP量子电路映射工具安装指南

MQT QMAP是一款用于量子电路映射的开源工具，主要采用C++17开发并提供了Python绑定接口。本文将详细介绍如何在不同环境下安装和使用该工具。

推荐安装方式

对于大多数用户，我们推荐使用Python包管理工具进行安装，这种方式简单快捷且无需编译。

准备工作

建议使用现代Python包管理工具uv，它比传统工具更快速高效。安装方法如下：

macOS/Linux系统：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows系统：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安装MQT QMAP

使用uv安装：

uv pip install mqt.qmap

或者使用传统pip安装：

python -m pip install mqt.qmap

安装完成后，可通过以下命令验证：

python -c "import mqt.qmap; print(mqt.qmap.__version__)"

版本兼容性说明：从2.7.0版本开始，不再支持Python 3.8，建议使用Python 3.9或更高版本。

从源码构建（高性能版）

如需获得最佳性能，建议从源码构建安装：

uv pip install mqt.qmap --no-binary mqt.qmap --no-binary mqt.core

或使用pip：

pip install mqt.qmap --no-binary mqt.qmap --no-binary mqt.core

构建要求

1. 支持C++17的编译器
2. CMake 3.24或更高版本
3. SMT求解器Z3

Z3安装方法：

• Ubuntu系统：

  sudo apt-get install libz3-dev
  

• macOS系统：

  brew install z3
  

• 通过Python安装：

  pip install z3-solver
  

项目集成指南

Python项目集成

在项目配置文件中添加依赖项：

pyproject.toml：

[project]
dependencies = ["mqt.qmap>=3.0.0"]

setup.py：

from setuptools import setup

setup(
    install_requires=["mqt.qmap>=3.0.0"],
)

C++项目集成

使用FetchContent（推荐）

include(FetchContent)
set(FETCH_PACKAGES "")

set(MQT_QMAP_VERSION 3.0.0
    CACHE STRING "MQT QMAP version")
set(MQT_QMAP_REV "v3.0.0"
    CACHE STRING "MQT QMAP identifier")
set(MQT_QMAP_REPO_OWNER "cda-tum"
    CACHE STRING "MQT QMAP repository owner")

if(CMAKE_VERSION VERSION_GREATER_EQUAL 3.24)
  FetchContent_Declare(
    mqt-qmap
    GIT_REPOSITORY https://github.com/${MQT_QMAP_REPO_OWNER}/mqt-qmap.git
    GIT_TAG ${MQT_QMAP_REV}
    FIND_PACKAGE_ARGS ${MQT_QMAP_VERSION})
  list(APPEND FETCH_PACKAGES mqt-qmap)
else()
  find_package(mqt-qmap ${MQT_QMAP_VERSION} QUIET)
  if(NOT mqt-qmap_FOUND)
    FetchContent_Declare(
      mqt-qmap
      GIT_REPOSITORY https://github.com/${MQT_QMAP_REPO_OWNER}/mqt-qmap.git
      GIT_TAG ${MQT_QMAP_REV})
    list(APPEND FETCH_PACKAGES mqt-qmap)
  endif()
endif()

FetchContent_MakeAvailable(${FETCH_PACKAGES})

使用Git子模块

git submodule add https://github.com/munich-quantum-toolkit/qmap.git external/mqt-qmap

在CMakeLists.txt中添加：

add_subdirectory(external/mqt-qmap)

结语

本文详细介绍了MQT QMAP的多种安装方式，用户可根据实际需求选择最适合的安装方法。对于性能敏感的应用场景，建议从源码构建以获得最佳性能。