開始 QDK 錯誤更正

()包含Microsoft Quantum Development KitQDKPython開發與測試量子錯誤更正(QEC)協定的工具。 使用此 qdk.ec 模組分析錯誤更正碼、建構可執行協定、驗證協定宣告及研究電路故障。 用 qdk.simulation 來執行邏輯程式。

了解 QDK 錯誤更正工具

QDK錯誤更正工作流程使用以下套件與模組:

Component 用它來做
qodec 定義並儲存程式碼、指令集、裝置、層級及完整的 QEC 協定。
qdk.ec 分析程式碼與裝置、建立基準 Qodec、推導方程式,並審核協議聲明。
qdk.simulation 透過 (qodec) 程式執行Quantum Intermediate RepresentationQIR並套用解碼器。
qdk.simulation.decoders 選擇內建的症候群解碼器、追蹤框架,或連接選配 deq 解碼器。
qdk.qre 估算 QEC 模型用於容錯資源估計的空間、時間與錯誤成本。

A qodec 是可執行的 QEC 協定的正式描述。 它透過一層或多層將邏輯指令連接到物理電路。 該 qodec 套件定義了這個資料模型及其 YAML 表示方式。 該 qdk.ec 模組從模型中推導事實,並檢查其宣告是否與電路相符。

欲了解更多資訊,請參閱概述。qodec

這個 qdk.qre 模組有不同的用途。 它模擬錯誤更正方案的資源成本。 它不會定義、審核或運行 qodec 裝置。 欲了解更多關於量子資源估計QDK的資訊,請參閱「什麼是 Microsoft 量子資源估計器?」

了解協議的組成部分qodec

以下元件定義協定 qodec 並支援其執行。

Component Description
Code 一組靜態的穩定子與邏輯運算子,定義一個碼空間。
指令集 層所支援的邏輯或物理操作 qodec 。
Gadget 一個透過下一層操作實作指令的電路。
階層 從一個指令集映射到較低階的指令集。
編碼 邏輯區塊與電路量子位元在裝置邊界的連接。
檢查 一個當宣告關係成立時必須等於零的宇稱方程。
讀數 一個將電路結果與框架符號映射到邏輯結果或標誌的方程式。
Flag 一個命名的讀數,報告指令是否符合其接受條件。
譯碼器 一個利用症候群證據來推斷修正與邏輯結果的元件。

A qodec 可以包含多層。 頂層可以定義對編碼區塊的邏輯操作。 頂層的裝置可以呼叫下一層的指令。 底層包含模擬器執行的物理操作。

協定工作流程範例

典型的工作流程包含六個步驟。 以下步驟會使用模組中的 qdk.ec 函式與類別。

  1. 定義一條代碼。 建立 qodec.Code 一個包含穩定器和邏輯 Pauli 運算子的 。
  2. 分析程式碼。 使用這個 CodeProfile 類別來檢查邏輯運算子、計算症候群並計算程式碼距離。
  3. 建造或載入一個 qodec. 使用該build_qodec函式建立基線協定,或從 載入現有qodec協定。YAML
  4. 完成並驗證該協議。 使用該 filled 函數推導支持的檢查與讀出方程式。 使用這個 audit 函式來尋找不一致或不完整的宣告。
  5. 分析電路故障。 利用這 GadgetProfile 堂課來檢查邏輯動作、錯誤效應和裝置距離。
  6. 執行邏輯程式。 編譯 Q# 或 OpenQASM 編碼成 QIR。 將 和 傳遞QIRqodec到 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 策略創造了一個沒有旗標量子位元的簡單基線協定。 它能幫助你檢查工作流程,但不保證裝置具備容錯能力。 在選擇協定實作前,請先使用裝置距離分析。

協定驗證與故障分析分開

方案審核與遠距分析評估 QEC 方案的不同面向。

  • 協定稽核會在未發生故障時檢查宣告協定是否與其電路和方程式相符。
  • 距離分析決定允許的最小錯誤數或電路故障,這些錯誤可能導致未被偵測到的邏輯故障。

用這個 audit 函式來檢查無噪音的一致性。 稽核會檢查程式碼代數、指令宣告、裝置動作、檢查、讀出、旗標、框架關係,以及物件間 qodec 的參考。

沒有問題的稽核並不保證容錯。 電路可以在沒有故障的情況下執行正確的邏輯動作,但一次物理故障後仍會失效。 用該 CodeProfile.distance 方法分析程式碼,使用 GadgetProfile.distance 分析每個電路實作的方法。

在使用有噪音模擬的協定前,先進行協定審核並分析程式碼與裝置的距離。

選擇一種建造策略

該 build_qodec 函數支援兩種基線 CSS 建構策略。

Strategy Description
flagged-css/v1 使用標記的 CSS 構造,並從代碼距離中選擇旗幟計數。 這種策略是預設的。
bare-css/v1 不使用旗標量子位元,且跳過選擇旗標計數的距離計算。 用它來檢查和早期開發。

這兩種策略都試圖建立以下邏輯指令:

  • prepare_z_all
  • prepare_x_all
  • syndrome
  • measure_z_all
  • measure_x_all
  • h_all
  • cx_all

並非所有代碼都支持所有候選人。 預設設定 strict=True下, build_qodec 當無法建置並驗證指令時,會產生錯誤。 其中 strict=Falsebuild_qodec 保留支援的指令,並將跳過的指令記錄在qodec元資料中。

選擇你的下一個任務

若想取得完整遵循完整工作流程的筆記本,請參閱「在倉庫中開發並測試 QEC 協定QDK」。