aqora / New circuits and an open source decoder for the colorcode

Public

About dataset version

Chromobius Color-Code Circuits

Short Description

Stim circuits from “New circuits and an open source decoder for the color code” (Gidney & Jones, 2023), consolidated into a single Parquet artifact for Aqora.

Background

The paper introduces two stabilizer-measurement schedules for color-code quantum error correction:
  • Superdense circuits multiplex stabilizer measurements via Bell pairs.
  • Middle-out circuits fold stabilizers without ancillas, achieving the best logical-error performance reported to date.
Both constructions are benchmarked under circuit-level noise and outperform earlier color-code circuits. The authors also release Chromobius, an open-source Möbius decoder that operates at roughly 300k decoding events per second across diverse noise models and circuit families. This dataset contains every Stim circuit, detector-error model, and simulation configuration used to generate the paper’s figures.

Contents

  • Rows: 602 circuits (16 matchable minimum-weight cases + 586 unmatchable)
  • Families: surface/toric color codes, phenom, midout, superdense, transit, pyramid, repetition, and related variants
  • Metadata: parameters parsed from filenames (rounds r, distance d, noise model/probability, qubit count q, optional layout dimensions w/h)
  • Payload: full Stim source code for each circuit

Schema

ColumnTypeDescription
circuit_nameStringOriginal .stim filename encoding the configuration.
stimStringFull Stim program (UTF-8 text).
matchableBooleanTrue if the detector error model reduces to minimum-weight matching; False otherwise.
cStringCircuit family identifier (e.g., surface_code_X, midout_color_code_Z).
dIntegerCode distance.
rIntegerNumber of measurement rounds.
noiseStringNoise model label (uniform, bitflip, etc.).
pFloatPhysical error probability.
qIntegerNumber of data qubits.
gatesStringGate-set flag (all in this release).
wIntegerOptional layout width (nullable; toric families).
hIntegerOptional layout height (nullable; toric families).

Loading Examples

Polars

import polars as pl
from aqora_cli.pyarrow import dataset

df = pl.scan_pyarrow_dataset(
    dataset("aqora/new-circuits-and-an-open-source-decoder-for-the-colorcode", "v0.0.0")
).collect()
print(df.head())

Pandas

import pandas as pd

df = pd.read_parquet(
    "aqora://aqora/new-circuits-and-an-open-source-decoder-for-the-colorcode/v0.0.0"
)
print(df.head())

Stim Export

import pandas as pd

df = pd.read_parquet(
    "aqora://aqora/new-circuits-and-an-open-source-decoder-for-the-colorcode/v0.0.0"
)
row = df.loc[
    df["circuit_name"] == "r=44,d=11,p=0.001,noise=uniform,c=surface_code_X,q=241,gates=all.stim"
].iloc[0]

with open("surface_code_d11.stim", "w", encoding="utf-8") as f:
    f.write(row["stim"])

Pointers to Chromobius Paper

  • Paper: Gidney & Jones, “New circuits and an open source decoder for the color code” (2023)