De QEC Evaluation Suite is een instrumentarium voor de digitale evaluatie en telemetrie van finite-size circuit-level en holografische quantum error correction (QEC). De suite is gestructureerd in verschillende lagen:
- Laag A: Bevat implementaties voor Surface codes (Stim rotated surface) en Floquet codes.
- Laag B: Richt zich op educatieve graaf-invarianten binnen geometrie.
- Laag C: Maakt gebruik van een tensor-netwerkmodel voor bulk-boundary codering (HaPPY), inclusief greedy recovery en GF(2) GE ablation.
Uit de resultaten blijkt dat GE in specifieke scenario's geen recovery-superset is van greedy, waarbij het verschil groter wordt bij diepte-2. Daarnaast bevat de suite een BP micro-lab voor Hamming [7,4] codes, waarin diverse metrieken (zoals OSD en uniciteit) worden gebruikt om herstelprestaties te analyseren. De volledige tooling is beschikbaar via GitHub, waarbij reproduceerbaarheid wordt gewaarborgd door bevroren JSON-datasets.
QEC Evaluation Suite
Dit instrument is uitsluitend bedoeld voor digitale evaluatie en telemetrie. Het betreft geen hardware, geen productie-decoder en geen wetenschappelijk artikel over asymptotische drempelwaarden.
Kadering van Laag C: Een tensor-netwerkmodel van bulk-boundary codering met greedy recovery (HaPPY); optionele matched-sample GF(2) GE ablation.
Voor details over claims zie QEC_CLAIMS.md. Indien er discrepanties zijn met deze README, heeft de JSON-data onder public/data/ prioriteit.
Lagen
| Laag | Beschrijving | Primaire artefacten |
| A Surface | Stim rotated surface; grafiekachtige DEM; MWPM smoke | public/data/layerasurface_smoke.json |
| A Floquet | Period-3 honeycomb; schedule-valid; geen grafiekachtige MWPM-peer van surface | public/data/layerafloquet_smoke.json |
| B Geometry | Educatieve graaf-invarianten — geen circuit-level QEC | public/data/geometrylabmetrics.json |
| C HaPPY | Diepte-1 (n=10, k=6) & beperkte diepte-2 (n=20, k=16); greedy + matched GE | public/data/happy_*.json |
Belangrijkste resultaten (reproduceerbare JSON)
Matched greedy vs GE (dezelfde erasure masks)
| Diepte | p_erase | Greedy central | GE central |
| 1 | 0.3 | 0.664 | 0.304 |
| 2 | 0.3 | 0.59 | 0.0575 |
Non-dominantie: In deze instantie is GE geen recovery-superset van greedy. Het gat wordt groter bij diepte-2 onder het lineaire face-parameter model. Bronnen: happygeablationmetrics.json, happygeablationmetrics_depth2.json (seed=42).
Pattern stress × GE (diepte-1, k-matched)
| Mode | k | Greedy central | GE central |
| uniform | 4 | ~0.27 | ~0.02 |
| clustered | 4 | 1.0 | 0.0 |
Voor greedy blijft k=4 speciaal (clustered houdt stand, uniform daalt). Onder GE zitten beide modi nabij de vloer. Dit is een resultaat van decoder × patroon, geen universele geometrische claim. Bron: happygepattern_stress.json (400 trials/cel, seed=42).
Snelstart
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_rollup
Bij het vergelijken van claims verdient het de voorkeur om gebruik te maken van de bevroren JSON-bestanden onder public/data/ in plaats van het opnieuw uitvoeren van zware sweeps. Voor volledige transparantie en non-claims zie QEC_CLAIMS.md.
BP micro-lab (Fase E0/E1) — Betekenis van metrieken
Dit betreft een klassiek Hamming [7,4] min-sum BP micro-lab (public/data/bpmicrometrics.json) en is niet gerelateerd aan HaPPY.
| Veld | Betekenis |
geuniquerecoverability | Uniek uitwisingsherstel: rank(H_E) = \ | E\ | over GF(2) |
bpcodewordmatch | BP hard decision komt overeen met het werkelijke alle-nul codeword (en syndroom nul) |
bposd0syndrome_valid | OSD-0 vond een syndroom-geldige aanvulling |
bposd1syndrome_valid | OSD-1 (order-1 free-bit search) vond een syndroom-geldige aanvulling |
bposd1codeword_match | De beste kandidaat van OSD-1 komt overeen met het werkelijke alle-nul woord |
Deze metrieken zijn niet uitwisselbaar. GE staat voor uniciteit; BP voor channel codeword match; OSD voor lijstaanvulling (geen ML, geen drempelwaarde-decoder).
QEC Evaluation Suite
Dit instrument is uitsluitend bedoeld voor digitale evaluatie en telemetrie. Het betreft geen hardware, geen productie-decoder en geen wetenschappelijk artikel over asymptotische drempelwaarden.
Kadering van Laag C: Een tensor-netwerkmodel van bulk-boundary codering met greedy recovery (HaPPY); optionele matched-sample GF(2) GE ablation.
Voor details over claims zie QEC_CLAIMS.md. Indien er discrepanties zijn met deze README, heeft de JSON-data onder public/data/ prioriteit.
Lagen
| Laag | Beschrijving | Primaire artefacten |
| A Surface | Stim rotated surface; grafiekachtige DEM; MWPM smoke | public/data/layerasurface_smoke.json |
| A Floquet | Period-3 honeycomb; schedule-valid; geen grafiekachtige MWPM-peer van surface | public/data/layerafloquet_smoke.json |
| B Geometry | Educatieve graaf-invarianten — geen circuit-level QEC | public/data/geometrylabmetrics.json |
| C HaPPY | Diepte-1 (n=10, k=6) & beperkte diepte-2 (n=20, k=16); greedy + matched GE | public/data/happy_*.json |
Belangrijkste resultaten (reproduceerbare JSON)
Matched greedy vs GE (dezelfde erasure masks)
| Diepte | p_erase | Greedy central | GE central |
| 1 | 0.3 | 0.664 | 0.304 |
| 2 | 0.3 | 0.59 | 0.0575 |
Non-dominantie: In deze instantie is GE geen recovery-superset van greedy. Het gat wordt groter bij diepte-2 onder het lineaire face-parameter model. Bronnen: happygeablationmetrics.json, happygeablationmetrics_depth2.json (seed=42).
Pattern stress × GE (diepte-1, k-matched)
| Mode | k | Greedy central | GE central |
| uniform | 4 | ~0.27 | ~0.02 |
| clustered | 4 | 1.0 | 0.0 |
Voor greedy blijft k=4 speciaal (clustered houdt stand, uniform daalt). Onder GE zitten beide modi nabij de vloer. Dit is een resultaat van decoder × patroon, geen universele geometrische claim. Bron: happygepattern_stress.json (400 trials/cel, seed=42).
Snelstart
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_rollup
Bij het vergelijken van claims verdient het de voorkeur om gebruik te maken van de bevroren JSON-bestanden onder public/data/ in plaats van het opnieuw uitvoeren van zware sweeps. Voor volledige transparantie en non-claims zie QEC_CLAIMS.md.
BP micro-lab (Fase E0/E1) — Betekenis van metrieken
Dit betreft een klassiek Hamming [7,4] min-sum BP micro-lab (public/data/bpmicrometrics.json) en is niet gerelateerd aan HaPPY.
| Veld | Betekenis |
geuniquerecoverability | Uniek uitwisingsherstel: rank(H_E) = \ | E\ | over GF(2) |
bpcodewordmatch | BP hard decision komt overeen met het werkelijke alle-nul codeword (en syndroom nul) |
bposd0syndrome_valid | OSD-0 vond een syndroom-geldige aanvulling |
bposd1syndrome_valid | OSD-1 (order-1 free-bit search) vond een syndroom-geldige aanvulling |
bposd1codeword_match | De beste kandidaat van OSD-1 komt overeen met het werkelijke alle-nul woord |
Deze metrieken zijn niet uitwisselbaar. GE staat voor uniciteit; BP voor channel codeword match; OSD voor lijstaanvulling (geen ML, geen drempelwaarde-decoder).