Logical gates on Floquet codes via folds and twists

aqora / Logical gates on Floquet codes via folds and twists

Public

About dataset version

This dataset packages the logical quantum circuits released alongside the paper
Alexandra E. Moylett and Bhargavi Jonnadula, “Logical gates on Floquet codes via folds and twists,” arXiv:2512.17999 (2025).

Each circuit is stored in a single Parquet file, enabling large-scale analytics, benchmarking, and machine-learning workflows on logical quantum circuits and fault-tolerant architectures.

The dataset is intended for researchers working on quantum error correction, Floquet codes, logical gate constructions, and Stim-based circuit analysis.

Dataset Contents

Rows: 256
One row per circuit: each row contains a single Stim program and extracted metadata
Source: logical circuits originally distributed as .stim files
Transformations: none — circuits are unchanged; only serialized to Parquet

Parquet Schema

The table below describes the schema of the Parquet file. Each row corresponds to one logical circuit.

Column	Type	Description
`filename`	String	Original Stim filename
`family`	String	Circuit family identifier parsed from filename
`distance`	Int32	Code distance when present
`p`	Float64	Physical error rate when present
`basis`	String	Measurement basis label
`num_qubits`	Int32	Number of qubits inferred from the circuit
`gate_types`	List[String]	Unique Stim gate mnemonics used
`stim`	String	Full Stim circuit text

Loading Examples

Polars

import polars as pl
from aqora_cli.pyarrow import dataset

df = pl.scan_pyarrow_dataset(
    dataset(
        "aqora/logical-gates-on-floquet-codes-via-folds-and-twists",
        "v0.0.0"
    )
).collect()

print(df.head())

Pandas


df = pd.read_parquet(
    "aqora://aqora/logical-gates-on-floquet-codes-via-folds-and-twists/v0.0.0"
)

print(df.head())

Scientific Description

Logical circuits describe encoded quantum operations that act on logical qubits while preserving fault tolerance. In this dataset, each Stim file specifies the gate-level schedule implementing a logical operation on a Floquet code.

Floquet codes are periodically driven, measurement-based quantum error-correcting codes. Folds and twists introduce topological defects that enable the realization of logical gates such as Hadamard, phase, and memory operations within a planar layout.

Stim is used as the circuit representation due to its concise syntax and suitability for detector-based error modeling and large-scale simulation.

Citation

If you use this dataset, please cite the original work:

Alexandra E. Moylett and Bhargavi Jonnadula,
“Logical gates on Floquet codes via folds and twists,”
arXiv:2512.17999 (2025).
https://arxiv.org/abs/2512.17999