System Entropy

numpy.random.entropy.random_entropy(size=None, source='system')

Read entropy from the system cryptographic provider

size : int or tuple of ints, optional

Output shape. If the given shape is, e.g., (m, n, k), then m * n * k samples are drawn. Default is None, in which case a single value is returned.

source : str {‘system’, ‘fallback’}

Source of entropy. ‘system’ uses system cryptographic pool. ‘fallback’ uses a hash of the time and process id.

entropy : scalar or array

Entropy bits in 32-bit unsigned integers. A scalar is returned if size is None.


On Unix-like machines, reads from /dev/urandom. On Windows machines reads from the RSA algorithm provided by the cryptographic service provider.

This function reads from the system entropy pool and so samples are not reproducible. In particular, it does NOT make use of a BitGenerator, and so seed and setting state have no effect.

Raises RuntimeError if the command fails.

Previous topic


Next topic

Set routines