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

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

2025-06-01 15:39:27作者:宗隆裙

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的多种安装方式,用户可根据实际需求选择最适合的安装方法。对于性能敏感的应用场景,建议从源码构建以获得最佳性能。

登录后查看全文
热门项目推荐