mindspore/docs/api/api_python/ops/mindspore.ops.Gamma.rst

47 lines
1.6 KiB
ReStructuredText
Raw Normal View History

2021-12-04 13:55:42 +08:00
mindspore.ops.Gamma
===================
.. py:class:: mindspore.ops.Gamma(*args, **kwargs)
根据概率密度函数分布生成随机正浮点数x。
.. math::
\text{P}(x|α,β) = \frac{\exp(-x/β)}{{β^α}\cdot{\Gamma(α)}}\cdot{x^{α-1}}
**参数:**
2021-12-04 20:36:47 +08:00
- **seed** (int) - 算子层的随机种子用于生成随机数。必须是非负的。默认值0。
2021-12-04 13:55:42 +08:00
- **seed2** (int)全局的随机种子和算子层的随机种子共同决定最终生成的随机数。必须是非负的。默认值0。
**输入:**
- **shape** (tuple) - 待生成的随机Tensor的shape。只支持常量值。
- **alpha** (Tensor) - α为Gamma分布的shape parameter主要决定了曲线的形状。其值必须大于0。数据类型为float32。
- **beta** (Tensor) - β为Gamma分布的inverse scale parameter主要决定了曲线有多陡。其值必须大于0。数据类型为float32。
**输出:**
Tensor。shape是输入 `shape` 以及alpha、beta广播后的shape。数据类型为float32。
**异常:**
- **TypeError** - `seed``seed2` 都不是int。
- **TypeError** - `alpha``beta` 都不是Tensor。
- **ValueError** - `shape` 不是常量值。
**支持平台:**
``Ascend``
**样例:**
>>> shape = (3, 1, 2)
>>> alpha = Tensor(np.array([[3, 4], [5, 6]]), mstype.float32)
>>> beta = Tensor(np.array([1.0]), mstype.float32)
>>> gamma = ops.Gamma(seed=3)
>>> output = gamma(shape, alpha, beta)
>>> result = output.shape
>>> print(result)
(3, 2, 2)