tf.random.uniform
| Просмотр исходного кода на GitHub |
Выводит случайные значения из равномерного распределения.
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, float32, float64, int32, или int64. |
seed |
Целое число Python. Используется в сочетании с tf.random.set_seed для создания воспроизводимой последовательности тензоров при многократном вызове. |
name |
Имя операции (необязательно). |
| Возвращаемое значение | |
|---|---|
| Тензор заданной формы, заполненный случайными равномерными значениями. |
| Исключения | |
|---|---|
ValueError |
Если dtype целочисленный и 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/uniform