你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Microsoft Quantum 开发工具包(QDK)包括用于开发和测试量子误差更正(QEC)协议的Python工具。 使用 qdk.ec 模块分析错误更正代码、构建可执行协议、验证协议声明并研究线路故障。 使用 qdk.simulation 通过这些协议运行逻辑程序。
了解 QDK 错误更正工具
QDK错误更正工作流使用这些包和模块:
| 组分 | 使用它来 |
|---|---|
qodec |
定义并保存代码、指令集、小工具、层和完整的 QEC 协议。 |
qdk.ec |
分析代码和小工具,构建基线 qodec,推导方程并审核协议声明。 |
qdk.simulation |
通过QIR运行qodec(Quantum Intermediate Representation)程序并应用解码器。 |
qdk.simulation.decoders |
选择内置综合征解码器、跟踪帧,或连接到可选的 deq 解码器。 |
qdk.qre |
估算用于容错资源估算的 QEC 模型的空间、时间和错误成本。 |
一个 qodec 是对可执行 QEC 协议的正式说明。 它通过一个或多个层将逻辑指令连接到物理电路。 包 qodec 定义此数据模型及其 YAML 表示形式。
qdk.ec 模块从模型推导事实,并检查其声明是否与线路匹配。
有关详细信息,请参阅 qodec 概述。
该 qdk.qre 模块具有不同的用途。 它为错误更正方案的资源成本建模。 它不定义、审核或运行 qodec 小工具。 有关 QDK 中量子资源估算的详细信息,请参阅什么是 Microsoft Quantum 资源估算器?
qodec了解协议组件
以下组件定义 qodec 协议并支持其执行。
| 组分 | Description |
|---|---|
| Code | 一组静态稳定器和逻辑运算符,用于定义代码空间。 |
| 指令集 | 层支持的逻辑或物理操作 qodec 。 |
| 小工具 | 通过下一层中的操作实现指令的电路。 |
| 层 | 从一个指令集到较低级别的指令集的映射。 |
| 编码 | 逻辑块与 gadget 边界上的电路量子比特之间的连接。 |
| 检查 | 声明的关系成立时必须等于零的奇偶校验公式。 |
| 读出 | 将线路结果和帧符号映射到逻辑结果或标志的方程。 |
| Flag | 报告指令是否满足其接受条件的命名读出。 |
| 解码器 | 使用 syndrome 证据推断更正和逻辑结果的组件。 |
qodec 可以包含多个层。 顶层可以定义对编码块的逻辑操作。 顶层中的小工具可以调用下一层中的指令。 底层包含模拟器运行的物理操作。
协议工作流示例
典型的工作流有六个步骤。 以下步骤使用 qdk.ec 模块中的函数和类。
- 定义代码。 使用稳定子和逻辑 Pauli 运算符创建
qodec.Code。 - 分析代码。 使用
CodeProfile类检查逻辑运算符、计算综合征并计算代码距离。 - 构建或加载qodec。 使用
build_qodec函数创建基线协议,或从qodec加载现有YAML。 - 完成并验证协议。 使用
filled函数推导支持的校验和读出方程。 使用audit函数查找不一致或不完整的声明。 - 分析线路故障。 使用
GadgetProfile类检查逻辑操作、故障影响和小工具距离。 - 运行逻辑程序。 将 OpenQASM 或 Q# 代码编译为 QIR。 将QIR和qodec传递给
qdk.simulation.run_qir,然后选择解码器和噪声模型。
以下代码显示此工作流中的主对象:
import qodec
from qdk import ec
from qdk.simulation import run_qir
code = qodec.Code(
"C4",
stabilizers=["X_0 X_1 X_2 X_3", "Z_0 Z_1 Z_2 Z_3"],
x=["X_0 X_1", "X_0 X_2"],
z=["Z_0 Z_2", "Z_0 Z_1"],
)
code_profile = ec.CodeProfile(code)
print("Code distance:", code_profile.distance())
protocol = ec.build_qodec(code, strategy="bare-css/v1", strict=False)
print(ec.audit(protocol))
# Compile a logical program to QIR before you call run_qir.
# results = run_qir(qir, qodec=protocol, shots=100)
bare-css/v1此示例中的策略创建一个简单的基线协议,而无需标记量子比特。 它有助于检查工作流,但不保证容错小工具。 选择协议实现之前,请使用 gadget 距离分析。
将协议验证与故障分析分开
协议审核和距离分析评估 QEC 协议的不同方面。
- 协议审核检查所声明的协议是否在未发生故障时与其电路和公式相匹配。
- 距离分析确定可能导致未检测到的逻辑故障的允许错误或线路故障的最小数量。
使用该 audit 函数检查无噪声一致性。 审核检查代码代数、指令声明、小工具操作、校验、读出、标志、帧关系以及 qodec 对象之间的引用。
报告无问题的审核不能保证容错。 线路可以实现正确的逻辑操作,而不会出错,但在发生一次物理故障后仍可能失效。 使用CodeProfile.distance方法分析代码,使用GadgetProfile.distance方法分析每个电路实现。
在使用协议进行噪声模拟之前,请运行协议审计并分析代码和 gadget 距离。
选择施工策略
该 build_qodec 函数支持两个基线 CSS 构造策略。
| Strategy | Description |
|---|---|
flagged-css/v1 |
使用标记的 CSS 构造,并从代码距离中选择标志计数。 此策略是默认值。 |
bare-css/v1 |
不使用标志量子比特,并跳过用于选择标志计数的距离计算。 使用它进行检查和早期开发。 |
这两种策略都尝试创建以下逻辑指令:
prepare_z_allprepare_x_allsyndromemeasure_z_allmeasure_x_allh_allcx_all
并非每个代码都支持每个候选。 使用默认设置 strict=True时, build_qodec 在无法生成并验证指令时引发错误。 使用 strict=False 时,build_qodec 保留支持的指令,并在 qodec 元数据中记录每个跳过的指令。
选择下一个任务
- 要准备 Python 环境,请参阅如何安装 QDK 以进行错误更正。
- 若要定义代码并创建协议,请参阅 开发和验证 QEC 协议。
- 若要编译、模拟和解码逻辑程序,请参阅 运行和解码逻辑程序。
有关遵循完整工作流的完整笔记本,请参阅QDK 存储库中的开发和测试 QEC 协议。