tf.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