Spec-Zone.ru › TensorFlow

tf.random.stateless_gamma

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

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

Совместимые псевдонимы для миграции

Подробнее см. в руководстве по миграции.

tf.compat.v1.random.stateless_gamma

tf.random.stateless_gamma(
    shape,
    seed,
    alpha,
    beta=None,
    dtype=tf.dtypes.float32,
    name=None
)

Сгенерированные значения соответствуют гамма-распределению с заданными параметрами концентрации (alpha) и обратного масштаба (beta).

Это версия tf.random.gamma без состояния: при повторном запуске с теми же начальными значениями и формами она будет выдавать те же псевдослучайные числа. Результат будет одинаковым при нескольких запусках на одном оборудовании (а также на CPU и GPU), но может измениться при переходе между версиями TensorFlow или при использовании оборудования, отличного от CPU/GPU.

Интерпретация параметра shape немного различается в stateless_gamma и gamma: в gamma shape всегда добавляется в начало формы результата broadcast-операции над alpha и beta; тогда как в stateless_gamma параметр shape всегда должен охватывать формы каждого из alpha и beta (которые должны совместно подвергаться broadcast-операции, чтобы соответствовать конечным измерениям shape).

Примечание: Поскольку внутренние вычисления выполняются с использованием float64, а приведение типов имеет семантику floor, нулевые результаты необходимо вручную заменять на наименьшее возможное положительное значение с плавающей запятой, то есть np.finfo(dtype).tiny. Это означает, что np.finfo(dtype).tiny встречается чаще, чем следовало бы. Такое смещение может возникать только при малых значениях alpha, то есть alpha << 1, или больших значениях beta, то есть beta >> 1.

Выборки дифференцируемы по alpha и beta. Производные вычисляются с использованием подхода, описанного в (Figurnov et al., 2018).

Пример:

samples = tf.random.stateless_gamma([10, 2], seed=[12, 34], alpha=[0.5, 1.5])
# samples has shape [10, 2], where each slice [:, 0] and [:, 1] represents
# the samples drawn from each distribution

samples = tf.random.stateless_gamma([7, 5, 2], seed=[12, 34], alpha=[.5, 1.5])
# samples has shape [7, 5, 2], where each slice [:, :, 0] and [:, :, 1]
# represents the 7x5 samples drawn from each of the two distributions

alpha = tf.constant([[1.], [3.], [5.]])
beta = tf.constant([[3., 4.]])
samples = tf.random.stateless_gamma(
    [30, 3, 2], seed=[12, 34], alpha=alpha, beta=beta)
# samples has shape [30, 3, 2], with 30 samples each of 3x2 distributions.

with tf.GradientTape() as tape:
  tape.watch([alpha, beta])
  loss = tf.reduce_mean(tf.square(tf.random.stateless_gamma(
      [30, 3, 2], seed=[12, 34], alpha=alpha, beta=beta)))
dloss_dalpha, dloss_dbeta = tape.gradient(loss, [alpha, beta])
# unbiased stochastic derivatives of the loss function
alpha.shape == dloss_dalpha.shape  # True
beta.shape == dloss_dbeta.shape  # True
Аргументы
shape Одномерный целочисленный тензор или массив Python. Форма выходного тензора.
seed Тензор формы [2], начальное значение для генератора случайных чисел. Тип данных должен быть int32 или int64. (При использовании XLA допускается только int32.)
alpha Тензор. Параметр концентрации гамма-распределения. Должен допускать broadcast-операцию с beta, а также с крайними справа измерениями shape.
beta Тензор. Параметр обратного масштаба гамма-распределения. Должен допускать broadcast-операцию с alpha, а также с крайними справа измерениями shape.
dtype Тип данных с плавающей запятой для alpha, beta и результата.
name Имя операции (необязательно).
Возвращаемое значение
samples Тензор заданной формы, заполненный случайными значениями из гамма-распределения. Для каждого i каждый элемент `samples[..., i]` представляет собой независимую выборку из гамма-распределения с концентрацией alpha[i] и масштабом beta[i].

© 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/api_docs/python/tf/random/stateless_gamma

Spec-Zone.ru

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