Skip to content

Add color-code pre-decoder support#89

Merged
ivanbasov merged 1 commit into
mainfrom
color-code-support
Jul 13, 2026
Merged

Add color-code pre-decoder support#89
ivanbasov merged 1 commit into
mainfrom
color-code-support

Conversation

@ivanbasov

@ivanbasov ivanbasov commented Jul 13, 2026

Copy link
Copy Markdown
Member

This release adds color-code support to the AI pre-decoder stack:

  • Color-code module (code/qec/color_code/): triangular color-code memory
    circuits (superdense, nearest-neighbor schedule), augmented-DEM precompute
    (code/qec/precompute_dem.py --code color), homological-equivalence
    canonicalization, and Chromobius as the global decoder on a Torch +
    cuStabilizer runtime.
  • Unified runner: code: surface | color in conf/config_public.yaml,
    same local_run.sh / workflows/run.py entry points; color dispatches to
    the same inference / threshold / sdr / chromobius_timing tasks.
  • Color configs: conf/config_color_model_1_s_LR3e-4.yaml (training),
    conf/config_color_threshold_model_1_d13.yaml (threshold sweep),
    conf/config_inference_color_model_5.yaml (standalone inference; set
    model_checkpoint_file to your trained checkpoint).
  • Docs: README "Color code support", TRAINING.md updates,
    cookbook/color_code.ipynb tutorial, results and latency figures.
  • Tests: color-code unit tests under code/tests/, public inference test
    test_inference_public_color_model.py, test-tier script updates. The
    weight-6 homological-equivalence tests assert the canonical orientation
    actually implemented by WEIGHT6_WEIGHT3_RULES, which is frozen for
    compatibility with trained checkpoints and published results. Tests that
    compare against the legacy reference circuit generator skip when that
    reference is not available.

No pre-trained color-code checkpoint is included in this release; inference
and threshold sweeps run on user-trained Model-5-shaped checkpoints (see
README → Color code support).

@ivanbasov ivanbasov force-pushed the color-code-support branch 4 times, most recently from 8180190 to c730455 Compare July 13, 2026 16:47
@ivanbasov ivanbasov requested a review from bmhowe23 July 13, 2026 17:07
Add color-code support to the AI pre-decoder stack: triangular
color-code memory circuits with augmented-DEM precompute and
homological-equivalence canonicalization, Chromobius as the global
decoder, a unified surface/color runner, training and threshold
configs, docs and cookbook tutorial, and color-code unit tests.

The weight-6 homological-equivalence tests are aligned with the
canonical orientation actually implemented by WEIGHT6_WEIGHT3_RULES,
which is frozen for compatibility with trained checkpoints and
published results. Tests that compare against the legacy reference
circuit generator skip when that reference is not available.

No pre-trained color-code checkpoint is included in this release;
inference and threshold sweeps run on user-trained Model-5-shaped
checkpoints.

Co-authored-by: Jan Olle <jolleaguiler@nvidia.com>
Co-authored-by: Kevin Mato <kmato@nvidia.com>
Co-authored-by: Chris Chamberland <cchamberland@nvidia.com>
Co-authored-by: Muyuan Li <muyuanl@nvidia.com>
Co-authored-by: Igor Baratta <ialmeidabara@nvidia.com>
@ivanbasov ivanbasov force-pushed the color-code-support branch from c730455 to 0201164 Compare July 13, 2026 17:21

@bmhowe23 bmhowe23 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎉

@ivanbasov ivanbasov merged commit 069353f into main Jul 13, 2026
17 checks passed
@ivanbasov ivanbasov deleted the color-code-support branch July 13, 2026 17:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants