你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。

使用 QDKPython 包运行量子模拟

Microsoft Quantum 开发工具包 (QDK) Python 包包括可用于测试和开发量子程序的本地量子模拟器。 本文介绍如何安装模拟器,并在 Python 或 Jupyter Notebook 中运行 Q#、OpenQASM、Qiskit 和 QIR 程序。

该 QDKPython 包包含四个主要模拟器:

  • 稀疏模拟器
  • 稳定器模拟器
  • GPU 模拟器
  • CPU 模拟器

有关 QDK量子模拟器的更多信息,请参阅QDK中的量子模拟器概述。

要直接在 Visual Studio Code (VS Code) 的 QDK 扩展中运行 Q# 或 OpenQASM 程序,请参阅在 Visual Studio Code 的 QDK 扩展中运行量子模拟。

先决条件

若要遵循本文中的Jupyter Notebook示例,请安装这些工具:

安装模拟器

要在 Python 和 Jupyter Notebook 中使用量子模拟器,请安装带有 jupyter 额外组件的最新版本 qdkPython 包:

pip install --upgrade "qdk[jupyter]"

模拟器不需要 jupyter 额外组件,但额外组件添加了 qdk.widgets 模块以在 Jupyter Notebook 中可视化模拟结果。

根据使用的量子编程框架和 Python API 选择模拟器。

调用稀疏模拟器

稀疏模拟器支持 Q#、OpenQASM 和 Qiskit 程序。 下表显示了如何在每个框架中使用 qdk 包运行 10 次。

编程框架 Python API(应用程序接口) 示例调用
Q# qsharp.run qsharp.run("MyQsharpProgram()", shots=10)
OpenQASM openqasm.run openqasm.run(my_qasm_program, shots=10)
Qiskit qiskit.QSharpBackend QSharpBackend().run(my_qiskit_program, shots=10)

注释

稀疏模拟器通过 noise 参数支持 Q# 和 OpenQASM 程序的噪音模型,但不支持 Qiskit 程序的噪音模型。

例如,按照以下步骤在 VS Code 中的 Jupyter 笔记本中运行 Bell 对 Q# 程序:

  1. 在 VS Code 中,选择 “查看>命令面板”。

  2. 输入 Create: New Jupyter Notebook。 将在新选项卡中打开一个空的笔记本文件。

  3. 在第一个单元中,从qdk包导入qsharp模块。

    from qdk import qsharp
    
  4. 在新单元格中,使用 %%qsharp magic 命令编写 Q# 代码。

    %%qsharp
    
    operation Main() : (Result, Result) {
        use (q1, q2) = (Qubit(), Qubit());
        PrepareBellPair(q1, q2);
        (MResetZ(q1), MResetZ(q2))
    }
    
    operation PrepareBellPair(q1 : Qubit, q2 : Qubit) : Unit {
        H(q1);
        CNOT(q1, q2);
    }
    
  5. 创建新单元格。 要在稀疏模拟器上运行 Q# 程序,请从 qsharp 模块调用 run 函数并指定镜头数。

    qsharp.run("Main()", shots=10)
    

调用稳定器模拟器

稳定器模拟器高效运行广泛的、Clifford 主导的电路。 稳定器分支还支持有限数量的非Clifford 操作,例如 $T$ 和 $T^\dagger$ 门和任意角度 Pauli 旋转。 由于分支数量随非Clifford 操作数呈指数级增长,因此对具有大量非Clifford 演变的线路使用全状态模拟器。

稳定器模拟器支持Q#、OpenQASM、Qiskit和QIR程序。 此表显示了如何在每个框架中运行 10 个镜头。

编程框架 Python API(应用程序接口) 示例调用
Q# qsharp.run qsharp.run("MyQsharpProgram()", type="stabilizer", shots=10)
OpenQASM openqasm.run openqasm.run(my_qasm_program, type="stabilizer", shots=10)
Qiskit qiskit.NeutralAtomBackend NeutralAtomBackend().run(my_qiskit_program, simulator_type="stabilizer", shots=10)
QIR simulation.NeutralAtomDevice simulation.NeutralAtomDevice().simulate(my_qir, type="stabilizer", shots=10)
QIR simulation.run_qir simulation.run_qir(my_qir, type="stabilizer", shots=10)

注释

还可以使用 simulation.run_qir 通过量子错误更正协议运行逻辑程序。 此工作流具有其他协议和解码器要求。 有关详细信息,请参阅 运行和解码逻辑程序。

NeutralAtomDevice和 NeutralAtomBackend API 专门用于在中性原子量子计算机上进行模拟。 有关详细信息,请参阅 中性原子设备模拟器概述。

例如,此 Python 代码在稳定器模拟器上运行带有非 Clifford $T$ 门的 OpenQASM 程序:

from qdk.openqasm import run

qasm_code = """
include "stdgates.inc";
qubit[1] q;
bit[1] result;

h q[0];
t q[0];
h q[0];
result = measure q;
"""

run(qasm_code, type="stabilizer", shots=1000)

注释

"stabilizer"和"clifford"都选择稳定器模拟器。 API 确定参数是否为 type 或 simulator_type。

$T$ 门创建稳定子分支。 最终测量对这些分支之间的干扰进行采样。

调用 GPU 和 CPU 模拟器

GPU 和 CPU 模拟器支持 Qiskit 和 QIR 程序。 此表显示了如何在每个框架中使用 qdk 包在 GPU 模拟器上运行 10 个镜头。 若要使用CPU模拟器,请在模拟器类型参数中将gpu替换为cpu。

编程框架 Python API(应用程序接口) 示例调用
Qiskit qiskit.NeutralAtomBackend NeutralAtomBackend().run(my_qiskit_program, simulator_type="gpu", shots=10)
QIR simulation.NeutralAtomDevice simulation.NeutralAtomDevice().simulate(my_qir, type="gpu", shots=10)
QIR simulation.run_qir simulation.run_qir(my_qir, type="gpu", shots=10)

例如,此Python代码将简单OpenQASM程序转换为QIR,并在GPU模拟器上运行QIR:

from qdk.openqasm import compile
from qdk.simulation import run_qir

qasm_code = """
    include "stdgates.inc";
    qubit[2] q;
    reset q;
    h q[0];
    cx q[0], q[1];
    bit c = measure q[1];
    """

qir = compile(qasm_code)
run_qir(qir, type="gpu", shots=10)