stabilizer-qec
A surface-code simulator and decoder written in Rust, with Python bindings.
- Circuits and detector error models in Stim's text formats, and error models built by walking a circuit backwards, identical to Stim's on every circuit checked.
- Exact minimum-weight matching by sparse blossom, and correlated matching, agreeing with PyMatching shot for shot except for ties.
- A bit-parallel sampler, 64 shots per machine word, that runs
REPEATblocks without flattening. - Raw measurements to detection events, reproducing Google's Willow and Sycamore files bit for bit.
- Sliding and parallel window decoders for real-time decoding.
- Belief propagation reproducing the
ldpclibrary's arithmetic bit for bit, and belief-matching equal to thebeliefmatchingpackage's. - BP+OSD (OSD-0, OSD-E, OSD-CS), whose corrections equal
ldpc'sBpOsdDecoder's, and IBM's bivariate bicycle codes: the gross code [[144, 12, 12]] and [[72, 12, 6]], with the depth-8 syndrome cycle of Bravyi et al. (Nature 627, 778, 2024). - Lattice surgery between two surface-code patches as a single circuit, its error model equal to Stim's.
import numpy as np, stabilizer_qec as sq
text = sq.generate_circuit("rotated", 5, 5, "sd6", 0.004) # Stim-format circuit
dets, obs, _ = sq.sample_b8_batch(text, 100_000, seed=1) # b8 rows
pred, _, errors, seconds = sq.decode_b8_own(text, dets, 100_000, threads=0, correlated=True)
failures = ((np.frombuffer(pred, "<u8") & 1) != (np.frombuffer(obs, np.uint8) & 1)).sum()
The gross code, decoded by BP+OSD:
circuit = sq.bb_memory_circuit("gross", 12, 0.003) # [[144, 12, 12]], 12 cycles
dem = sq.dem_from_circuit(circuit) # each fault its own column
dets, obs, _ = sq.sample_b8_batch(circuit, 2_000, seed=1)
pred, converged, seconds = sq.decode_b8_bposd(dem, dets, 2_000) # BP+OSD-CS, order 7
truth = np.frombuffer(obs, np.uint8).reshape(-1, 2).view("<u2")[:, 0]
failures = (np.frombuffer(pred, "<u8") != truth).sum() # any of the 12 logicals wrong
The explainer, with every figure computed live in the browser, is at https://qcompiler.jaspersands.com. The source and the full write-up are at https://github.com/Jaspersands/quantum-simulator-qec.
1 maintainer
Metadata
1 maintainer
Release files for stabilizer-qec 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| stabilizer_qec-0.3.0.tar.gz | 214.5 kB | With provenance | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| stabilizer_qec-0.3.0-cp39-abi3-win_amd64.whl | CPython 3.9 | abi3 | Windows x86-64 | Details |
| stabilizer_qec-0.3.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.9 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| stabilizer_qec-0.3.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | CPython 3.9 | abi3 | Linux glibc 2.17+ ARM64 | Details |
| stabilizer_qec-0.3.0-cp39-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl | CPython 3.9 | abi3 | macOS 10.12+ x86-64, macOS 10.12+ universal2 (ARM64, x86-64), macOS 11.0+ ARM64 | Details |
Total release size: 4.4 MB
Release files / stabilizer_qec-0.3.0.tar.gz
| Download URL | stabilizer_qec-0.3.0.tar.gz |
|---|---|
| Size | 214.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5e4d8a7590a0788d101807f24dcd5b4f6251729a5ab3cc44b7507604c7608c81
|
|
BLAKE2b-256 checksum How to use checksums |
c5a538ce29ea015bb48d77bda1ed4fc810b5d4f6960883942e243b4914934364
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency logRelease files / stabilizer_qec-0.3.0-cp39-abi3-win_amd64.whl
| Download URL | stabilizer_qec-0.3.0-cp39-abi3-win_amd64.whl |
|---|---|
| Size | 613.2 kB |
| Tags | CPython 3.9 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
73a90a79bb4104a27cd495aa1eaacbb7af2fc0aed35cb215c8752fb979899c79
|
|
BLAKE2b-256 checksum How to use checksums |
07fdc7a025639234a8d1f751467aa477285590c53ad3835bd1f1437ad9f598ea
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency logRelease files / stabilizer_qec-0.3.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | stabilizer_qec-0.3.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.9 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
b429430ae37fe8285da19318189aa2aba6ee9a88977ddc1a9fc63d80a91149c5
|
|
BLAKE2b-256 checksum How to use checksums |
624c948312adcd2dba4fd366b742c327152d2cb5cba27f3900beb2a4f08e228e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency logRelease files / stabilizer_qec-0.3.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | stabilizer_qec-0.3.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.9 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
cf5c30348656f03f29357b1f4cd4197e726632b1eb51846a01cf5056d2a4d659
|
|
BLAKE2b-256 checksum How to use checksums |
abaa7ddfcf3b196da7dcd3280d87ffe73e1491936daf1589245b03166bb54f9d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency logRelease files / stabilizer_qec-0.3.0-cp39-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl
| Download URL | stabilizer_qec-0.3.0-cp39-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.9 abi3 macOS 10.12+ universal2 (ARM64, x86-64) macOS 10.12+ x86-64 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
a214f6370cfccf62dfd196382fc0d38996eb401a9af004589d0e8dd90b33023b
|
|
BLAKE2b-256 checksum How to use checksums |
a3e88651c5df74ccbff56f3ec17427f5abd045dde48ff6e92304e1858379dc2e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency logSecurity for stabilizer-qec 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 5 files in this release have been uploaded with provenance metadata.
Attestation for stabilizer_qec-0.3.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
