This release is a pre-release and may not be stable for production use.
Performance Estimator of Codes On Surfaces (PECOS) is a library/framework dedicated to the study, development, and evaluation of quantum error-correction protocols. It offers tools for the study and evaluation of hybrid quantum/classical compute execution models for NISQ algorithms and beyond.
Initially conceived and developed in 2014 to verify lattice-surgery procedures presented in arXiv:1407.5103 and released publicly in 2018, PECOS filled a significant gap in the QEC/QC tools available at that time. Over the years, it has grown into a framework for studying general QECCs and hybrid computation.
With an emphasis on clarity, flexibility, and performance and catering to both QEC students and developers, PECOS is refined continually with these attributes in mind.
Features
- Quantum Error-Correction Tools: Advanced tools for studying quantum error-correction protocols and error models.
- Hybrid Quantum/Classical Execution: Evaluate advanced hybrid compute models, including support for classical compute, calls to Wasm VMs, conditional branching, and more.
- Fast Simulation: Leverage the fast stabilizer-simulation algorithm.
- Extensible: Add-ons and extensions support in C and C++ via Cython.
Getting Started
Explore the capabilities of PECOS by delving into the official documentation.
Versioning
We follow semantic versioning principles. However, before version 1.0.0, the MAJOR.MINOR.BUG format sees the roles of MAJOR and MINOR shifted down a step. This means potential breaking changes might occur between MINOR increments, such as moving from versions 0.1.0 to 0.2.0.
Latest Development
Stay updated with the latest developments on the PECOS Development branch.
Installation
- Clone or download the desired version of PECOS.
- Navigate to the root directory, where
pyproject.tomlis located. - Install using pip:
pip install .
To install optional dependencies, such as for Wasm support or state vector simulations, see pyproject.toml for list of
options. To install all optional dependencies use:
pip install .[all]
For development, use (while including installation options as necessary):
On Linux/Mac:
python -m venv .venv
source .venv/bin/activate
pip install -U pip setuptools
pip install -r requirements.txt
make metadeps
pre-commit install
pip install -e .
On Windows:
python -m venv .venv
.\venv\Scripts\activate
pip install -U pip setuptools
pip install -r requirements.txt
make metadeps
pre-commit install
pip install -e .
See Makefile for other useful commands.
Tests can be run using:
pytest tests
Uninstall
To uninstall:
pip uninstall quantum-pecos
Citing
For publications utilizing PECOS, kindly cite PECOS such as:
@misc{pecos,
author={Ciaran Ryan-Anderson},
title={PECOS: Performance Estimator of Codes On Surfaces},
journal={GitHub},
howpublished={\url{https://github.com/PECOS-packages/PECOS}},
URL = {https://github.com/PECOS-packages/PECOS},
year={2018}
}
@phdthesis{crathesis,
author={Ciaran Ryan-Anderson},
school = {University of New Mexico},
title={Quantum Algorithms, Architecture, and Error Correction},
journal={arXiv:1812.04735},
year={2018}
}
License
This project is licensed under the Apache-2.0 License - see the LICENSE and NOTICE files for details.
Supported by
2 maintainers
Release files for quantum-pecos 0.5.0.dev5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| quantum-pecos-0.5.0.dev5.tar.gz | 147.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| quantum_pecos-0.5.0.dev5-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details |
Total release size: 435.5 kB
Release files / quantum-pecos-0.5.0.dev5.tar.gz
| Download URL | quantum-pecos-0.5.0.dev5.tar.gz |
|---|---|
| Size | 147.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
771d40c6f40c6f64c39833774155f45719c1f5ba81333e121f96cb68633d75d5
|
|
BLAKE2b-256 checksum How to use checksums |
9b37a503ca8479622455f4e100870a22f5d7ffbb8e3c42f20522d55476478dd1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.12.1
|
Release files / quantum_pecos-0.5.0.dev5-py2.py3-none-any.whl
| Download URL | quantum_pecos-0.5.0.dev5-py2.py3-none-any.whl |
|---|---|
| Size | 288.5 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
ce1350f911e05542b9334ff2534bd07d033bab23e1ef2b4f8eee9f7b295d23f3
|
|
BLAKE2b-256 checksum How to use checksums |
0c80e1057cfa3f7adc6ff8a7ba945c679f8536ad42e15f20e48ff54eb1b83e4e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.12.1
|
