channels.dephasing
==================

.. py:module:: channels.dephasing

.. autoapi-nested-parse::

   Generates the dephasing channel.



Functions
---------

.. autoapisummary::

   channels.dephasing.dephasing


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

.. py:function:: dephasing(dim, param_p = 0)

   Produce the partially dephasing channel.

   (Section: The Completely Dephasing Channel from :cite:`Watrous_2018_TQI`).

   The Choi matrix of the completely dephasing channel that acts on :code:`dim`-by-:code:`dim`
   matrices.

   Let :math:`\Sigma` be an alphabet and let :math:`\mathcal{X} = \mathbb{C}^{\Sigma}`. The map
   :math:`\Delta \in \text{T}(\mathcal{X})` defined as

   .. math::
       \Delta(X) = \sum_{a \in \Sigma} X(a, a) E_{a,a}

   for every :math:`X \in \text{L}(\mathcal{X})` is defined as the *completely dephasing channel*.

   .. rubric:: Examples

   The completely dephasing channel maps kills everything off the diagonal. Consider the
   following matrix

   .. math::
       \rho = \begin{pmatrix}
                  1 & 2 & 3 & 4 \\
                  5 & 6 & 7 & 8 \\
                  9 & 10 & 11 & 12 \\
                  13 & 14 & 15 & 16
              \end{pmatrix}.

   Applying the dephasing channel to :math:`\rho` we have that

   .. math::
       \Phi(\rho) = \begin{pmatrix}
                        1 & 0 & 0 & 0 \\
                        0 & 6 & 0 & 0 \\
                        0 & 0 & 11 & 0 \\
                        0 & 0 & 0 & 16
                    \end{pmatrix}.

   This can be observed in :code:`|toqito⟩` as follows.

   .. jupyter-execute::

    import numpy as np
    from toqito.channels import dephasing
    from toqito.channel_ops import apply_channel

    test_input_mat = np.arange(1, 17).reshape(4, 4)

    apply_channel(test_input_mat, dephasing(4))

   We may also consider setting the parameter :code:`p = 0.5`.

   .. jupyter-execute::

    import numpy as np
    from toqito.channels import dephasing
    from toqito.channel_ops import apply_channel

    test_input_mat = np.arange(1, 17).reshape(4, 4)

    apply_channel(test_input_mat, dephasing(4, 0.5))


   .. rubric:: References

   .. bibliography::
       :filter: docname in docnames

   :param dim: The dimensionality on which the channel acts.
   :param param_p: Default is 0.
   :return: The Choi matrix of the dephasing channel.