measurements.pretty_good_measurement
====================================

.. py:module:: measurements.pretty_good_measurement

.. autoapi-nested-parse::

   Compute the set of pretty good measurements from an ensemble.



Functions
---------

.. autoapisummary::

   measurements.pretty_good_measurement.pretty_good_measurement


Module Contents
---------------

.. py:function:: pretty_good_measurement(states, probs = None, tol = 1e-08)

   Return the set of pretty good measurements from a set of vectors and corresponding probabilities.

   This computes the "pretty good measurement" as initially defined in :cite:`Hughston_1993_Complete`.

   The pretty good measurement (PGM) (also known as the "square root measurement") is the set of POVMs :math:`(G_1,
   \ldots, G_n)` such that

   .. math::
       G_i = P^{-1/2} \left(p_i \rho_i\right) P^{-1/2} \quad \text{where} \quad
       P = \sum_{i=1}^n p_i \rho_i.

   .. seealso:: :func:`.pretty_bad_measurement`

   .. rubric:: Examples

   Consider the collection of trine states.

   .. math::
       u_0 = |0\rangle, \quad
       u_1 = -\frac{1}{2}\left(|0\rangle + \sqrt{3}|1\rangle\right), \quad \text{and} \quad
       u_2 = -\frac{1}{2}\left(|0\rangle - \sqrt{3}|1\rangle\right).

   .. jupyter-execute::

    from toqito.states import trine
    from toqito.measurements import pretty_good_measurement

    states = trine()
    probs = [1 / 3, 1 / 3, 1 / 3]

    pgm = pretty_good_measurement(states, probs)

    pgm

   .. rubric:: References

   .. bibliography::
       :filter: docname in docnames

   :raises ValueError: If number of vectors does not match number of probabilities.
   :raises ValueError: If probabilities do not sum to 1.
   :param states: A collection of either states provided as either vectors or density matrices.
   :param probs: A set of fixed probabilities for a given ensemble of quantum states.
                 The function assumes a uniform probability distribution if the fixed
                 probabilities for the input ensemble are not provided.
   :param tol: A tolerance value for numerical comparisons.