tf.random.gamma
| Просмотреть исходный код на GitHub |
Генерирует shape выборок из каждого заданного гамма-распределения.
tf.random.gamma(
shape, alpha, beta=None, dtype=tf.dtypes.float32, seed=None, name=None
)
alpha — параметр формы, описывающий распределение(я), а beta — обратный параметр масштаба(ов).
Примечание: Поскольку внутренние вычисления выполняются с использованием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.gamma([10], [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.gamma([7, 5], [0.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.gamma([30], alpha=alpha, beta=beta) # samples has shape [30, 3, 2], with 30 samples each of 3x2 distributions. loss = tf.reduce_mean(tf.square(samples)) dloss_dalpha, dloss_dbeta = tf.gradients(loss, [alpha, beta]) # unbiased stochastic derivatives of the loss function alpha.shape == dloss_dalpha.shape # True beta.shape == dloss_dbeta.shape # True
| Аргументы | |
|---|---|
shape | Целочисленный тензор 1-й размерности или массив Python. Форма выходных выборок, которые должны быть сгенерированы для каждого распределения, заданного параметрами alpha/beta. |
alpha | Тензор или значение Python или N-мерный массив типа dtype. alpha предоставляет параметр(ы) формы, описывающие гамма-распределения(я), для выборки. Должен быть совместим по правилам трансляции с beta. |
beta | Тензор или значение Python или N-мерный массив типа dtype. По умолчанию 1. beta предоставляет обратный(ие) параметр(ы) масштаба гамма-распределения(ий), для выборки. Должен быть совместим по правилам трансляции с alpha. |
dtype | Тип alpha, beta и выходных данных: float16, float32, или float64. |
seed | Целое число Python. Используется для создания случайного начального значения для распределений. См. tf.random.set_seed для поведения. |
name | Необязательное имя для операции. |
| Возвращаемые значения | |
|---|---|
samples | тензор Tensor формы tf.concat([shape, tf.shape(alpha + beta)], axis=0) со значениями типа dtype. |
Ссылки:
Неявные градиенты перепараметризации: Figurnov et al., 2018 (pdf)
© 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/gamma