tf.random.stateless_uniform
| Просмотреть исходный код на GitHub |
Выводит детерминированные псевдослучайные значения из равномерного распределения.
tf.random.stateless_uniform(
shape, seed, minval=0, maxval=None, dtype=tf.dtypes.float32, name=None
)
Это бессостояниевая версия tf.random.uniform: если её выполнить дважды с одинаковыми семенами и формами, она сгенерирует одни и те же псевдослучайные числа. Выход является согласованным при нескольких запусках на одном оборудовании (и между CPU и GPU), но может измениться между версиями TensorFlow или на оборудовании, не являющимся CPU/GPU.
Сгенерированные значения следуют равномерному распределению в диапазоне [minval, maxval). Нижняя граница minval включается в диапазон, а верхняя граница maxval исключается.
Для чисел с плавающей точкой, по умолчанию, диапазон — [0, 1). Для целых чисел, как минимум, maxval должен быть указан явно.
В случае целых чисел, случайные целые числа немного смещены, если maxval - minval не является точной степенью двойки. Смещение невелико для значений maxval - minval, значительно меньших диапазона вывода (либо 2**32 или 2**64).
Для случайных целых чисел с полным диапазоном (т. е. включающими как максимальное, так и минимальное значения), передайте minval=None и maxval=None с целым dtype. Для целочисленного типа данных, как minval так и maxval должны быть None или ни один из них не должен быть None. Например:
ints = tf.random.stateless_uniform(
[10], seed=(2, 3), minval=None, maxval=None, dtype=tf.int32)
| Аргументы | |
|---|---|
shape | 1-мерный целочисленный тензор или Python-массив. Форма тензора вывода. |
seed | Тензор формы [2], семя для генератора случайных чисел. Должен иметь тип данных int32 или int64. (При использовании XLA, разрешен только int32.) |
minval | Тензор или Python-значение типа dtype, совместимое по трансляции с shape (для целочисленных типов трансляция не поддерживается, поэтому необходимо использовать скаляр). Нижняя граница диапазона случайных значений для генерации. Передайте None для целых чисел с полным диапазоном. По умолчанию 0. |
maxval | Тензор или Python-значение типа dtype, совместимое по трансляции с shape (для целочисленных типов трансляция не поддерживается, поэтому необходимо использовать скаляр). Верхняя граница диапазона случайных значений для генерации. По умолчанию 1, если dtype является числом с плавающей точкой. Передайте None для целых чисел с полным диапазоном. |
dtype | Тип вывода: float16, float32, float64, int32, или int64. Для неограниченных целых случайных чисел (minval, maxval оба None), можно использовать uint32 и uint64. |
name | Имя операции (необязательно). |
| Возвращаемое значение | |
|---|---|
| Тензор заданной формы, заполненный случайными равномерными значениями. |
| Исключения | |
|---|---|
ValueError | Если dtype является целым числом и указан только один из minval или maxval . |
© 2020 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.3/api_docs/python/tf/random/stateless_uniform
