tf.random.stateless_truncated_normal
Stay organized with collections
Save and categorize content based on your preferences.
Outputs deterministic pseudorandom values, truncated normally distributed.
tf.random.stateless_truncated_normal(
shape,
seed,
mean=0.0,
stddev=1.0,
dtype=tf.dtypes.float32,
name=None,
alg='auto_select'
)
This is a stateless version of tf.random.truncated_normal: if run twice with
the same seeds and shapes, 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.
The generated values follow a normal distribution with specified mean and
standard deviation, except that values whose magnitude is more than 2 standard
deviations from the mean are dropped and re-picked.
Args |
|---|
shape
|
A 1-D integer Tensor or Python array. The shape of the output tensor.
|
seed
|
A shape [2] Tensor, the seed to the random number generator. Must have
dtype int32 or int64. (When using XLA, only int32 is allowed.)
|
mean
|
A 0-D Tensor or Python value of type dtype. The mean of the
truncated normal distribution.
|
stddev
|
A 0-D Tensor or Python value of type dtype. The standard deviation
of the normal distribution, before truncation.
|
dtype
|
The type of the output.
|
name
|
A name for the operation (optional).
|
alg
|
The RNG algorithm used to generate the random numbers. See
tf.random.stateless_uniform for a detailed explanation.
|
Returns |
|---|
|
A tensor of the specified shape filled with random truncated normal values.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates. Some content is licensed under the numpy license.
Last updated 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[],[],null,["# tf.random.stateless_truncated_normal\n\n\u003cbr /\u003e\n\n|----------------------------------------------------------------------------------------------------------------------------------------|\n| [View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.13.1/tensorflow/python/ops/stateless_random_ops.py#L811-L858) |\n\nOutputs deterministic pseudorandom values, truncated normally distributed.\n\n#### View aliases\n\n\n**Compat aliases for migration**\n\nSee\n[Migration guide](https://www.tensorflow.org/guide/migrate) for\nmore details.\n\n[`tf.compat.v1.random.stateless_truncated_normal`](https://www.tensorflow.org/api_docs/python/tf/random/stateless_truncated_normal)\n\n\u003cbr /\u003e\n\n tf.random.stateless_truncated_normal(\n shape,\n seed,\n mean=0.0,\n stddev=1.0,\n dtype=../../tf/dtypes#float32,\n name=None,\n alg='auto_select'\n )\n\nThis is a stateless version of [`tf.random.truncated_normal`](../../tf/random/truncated_normal): if run twice with\nthe same seeds and shapes, it will produce the same pseudorandom numbers. The\noutput is consistent across multiple runs on the same hardware (and between\nCPU and GPU), but may change between versions of TensorFlow or on non-CPU/GPU\nhardware.\n\nThe generated values follow a normal distribution with specified mean and\nstandard deviation, except that values whose magnitude is more than 2 standard\ndeviations from the mean are dropped and re-picked.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Args ---- ||\n|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `shape` | A 1-D integer Tensor or Python array. The shape of the output tensor. |\n| `seed` | A shape \\[2\\] Tensor, the seed to the random number generator. Must have dtype `int32` or `int64`. (When using XLA, only `int32` is allowed.) |\n| `mean` | A 0-D Tensor or Python value of type `dtype`. The mean of the truncated normal distribution. |\n| `stddev` | A 0-D Tensor or Python value of type `dtype`. The standard deviation of the normal distribution, before truncation. |\n| `dtype` | The type of the output. |\n| `name` | A name for the operation (optional). |\n| `alg` | The RNG algorithm used to generate the random numbers. See [`tf.random.stateless_uniform`](../../tf/random/stateless_uniform) for a detailed explanation. |\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Returns ------- ||\n|---|---|\n| A tensor of the specified shape filled with random truncated normal values. ||\n\n\u003cbr /\u003e"]]
View source on GitHub