Spec-Zone.ru › TensorFlow 2.9

tf.random.uniform

Просмотреть исходный код на GitHub

Выводит случайные значения из равномерного распределения.

Просмотр псевдонимов

Псевдонимы для миграции

См. Руководство по миграции для получения дополнительной информации.

tf.compat.v1.random.uniform, tf.compat.v1.random_uniform

tf.random.uniform(
    shape,
    minval=0,
    maxval=None,
    dtype=tf.dtypes.float32,
    seed=None,
    name=None
)

Сгенерированные значения следуют равномерному распределению в диапазоне [minval, maxval). Нижняя граница minval включена в диапазон, а верхняя граница maxval исключена.

Для чисел с плавающей точкой диапазон по умолчанию [0, 1). Для целых чисел необходимо явно указать, по крайней мере, maxval.

В случае целых чисел случайные целые числа незначительно смещены, если maxval - minval не является точной степенью двойки. Смещение невелико для значений maxval - minval значительно меньших диапазона вывода (либо 2**32 либо 2**64).

Примеры:

tf.random.uniform(shape=[2])
<tf.Tensor: shape=(2,), dtype=float32, numpy=array([..., ...], dtype=float32)>
tf.random.uniform(shape=[], minval=-1., maxval=0.)
<tf.Tensor: shape=(), dtype=float32, numpy=-...>
tf.random.uniform(shape=[], minval=5, maxval=10, dtype=tf.int64)
<tf.Tensor: shape=(), dtype=int64, numpy=...>

Аргумент seed создает детерминированную последовательность тензоров при нескольких вызовах. Для повторения этой последовательности используйте tf.random.set_seed:

tf.random.set_seed(5)
tf.random.uniform(shape=[], maxval=3, dtype=tf.int32, seed=10)
<tf.Tensor: shape=(), dtype=int32, numpy=2>
tf.random.uniform(shape=[], maxval=3, dtype=tf.int32, seed=10)
<tf.Tensor: shape=(), dtype=int32, numpy=0>
tf.random.set_seed(5)
tf.random.uniform(shape=[], maxval=3, dtype=tf.int32, seed=10)
<tf.Tensor: shape=(), dtype=int32, numpy=2>
tf.random.uniform(shape=[], maxval=3, dtype=tf.int32, seed=10)
<tf.Tensor: shape=(), dtype=int32, numpy=0>

Без tf.random.set_seed, но с указанным аргументом seed, небольшие изменения в графах функций или ранее выполненных операциях изменят возвращаемое значение. См. tf.random.set_seed для подробностей.

Аргументы
shape 1-мерный целочисленный тензор или массив Python. Форма тензора вывода.
minval Тензор или значение Python типа dtype, совместимое с shape (для целочисленных типов векторизация не поддерживается, поэтому он должен быть скалярным). Нижняя граница диапазона генерируемых случайных значений (включительно). По умолчанию 0.
maxval Тензор или значение Python типа dtype, совместимое с shape (для целочисленных типов векторизация не поддерживается, поэтому он должен быть скалярным). Верхняя граница диапазона генерируемых случайных значений (исключая). По умолчанию 1, если dtype с плавающей точкой.
dtype Тип вывода: float16, bfloat16, float32, float64, int32, или int64. По умолчанию float32.
seed Целое число Python. Используется в сочетании с tf.random.set_seed для создания воспроизводимой последовательности тензоров при нескольких вызовах.
name Имя операции (необязательно).
Возвращает
Тензор заданной формы, заполненный случайными равномерными значениями.
Возможные ошибки
ValueError Если dtype целочисленный и maxval не указан.

© 2022 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 4.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.9/api_docs/python/tf/random/uniform

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API