Skip to main content

QREM - Quantum Readout Errors Mitigation, an open-source package for implementing measurement noise characterization and mitigation on quantum devices.

Project description

QREM

QREM - Quantum Readout Errors Mitigation, an open-source package for implementing measurement noise characterization and mitigation on quantum devices.

Status of development

This package is under development and new functionalities and notebooks are expected to be added in the future.

Currently, the methods for quantum detector tomography and measurement error mitigation based on that tomography are working properly (see Ref. [0])

Recent update implements ideas from Ref. [0.5]. This includes a) efficient characterization of multiqubit noise correlations via Diagonal Detector Overlapping Tomography (DDOT), b) using characterization data to construct a noise model which can be used to mitigate errors on the level of marginal probablitiy distributions (for problems such as QAOA).

Soon detailed tutorials will be added.

Installing

Using PIP

The best way to install this package is to use pip (see pypi website):

pip install QREM

This method will automatically install all required dependecies (see below for list of dependecies).

Cloning repository

Alternatively, one can simply clone the repository:

git clone https://github.com/fbm2718/QREM

Please note that when using this method, one needs to make sure that all imports/dependecies are proper.

Jupyter tutorials

Most of the functionalities are described in detail in the comments inside the code. However, before starting to use the package, we recommend to take a look at tutorials in jupyter notebooks:

(Quantum Detector Tomography)

  1. Tutorial for implementing Quantum Detector Tomography
  2. Tutorial for mitigating readout noise based on QDT

(Diagonal Detector Overlapping Tomography)

  1. Tutorials for DDOT will be added soon! In the meantime -- see examples.

Authors

References

The workflow of this package is mainly based on works:

[0] Filip B. Maciejewski, Zoltán Zimborás, Michał Oszmaniec, "Mitigation of readout noise in near-term quantum devices by classical post-processing based on detector tomography", Quantum 4, 257 (2020)

[0.5] Filip B. Maciejewski, Flavio Baccari, Zoltán Zimborás, Michał Oszmaniec, "Modeling and mitigation of cross-talk effects in readout noise with applications to the Quantum Approximate Optimization Algorithm", Quantum 5, 464 (2021)

Further references:

[1] Z. Hradil, J. Řeháček, J. Fiurášek, and M. Ježek, “3 maximum-likelihood methods in quantum mechanics,” in Quantum State Estimation, edited by M. Paris and J. Řeháček (Springer Berlin Heidelberg, Berlin, Heidelberg, 2004) pp. 59–112.

[2] J. Fiurášek, Phys. Rev. A 64, 024102 (2001).

[3] Zbigniew Puchała, Łukasz Pawela, Aleksandra Krawiec, Ryszard Kukulski, "Strategies for optimal single-shot discrimination of quantum measurements", Phys. Rev. A 98, 042103 (2018).

[4] T. Weissman, E. Ordentlich, G. Seroussi, S. Verdul, and M. J. Weinberger, Technical Report HPL-2003-97R1, Hewlett-Packard Labs (2003).

[5] John A. Smolin, Jay M. Gambetta, Graeme Smith, "Maximum Likelihood, Minimum Effort", Phys. Rev. Lett. 108, 070502 (2012).

[6] J. Cotler, F. Wilczek, "Quantum Overlapping Tomography", Phys. Rev. Lett. 124, 100401 (2020).

Dependencies

For QREM to work properly, the following libraries should be installed:

  • "numpy >= 1.20.3",
  • "scipy >= 1.6.2",
  • "tqdm >= 4.46.0",
  • "colorama >= 0.4.3",
  • "qiskit >= 0.28.0",

Optional dependencies

Dependecies for working with different backends than qiskit:

  • "pyquil >= 3.0.0",
  • "amazon-braket-sdk >= 1.9.5"

Citation

The following bibtex entry can be used to cite this repository:

@misc{qrem, url={https://github.com/fbm2718/QREM}, title = {Quantum Readout Errors Mitigation (QREM) -- open source GitHub repository}, author={Maciejewski, F. B. and Rybotycki, T. and S\l{}owik, O., and Oszmaniec, M.}, year={2020}, }

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

QREM-0.0.54.tar.gz (16.6 MB view hashes)

Uploaded Source

Built Distribution

QREM-0.0.54-py3-none-any.whl (17.1 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page