你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
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 3.10 或更高版本及 pip 的 Python 环境
- 最新版本的 Visual Studio Code (VS Code)
- VS Code 中Python扩展和Jupyter 扩展的最新版本
安装模拟器
要在 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# 程序:
在 VS Code 中,选择 “查看>命令面板”。
输入 Create: New Jupyter Notebook。 将在新选项卡中打开一个空的笔记本文件。
在第一个单元中,从
qdk包导入qsharp模块。from qdk import qsharp在新单元格中,使用
%%qsharpmagic 命令编写 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); }创建新单元格。 要在稀疏模拟器上运行 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)