jax.random.bernoulli#

jax.random.bernoulli(key, p=0.5, shape=None)[source]#

Sample Bernoulli random values with given shape and mean.

The values are distributed according to the probability mass function:

\[f(k; p) = p^k(1 - p)^{1 - k}\]

where \(k \in \{0, 1\}\) and \(0 \le p \le 1\).

Parameters

  • key (Union[Array, PRNGKeyArray]) – a PRNG key used as the random key.

  • p (Union[Array, ndarray, bool_, number, bool, int, float, complex]) – optional, a float or array of floats for the mean of the random variables. Must be broadcast-compatible with shape. Default 0.5.

  • shape (Union[Sequence[int], NamedShape, None]) – optional, a tuple of nonnegative integers representing the result shape. Must be broadcast-compatible with p.shape. The default (None) produces a result shape equal to p.shape.

Return type

Array

Returns

A random array with boolean dtype and shape given by shape if shape is not None, or else p.shape.