# tf.random.stateless_binomial

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.2.0/tensorflow/python/ops/stateless_random_ops.py#L132-L197) |

Outputs deterministic pseudorandom values from a binomial distribution.

#### View aliases


**Compat aliases for migration**

See
[Migration guide](https://www.tensorflow.org/guide/migrate) for
more details.

[`tf.compat.v1.random.stateless_binomial`](https://www.tensorflow.org/api_docs/python/tf/random/stateless_binomial)

<br />

    tf.random.stateless_binomial(
        shape, seed, counts, probs, output_dtype=tf.dtypes.int32, name=None
    )

The generated values follow a binomial distribution with specified count and
probability of success parameters.

This is a stateless version of [`tf.random.Generator.binomial`](https://www.tensorflow.org/versions/r2.2/api_docs/python/tf/random/Generator#binomial): if run twice
with the same seeds, it will produce the same pseudorandom numbers. The
output is consistent across multiple runs on the same hardware (and between
CPU and GPU), but may change between versions of TensorFlow or on non-CPU/GPU
hardware.

#### Example:

    counts = [10., 20.]
    # Probability of success.
    probs = [0.8]

    binomial_samples = tf.random.stateless_binomial(
        shape=[2], seed=[123, 456], counts=counts, probs=probs)

    counts = ... # Shape [3, 1, 2]
    probs = ...  # Shape [1, 4, 2]
    shape = [3, 4, 3, 4, 2]
    # Sample shape will be [3, 4, 3, 4, 2]
    binomial_samples = tf.random.stateless_binomial(
        shape=shape, seed=[123, 456], counts=counts, probs=probs)

<br />

<br />

<br />

| ## Args ||
|---|---|
| `shape` | A 1-D integer Tensor or Python array. The shape of the output tensor. |
| `seed` | A shape \[2\] integer Tensor of seeds to the random number generator. |
| `counts` | Tensor. The counts of the binomial distribution. Must be broadcastable with `probs`, and broadcastable with the rightmost dimensions of `shape`. |
| `probs` | Tensor. The probability of success for the binomial distribution. Must be broadcastable with `counts` and broadcastable with the rightmost dimensions of `shape`. |
| `output_dtype` | The type of the output. Default: tf.int32 |
| `name` | A name for the operation (optional). |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| `samples` | A Tensor of the specified shape filled with random binomial values. For each i, each samples\[..., i\] is an independent draw from the binomial distribution on counts\[i\] trials with probability of success probs\[i\]. |

<br />