: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) # doctest: +SKIP
   array([[0.39166472-1.54657971j, 0.36538245+0.23324642j],
          [0.50103695-0.25857737j, 0.8357054 +0.31404353j]])

   .. 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.