Magic State Factory Catalog

[\![20,\,3,\,2]\!] factory

\mathrm{T}_{0}\cdot \mathrm{CS}_{12}

distance, proved here
d=2
error coefficient
A_{2}=22
\gamma_\rho
3.3219
V_{\mathrm{ex}}
2
wires
N=6
Clifford correction
none with T powers
found by
pre-existing

The circuit

The 6\times20 matrix. Rows are wires and columns are rotations. A 1 means the wire takes part in the rotation, and the number beside each wire is its row weight.

  • output wires
  • check wires, measured and postselected
wire
0 10
out 0 (11)···1··11·11·111·11·1
out 1 (6)······111·······111·
out 2 (6)·········111····111·
check 3 (12)1···1·1·11·111·11·11
check 4 (12)·1···1·11·111·11·111
check 5 (8)··1111·······111···1

The gate is read off the output rows. An output row of odd weight gives a T, a pair of output rows with odd overlap gives a CS, and an odd triple overlap gives a CCZ. The circuit is a valid factory because every such parity that touches a check row is even.

Figures of merit

inputs n20Noisy T states per run.
outputs k3
distance d2Exact, proved and witnessed here.
error coefficient A_{2}22Faults of weight 2 in the circuit shown that pass every check and damage the output. The output error is A_{2}\,p^{2} to leading order.
wires N6
checks r3
V_{\mathrm{ex}}2T states per run. CCZ counts as two.
\gamma_\rho = \log(n/V_{\mathrm{ex}})/\log d3.3219Overhead per extractable T state. Lower is better.
\gamma = \log(n/k)/\log d2.7370Overhead per output qubit.
\gamma_T = \log(n/T)/\log d2.3219Overhead per unit of T-count.
T-count4Minimal T-count of the output gate.
phase-polynomial degree2Minimised over changes of output basis.
effective width3Rank of the output rows modulo the check rows.

Output gate

1 T1 CS0 CCZon 3 output wires

As gates: \mathrm{T}_{0}\cdot \mathrm{CS}_{12}

As monomials: 0+12 (output wires per term, separated by +)

This row stands for every gate that a CNOT circuit and S, Z and CZ gates on the outputs can reach from this one. They all prepare the same magic state. The wires are shown in the S_k-canonical frame.

Clifford correction

With every rotation a \mathrm{T}=\mathrm{diag}(1,e^{i\pi/4}), the rotations deposit the gate above times a diagonal Clifford. Undo it after the rotations and before the checks are measured, with 5 single-wire gates and 3 \mathrm{CZ} gates: \mathrm{S}^\dagger on output 0, \mathrm{S} on output 1, \mathrm{S} on output 2, \mathrm{Z} on check 3, \mathrm{Z} on check 4, \mathrm{CZ} on output 0, check 3, \mathrm{CZ} on output 0, check 4, \mathrm{CZ} on check 3, check 4. The circuit's action is then exactly the gate above, and an error-free run passes every check with certainty.

Or no Clifford gate at all: run \mathrm{T}^3 on rotations 8, 11, 12, 15, 16, 17, 19; \mathrm{T}^5 on rotations 6, 9; \mathrm{T}^\dagger on rotations 2, 3, and \mathrm{T} on the rest. A power of \mathrm{T} costs one magic state, like \mathrm{T} itself. For a code this is a transversal \mathrm{T} gate, \mathrm{T}^j on each qubit.

Rotations are numbered by matrix column, from 0. The correction comes from the columns by the weight expansion of Bravyi and Haah (2012). verify_catalog.py re-derives it, checks the corrected circuit's phase input by input against the gate, and on small circuits simulates it gate by gate.

Convert the output with CNOT and S

A CNOT circuit on the outputs, followed by S, Z and CZ gates, turns this factory's gate into other gates that prepare the same magic state. Type a target gate to check whether it is reachable. If it is, you get the circuit, checked on every basis state.

Or list every gate it reaches. The list is built in your browser and saved as a text file, one gate per line.

Python code that writes the same list
import json, urllib.request

NAMES = {1: "T", 2: "CS", 3: "CCZ"}


def equivalent_gates(k, terms, limit=1_000_000):
    """Every gate a CNOT circuit and S, Z, CZ gates reach from this one.

    A gate is its set of terms mod Clifford: {a} is T, {a,b} is CS and
    {a,b,c} is CCZ on those outputs. CNOT c->t sends x_t to
    x_c + x_t - 2 x_c x_t, so a term on t but not c adds the term with t
    replaced by c, and, below CCZ, the term with c added.
    """
    start = frozenset(frozenset(m) for m in terms)
    seen, queue = {start}, [start]
    for gate in queue:
        for c in range(k):
            for t in range(k):
                if c == t:
                    continue
                new = set(gate)
                for m in gate:
                    if t in m and c not in m:
                        new ^= {(m - {t}) | {c}}
                        if len(m) < 3:
                            new ^= {m | {c}}
                new = frozenset(new)
                if new not in seen:
                    seen.add(new)
                    queue.append(new)
                    if len(seen) > limit:
                        raise RuntimeError(f"more than {limit} equivalent gates")
    return seen


def name(gate, k):
    sep = "," if k > 10 else ""
    terms = sorted((sorted(m) for m in gate), key=lambda m: (len(m), m))
    return "·".join(NAMES[len(m)] + sep.join(map(str, m)) for m in terms) or "I"


url = "https://shubhamj810.github.io/magic-state-factory-repo/data/factories/20.3.2.a.json"
record = json.load(urllib.request.urlopen(url))
k = record["parameters"]["k"]
gates = equivalent_gates(k, record["gate"]["monomials"])
lines = sorted(name(g, k) for g in gates)
print(len(lines), "equivalent gates")
with open("equivalent-gates-20.3.2.a.txt", "w") as out:
    out.write("\n".join(lines) + "\n")

Distance

d=2, exact. No fault of weight below 2 is both undetectable and damaging. One of weight 2 is.

Exactly 22 faults of weight 2 are undetectable and damaging, so A_{2}=22. If each rotation fails independently with probability p, an accepted run has a damaged output with probability A_{2}\,p^{2}+O(p^{3}).

A damaging fault of weight 2 sits on columns [0,6].

A fault is a set of faulty columns. It is undetectable when their check parts cancel, and damaging when their output parts do not.

Original source

S. Nezami and J. Haah, "Classification of small triorthogonal codes," Phys. Rev. A 106, 012437 (2022). doi.org/10.1103/PhysRevA.106.012437

Provenance

found by the symmetry-free, targeted-output borrowed-identity search of Singh, Gidney and Jones (arXiv:2606.28518; borrowed_identities/), which solves for the check couplings of a chosen output; a verified witness, not a maximum

Found by: borrowed-identity search: symmetry-free

Discovery: pre-existing

1 recorded source
[
 {
  "regime": "borrowed-identity search: symmetry-free",
  "file": "borrowed_identities/circuits/circuits_l3.json",
  "label": "l3-row051-symmetry-free",
  "N": 6,
  "d": 2,
  "d_is_exact": true,
  "origin": "https://github.com/shraggy/Magic_state_factory_search at cae4982, outputs/factory_catalogue_l3.csv row 51",
  "provenance": "symmetry-free l=3 parts=2+1 checks=3"
 }
]

Use it in code

Load this factory and re-derive every number from its circuit with the catalogue's own verifier.

# git clone https://github.com/shubhamj810/magic-state-factory-repo
# cd magic-state-factory-repo/master_catalog
import json, urllib.request
import verify_catalog as VC

url = "https://shubhamj810.github.io/magic-state-factory-repo/data/factories/20.3.2.a.json"
record = json.load(urllib.request.urlopen(url))
columns = record["circuit"]["columns"]
k, N = record["parameters"]["k"], record["parameters"]["N"]

facts, problems = VC.derive(columns, k, N)    # gate, T-count, degree, ...
distance = VC.measure_distance(columns, k, N)  # exhaustive fault search
print(facts["gate_human"], distance["d_exact"] or distance["d_at_least"],
      problems or "verified")

Raw record

Show the JSON this page is built from

Source: master_catalog.json, factories[17].