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

.. py:module:: toqito.rand.random_ginibre

.. autoapi-nested-parse::

   Generates a Ginibre random matrix.





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

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

   Generate a Ginibre random matrix [@WikiCircLaw].

   Generates a random `dim_n`-by-`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 [@Heinosaari_2020_Random].

   .. rubric:: Examples

   Generate a random \(2\)-by-\(2\) Ginibre random matrix.

   ```python exec="1" source="above"
   from toqito.rand import random_ginibre

   print(random_ginibre(2, 2))
   ```

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

   ```python exec="1" source="above"
   from toqito.rand import random_ginibre

   print(random_ginibre(2, 2, seed=42))
   ```

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

   :returns: A `dim_n`-by-`dim_m` Ginibre random matrix.