intellabs/intel_quantum_sdk

Intel® Quantum SDK Docker镜像文档

镜像概述和主要用途

Intel® Quantum SDK（软件开发工具包）Docker镜像用于提供与Intel量子计算栈交互的软件环境。该SDK允许用户开发、编译和运行量子加速应用，通过C++编程语言扩展实现量子电路描述，并支持针对Intel量子硬件兼容的多种后端执行。镜像包含完整的开发工具链、示例程序及两种模拟器后端，适用于量子算法研究、量子程序开发与测试。

核心功能和特性

1. 基于C++的用户界面
   提供扩展的C++命令式编程环境，支持量子逻辑操作级别的量子电路表达，符合硬件加速器开发范式。

2. LLVM编译器框架优化
   集成LLVM编译器框架，针对Intel量子计算栈提供专用优化和分解序列，提升量子程序执行效率。

3. 完整编译流程
   生成可执行文件的全流程编译工具，支持用户选择与Intel量子硬件兼容的后端（模拟器或实际硬件）。

4. 两种模拟器后端

   • Intel® Quantum Simulator (IQS)：全状态向量量子模拟，提供量子比特状态的完整描述。
   • Quantum Dot (QD)模拟器：结合状态向量模拟与物理量子操作模拟，提供更接近实际硬件的真实结果（计算强度更高）。

使用场景和适用范围

• 量子计算应用程序开发与调试
• 量子算法原型设计与性能评估
• 量子电路模拟与验证
• 量子硬件加速器软件开发学习

详细使用方法和配置说明

容器快速启动

通过Docker引擎启动交互式容器，获取SDK开发环境：

bash
docker run --name myIQSDK -it intellabs/intel_quantum_sdk /bin/bash

说明：--name myIQSDK指定容器名称，-it启用交互式终端，intellabs/intel_quantum_sdk为镜像名称，/bin/bash启动bash shell。

命令行操作

容器启动后，默认进入/home目录，SDK环境已配置完成。

查看SDK安装组件

bash
ls ${IQSDK_ROOT}  # IQSDK_ROOT为指向SDK安装目录的环境变量

编译并运行示例程序

1. 复制示例代码到工作目录：

   bash
   cp ${IQSDK_ROOT}/quantum-examples/teleport.cpp .
   

2. 使用Intel量子编译器编译：

   bash
   intel-quantum-compiler teleport.cpp
   

3. 执行生成的可执行文件：

   bash
   ./teleport
   

编辑源代码

容器默认不含编辑器，可通过以下命令安装（以nano为例）：

bash
apt update && apt install nano  # 更新包索引并安装nano
nano teleport.cpp  # 编辑源代码

文件持久化与共享

为避免容器内文件丢失，可通过绑定挂载将主机目录映射到容器：

1. 在容器内创建共享目录并退出：

   bash
   mkdir /home/my_shared
   exit
   

2. 在主机创建对应目录：

   bash
   mkdir my_iqsdk_data
   

3. 启动容器时绑定目录：

   bash
   docker run --name myIQSDK -it -v ./my_iqsdk_data:/home/my_shared intellabs/intel_quantum_sdk /bin/bash
   

4. 复制SDK文档到共享目录（主机可访问）：

   bash
   cp ${IQSDK_ROOT}/*.pdf /home/my_shared/
   

计算生态系统要求

硬件内存需求

状态向量模拟的内存消耗随量子比特数量呈指数增长，计算公式为：
内存 (字节) = 16 * 1.5 * 2^num_qubits
（16字节为复数双精度值大小，1.5为额外开销系数，num_qubits为量子比特数）
注意：C++逻辑的数据结构需额外内存。

贡献与支持

代码贡献

• 前端编译器开发：https://github.com/intel/quantum-intrinsics
• 中间表示优化：https://github.com/intel/quantum-passes

技术支持与问题反馈

• Intel社区论坛：Intel® Quantum SDK板块
• 实时交流：[]

引用说明

若使用Intel® Quantum SDK的研究成果，建议引用：
Khalate, P., Wu, X.-C., Premaratne, S., Hogaboam, J., Holmes, A., Schmitz, A., Guerreschi, G. G., Zou, X. & Matsuura, A. Y., arXiv:2202.*** (2022).

许可证信息

• 镜像包含第三方组件，各组件遵循其开源许可协议，详情见组件附带的许可文档。
• Intel® Quantum SDK二进制软件受Intel® Quantum SDK BINARY SOFTWARE LICENSE AGREEMENT约束，仅供评估测试使用，禁止修改、分发或用于商业目的。
• 源代码组件（如intellabs/intel_quantum_sdk:v1.1-source标签）提供GPL/LGPL/MPL许可的源码。