Simon Brauer, Jan Provaznik, Vojtech Kala, and Peter Marek

                                 humbly present

        CATABILITY AS A METRIC FOR EVALUATING SUPERPOSED COHERENT STATES
                      (https://doi.org/10.1103/qfnt-6drh)

        Superposed coherent states are central to quantum technologies,
             yet their reliable identification remains challenging,
            especially in noisy or resource-constrained settings. We
         introduce a novel, directly measurable criterion for detecting
                      cat-like features in quantum states.

Runtime environment

  To create the runtime environment, run

    python -m venv runtime
    runtime/bin/python -m pip install -r project/requirements.pip

  where the installation of mpi4py might require additional tools available in
  the environment. Please see its documentation for further details.

  Establishing Gaussian thresholds (see task.thresholds) is computationally
  expensive and benefits from parallelization. To enable parallel execution on
  networked devices, the project integrates the standardized Message Passing
  Interface (MPI) through the mpi4py library.

  Support for the mpirun command is required within the operating system.

Execution

  (1) task.thresholds (refer to 'task.thresholds/README')

      The numerical simulations depend on Gaussian thresholds. Consequently,
      these must be determined first before any other processing.

      The thresholds can be obtained by executing the relevant task.
      Alternatively, precomputed datasets are provided.

  (2) task.comparison (refer to 'task.comparison/README')

      This task produces the datasets used by the first figure of the
      manuscript and also provides the procedures necessary for their
      reproduction.

      Alternatively, precomputed datasets are provided.

  (3) task.measurable (refer to 'task.measurable/README')

      This task produces the datasets used by the second figure of the
      manuscript and also provides the procedures necessary for their
      reproduction.

      Alternatively, precomputed datasets are provided.

Readily available datasets

  This repository contains precomputed datasets within the 'results' directory.
  The figures presented within the published manuscript can be reconstructed
  from this data.

  The figures are also available within the 'figures' directory.

Citing this work

  If you base your research on this code, please cite the associated
  publication, available from (https://doi.org/10.1103/qfnt-6drh).
  
  @article{brauer2026,
    title = {Catability as a Metric for Evaluating Superposed Coherent States}, 
    author = {
      Br{\"{a}}uer, {\v{S}}imon and 
      Provazn{\'{i}}k, Jan and 
      Kala, Vojt{\v{e}}ch and 
      Marek, Petr
    }, 
    year = {2026}, 
    month = {3}, 
    day = {5}, 
    number = {9}, 
    volume = {136}, 
    journal = {Physical Review Letters}, 
    pages = {090205}, 
    publisher = {American Physical Society (APS)}, 
    url = {http://dx.doi.org/10.1103/qfnt-6drh}, 
    doi = {10.1103/qfnt-6drh}
  }

Scientific repositories

  https://zenodo.org/records/15720386
    via https://doi.org/10.5281/zenodo.15720386
  Source code and datasets, as presented within the manuscript.

  https://zenodo.org/records/20267670
    via https://doi.org/10.1103/qfnt-6drh
  The manuscript, as published within Physical Review Letters.

References (scientific libraries)

  This project uses standard libraries and relies on mpi4py (A) for parallel
  execution of numerical computations realized using numpy (B) and scipy (C)
  libraries. Results of the simulations are visualised using matplotlib (D).

  (A) mpi4py       [https://doi.org/10.1109/TPDS.2022.3225481]
  (B) numpy        [https://doi.org/10.1038/s41586-020-2649-2]
  (C) scipy        [https://doi.org/10.1038/s41592-019-0686-2]
  (D) matplotlib   [https://doi.org/10.1109/MCSE.2007.55]