Skip to main content

AutDEC: Quantum Automorphism Ensemble Decoder

Python package for implementation of the Quantum Automorphism Ensemble Decoder [1], "AutDEC":

AutDEC is designed for parallel ensemble decoding of quantum error-correcting codes with large automorphism groups. It works by creating an ensemble of automorphism guided BP, BP+OSD or BP+LSD decoders. For Bivariate Bicycle Codes under circuit-level noise, using only a BP-based ensemble, we approach and match BP+OSD0 performance without postprocessing. On the other hand, using a BP+OSD0-based ensemble, we achieve similar decoding performance to BP+OSD10. It is inspired by the work of M. Geiselhart et al for classical codes [2].

Note: AutDEC is currently a work in progress and a serial implementation is provided with parallelization in future plans.

Installation

PyPI: pip install autdec

Source code: Download this repository and run pip install .

Overview

Below we have an overview of the AutDEC online decoding phase:

The effectiveness of BP is limited by the presence of short-cycles on the Tanner graph. Automorphisms allow AutDEC to bypass this problem as seen below:

We provide functions for finding the graph automorphism group of arbitrary codes.

Results

In Code Capacity we provide a notebook and simulation results for [[15,1,3]] punctured Reed-Muller code in depolarising code capacity noise model.

For Bivariate Bicycle Codes we provide a notebook and simulation results under circuit-level noise simulations. Currently, simulations can take a long time for large codes because of the serial implementation.

Citation

Paper

@article{autdec_paper,
    author = "Koutsioumpas, Stergios and Sayginel, Hasan and Webster, Mark and Browne, Dan E.",
    title = "{Automorphism Ensemble Decoding of Quantum LDPC Codes}",
    eprint = "2503.01738",
    archivePrefix = "arXiv",
    journal = "arXiv:2503.01738",
    primaryClass = "quant-ph",
    month = "3",
    year = "2025"
}

Software

@misc{autdec_software,
author = {Sayginel, Hasan and Koutsioumpas, Stergios},
license = {MIT},
month = mar,
title = {{AutDEC}},
url = {https://github.com/hsayginel/autdec},
version = {1.0.0},
year = {2025}
}

References

[1] S. Koutsioumpas*, H. Sayginel*, M. Webster, D. E Browne, Automorphism Ensemble Decoding of Quantum LDPC Codes, (2025), arXiv:2503.01738 [quant-ph].

[2] M. Geiselhart, A. Elkelesh, M. Ebada, S. Cammerer and S. t. Brink, "Automorphism Ensemble Decoding of Reed–Muller Codes", in IEEE Transactions on Communications, vol. 69, no. 10, pp. 6424-6438, Oct. 2021, doi: 10.1109/TCOMM.2021.3098798.

Metadata

Release files for autdec 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for autdec 0.1.1
File Size Uploaded
autdec-0.1.1.tar.gz 19.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for autdec 0.1.1
File Interpreter ABI Platform
autdec-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 40.8 kB

Release files / autdec-0.1.1.tar.gz

Download URL autdec-0.1.1.tar.gz
Size 19.8 kB
Tags Source
SHA-256 checksum
How to use checksums
a41975f4bfb4c9abaeafb50cd05eb563ddacf7bcb6a7da7e2a1298ce00952296
BLAKE2b-256 checksum
How to use checksums
5e6e213651c8ea3ebe802274bef341cc58dc151bf1d03136e12862051f3da250
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.1.1 CPython/3.11.5 Darwin/24.3.0

Release files / autdec-0.1.1-py3-none-any.whl

Download URL autdec-0.1.1-py3-none-any.whl
Size 21.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
55c047af6b5b660969939a1fa2cd8d06b1b77c552088363661ac32c472b1506a
BLAKE2b-256 checksum
How to use checksums
62a3877ef11c6a3cc07eeee830fd371b08ca5f214ae3db18f30f2eecdd497372
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.1.1 CPython/3.11.5 Darwin/24.3.0

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page