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-D или массив 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.4/api_docs/python/tf/random/stateless_uniform