# Module: tf.random

<br />

Public API for tf._api.v2.random namespace

## Modules

[`experimental`](https://www.tensorflow.org/api_docs/python/tf/random/experimental) module: Public API for tf._api.v2.random.experimental namespace

## Classes

[`class Algorithm`](https://www.tensorflow.org/api_docs/python/tf/random/Algorithm): A random-number-generation (RNG) algorithm.

[`class Generator`](https://www.tensorflow.org/api_docs/python/tf/random/Generator): Random-number generator.

## Functions

[`all_candidate_sampler(...)`](https://www.tensorflow.org/api_docs/python/tf/random/all_candidate_sampler): Generate the set of all classes.

[`categorical(...)`](https://www.tensorflow.org/api_docs/python/tf/random/categorical): Draws samples from a categorical distribution.

[`create_rng_state(...)`](https://www.tensorflow.org/api_docs/python/tf/random/create_rng_state): Creates a RNG state from an integer or a vector.

[`fixed_unigram_candidate_sampler(...)`](https://www.tensorflow.org/api_docs/python/tf/random/fixed_unigram_candidate_sampler): Samples a set of classes using the provided (fixed) base distribution.

[`fold_in(...)`](https://www.tensorflow.org/api_docs/python/tf/random/fold_in): Folds in data to an RNG seed to form a new RNG seed.

[`gamma(...)`](https://www.tensorflow.org/api_docs/python/tf/random/gamma): Draws `shape` samples from each of the given Gamma distribution(s).

[`get_global_generator(...)`](https://www.tensorflow.org/api_docs/python/tf/random/get_global_generator): Retrieves the global generator.

[`learned_unigram_candidate_sampler(...)`](https://www.tensorflow.org/api_docs/python/tf/random/learned_unigram_candidate_sampler): Samples a set of classes from a distribution learned during training.

[`log_uniform_candidate_sampler(...)`](https://www.tensorflow.org/api_docs/python/tf/random/log_uniform_candidate_sampler): Samples a set of classes using a log-uniform (Zipfian) base distribution.

[`normal(...)`](https://www.tensorflow.org/api_docs/python/tf/random/normal): Outputs random values from a normal distribution.

[`poisson(...)`](https://www.tensorflow.org/api_docs/python/tf/random/poisson): Draws `shape` samples from each of the given Poisson distribution(s).

[`set_global_generator(...)`](https://www.tensorflow.org/api_docs/python/tf/random/set_global_generator): Replaces the global generator with another `Generator` object.

[`set_seed(...)`](https://www.tensorflow.org/api_docs/python/tf/random/set_seed): Sets the global random seed.

[`shuffle(...)`](https://www.tensorflow.org/api_docs/python/tf/random/shuffle): Randomly shuffles a tensor along its first dimension.

[`split(...)`](https://www.tensorflow.org/api_docs/python/tf/random/split): Splits an RNG seed into `num` new seeds by adding a leading axis.

[`stateless_binomial(...)`](https://www.tensorflow.org/api_docs/python/tf/random/stateless_binomial): Outputs deterministic pseudorandom values from a binomial distribution.

[`stateless_categorical(...)`](https://www.tensorflow.org/api_docs/python/tf/random/stateless_categorical): Draws deterministic pseudorandom samples from a categorical distribution.

[`stateless_gamma(...)`](https://www.tensorflow.org/api_docs/python/tf/random/stateless_gamma): Outputs deterministic pseudorandom values from a gamma distribution.

[`stateless_normal(...)`](https://www.tensorflow.org/api_docs/python/tf/random/stateless_normal): Outputs deterministic pseudorandom values from a normal distribution.

[`stateless_parameterized_truncated_normal(...)`](https://www.tensorflow.org/api_docs/python/tf/random/stateless_parameterized_truncated_normal): Outputs random values from a truncated normal distribution.

[`stateless_poisson(...)`](https://www.tensorflow.org/api_docs/python/tf/random/stateless_poisson): Outputs deterministic pseudorandom values from a Poisson distribution.

[`stateless_truncated_normal(...)`](https://www.tensorflow.org/api_docs/python/tf/random/stateless_truncated_normal): Outputs deterministic pseudorandom values, truncated normally distributed.

[`stateless_uniform(...)`](https://www.tensorflow.org/api_docs/python/tf/random/stateless_uniform): Outputs deterministic pseudorandom values from a uniform distribution.

[`truncated_normal(...)`](https://www.tensorflow.org/api_docs/python/tf/random/truncated_normal): Outputs random values from a truncated normal distribution.

[`uniform(...)`](https://www.tensorflow.org/api_docs/python/tf/random/uniform): Outputs random values from a uniform distribution.

[`uniform_candidate_sampler(...)`](https://www.tensorflow.org/api_docs/python/tf/random/uniform_candidate_sampler): Samples a set of classes using a uniform base distribution.