Skip to content

QEC-pages/Modular-Surface-code-simulations

Repository files navigation

Modular Surface Code Simulations

This repository contains the simulation code accompanying our paper:

"Optimized Noise-Resilient Surface Code Teleportation Interfaces"
arXiv:2503.04968

The purpose of this repository is to facilitate reproducibility and further exploration of our results. Please feel free to contact us with any questions or feedback.


Repository Structure

  • lib/
    Contains functions for generating Stim circuits. Each file corresponds to a specific configuration studied in our paper:

    • Rotated vs. Unrotated Surface Codes
    • Interface Gadgets: Direct, CAT, and Gate Teleportation (GT)

    (Note: Some redundancy is present for clarity and ease of use.)

  • Main Simulation.ipynb
    Jupyter notebook responsible for sampling from the generated circuits and performing decoding using PyMatching.

  • Analysis and Plotting.ipynb
    Jupyter notebook dedicated to analyzing simulation data. This includes:

    • Threshold calculations
    • Gamma factor computations
    • Visualization and plotting of results
  • Raw Data

    • DATA.json: Complete raw data from simulations presented in our paper.
    • thresholds.csv: Threshold values derived from the simulation data.
    • lambda p=0.00345.csv: Specific lambda calculations at physical error rate p=0.00345.
  • Plots/
    Directory containing high-quality PDF plots generated for the publication.


Usage

To reproduce results, we recommend starting with Simulation.ipynb to generate or validate existing data, followed by Analysis and Plotting.ipynb for detailed analysis and visualization.


Citation

If you use this code or find our work useful, please cite:

@article{Shalby2025Optimized,
  title={Optimized noise-resilient surface code teleportation interfaces},
  author={Shalby, Mohamed A. and Wang, Renyu and Sedov, Denis and Pryadko, Leonid P.},
  journal={arXiv preprint arXiv:2503.04968},
  year={2025},
  doi={10.48550/arXiv.2503.04968},
  url={https://arxiv.org/abs/2503.04968}
}


For any additional information, please don't hesitate to reach out. [email protected]

About

python simulation and analysis code for arXiv:2503.04986

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published