Finite-size diagnostic tooling for circuit-level and holographic-style quantum error correction.
Digital evaluation / telemetry only — not hardware, not a production decoder, not an asymptotic threshold paper.
Layer C framing: tensor-network model of bulk-boundary encoding with greedy recovery (HaPPY); optional matched-sample GF(2) GE ablation.
Claims detail: QEC_CLAIMS.md · Prefer JSON under public/data/ if anything disagrees with this README.
| Layer | What it is | Primary artifacts |
|---|---|---|
| A Surface | Stim rotated surface; graphlike DEM; MWPM smoke | public/data/layer_a_surface_smoke.json |
| A Floquet | Period-3 honeycomb; schedule-valid; not graphlike MWPM peer of surface | public/data/layer_a_floquet_smoke.json |
| B Geometry | Educational graph invariants — not circuit-level QEC | public/data/geometry_lab_metrics.json |
| C HaPPY | Depth-1 (n=10, k=6) & capped depth-2 (n=20, k=16); greedy + matched GE | public/data/happy_*.json |
| Depth | p_erase | Greedy central | GE central |
|---|---|---|---|
| 1 | 0.3 | 0.664 | 0.304 |
| 2 | 0.3 | 0.59 | 0.0575 |
Non-dominance: GE is not a recovery superset of greedy on this instance. Gap widens at depth-2 under the linear face-parameter model.
Sources: happy_ge_ablation_metrics.json, happy_ge_ablation_metrics_depth2.json (seed=42).
| mode | k | Greedy central | GE central |
|---|---|---|---|
| uniform | 4 | ~0.27 | ~0.02 |
| clustered | 4 | 1.0 | 0.0 |
k=4 stays special for greedy (clustered holds, uniform drops). Under GE both modes sit near the floor. Decoder × pattern, not a universal geometry claim.
Source: happy_ge_pattern_stress.json (400 trials/cell, seed=42).
git clone https://github.com/mrblakessinger-rgb/qec-evaluation-suite.git
cd qec-evaluation-suite
python -m qec_engine.layer_a_smoke
python -m qec_engine.repo_rollupPrefer frozen JSON under public/data/ over re-running heavy sweeps when comparing claims. Full honesty language and non-claims: QEC_CLAIMS.md.
Classical Hamming [7,4] min-sum BP micro-lab (public/data/bp_micro_metrics.json). Not HaPPY.
| Field | Meaning |
|---|---|
ge_unique_recoverability |
Unique erasure recovery: rank(H_E) = |E| over GF(2) |
bp_codeword_match |
BP hard decision equals the true all-zero codeword (and syndrome zero) |
bp_osd0_syndrome_valid |
OSD-0 found a syndrome-valid completion |
bp_osd1_syndrome_valid |
OSD-1 (order-1 free-bit search) found a syndrome-valid completion |
bp_osd1_codeword_match |
OSD-1 best candidate equals the all-zero true word |
These metrics are not interchangeable. GE is uniqueness; BP is channel codeword match; OSD is list completion (not ML, not a threshold decoder).