rand.random_ginibre
===================

.. py:module:: rand.random_ginibre

.. autoapi-nested-parse::

   Generates a Ginibre random matrix.



Functions
---------

.. autoapisummary::

   rand.random_ginibre.random_ginibre


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

.. py:function:: random_ginibre(dim_n, dim_m, seed = None)

   Generate a Ginibre random matrix :footcite:`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 :footcite:`Heinosaari_2020_Random`.

   .. rubric:: Examples

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

   .. jupyter-execute::

    from toqito.rand import random_ginibre

    random_ginibre(2, 2)

   It is also possible to pass a seed to this function for reproducibility.

   .. jupyter-execute::

    from toqito.rand import random_ginibre

    random_ginibre(2, 2, seed=42)

   .. rubric:: References

   .. footbibliography::

   :param dim_n: The number of rows of the Ginibre random matrix.
   :param dim_m: The number of columns of the Ginibre random matrix.
   :param seed: A seed used to instantiate numpy's random number generator.
   :return: A :code:`dim_n`-by-:code:`dim_m` Ginibre random matrix.