:py:mod:`rand.random_ginibre`
=============================

.. py:module:: rand.random_ginibre

.. autoapi-nested-parse::

   Generate Ginibre random matrix.



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


Functions
~~~~~~~~~

.. autoapisummary::

   rand.random_ginibre.random_ginibre



.. py:function:: random_ginibre(dim_n, dim_m)

   Generate a Ginibre random matrix :cite:`WikiCircLaw`.

   Generates a random :code:`dim_n`-by-:code:`dim_m` Ginibre matrix.

   A *Ginibre random matrix* is a matrix with independent and identically distributed complex standard Gaussian
   entries.

   Ginibre random matrices are used in the construction of Wishart-random POVMs :cite:`Heinosaari_2020_Random`.

   .. rubric:: Examples

   Generate a random :math:`2`-by-:math:`2` Ginibre random matrix.

   >>> from toqito.rand import random_ginibre
   >>> random_ginibre(2, 2)
   [[ 0.06037649-0.05158031j  0.46797859+0.21872729j]
    [-0.95223112-0.71959831j  0.3404352 +0.11166238j]]

   .. rubric:: References

   .. bibliography::
       :filter: docname in docnames

   :param dim_n: The number of rows of the Ginibre random matrix.
   :param dim_m: The number of columns of the Ginibre random matrix.
   :return: A :code:`dim_n`-by-:code:`dim_m` Ginibre random density matrix.