jax.random.bits

Contents

jax.random.bits#

jax.random.bits(key, shape=(), dtype=None, *, out_sharding=None)[source]#

Sample uniform bits in the form of unsigned integers.

Parameters:

  • key (ArrayLike) – a PRNG key used as the random key.

  • shape (Shape) – optional, a tuple of nonnegative integers representing the result shape. Default ().

  • dtype (DTypeLikeUInt | None) – optional, an unsigned integer dtype for the returned values (default uint64 if jax_enable_x64 is true, otherwise uint32).

  • out_sharding (NamedSharding | P | None) – Optional. Specifies how the output array should be sharded across devices in multi-device computation. Can be a NamedSharding, a PartitionSpec (P), or None (default). When specified, the output will be sharded according to the given sharding specification. Primarily used in explicit sharding mode. See the explicit sharding tutorial for more details.

Returns:

A random array with the specified shape and dtype.

Return type:

Array

Contents