mars.tensor.ldexp#

mars.tensor.ldexp(x1, x2, out=None, where=None, **kwargs)[来源]#

逐元素返回 x1 * 2**x2。

尾数 x1 和二的指数 x2 被用来构造浮点数 x1 * 2**x2。

Parameters

  • x1 (array_like) – 乘数的张量。

  • x2 (array_like, int) – 二的指数的张量。

  • out (Tensor, None, 或 tuple 的 Tensor 和 None, 可选) – 结果存储的位置。如果提供，它必须具有和输入相同的广播形状。如果未提供或None，将返回一个新分配的张量。元组（仅作为关键字参数可能）必须具有与输出数量相等的长度。

  • where (array_like, 可选) – 值为 True 表示在该位置计算 ufunc，值为 False 表示保持输出中的该值不变。

  • **kwargs –

Returns

y – x1 * 2**x2 的结果。

Return type

张量或标量

另请参阅

frexp

从 x = y1 * 2**y2 返回 (y1, y2)，与 ldexp 相反。

备注

不支持复杂数据类型，它们将引发类型错误。

ldexp作为frexp的逆运算非常有用，如果单独使用，直接使用表达式x1 * 2**x2更加清晰。

示例

>>> import mars.tensor as mt

>>> mt.ldexp(5, mt.arange(4)).execute()
array([  5.,  10.,  20.,  40.], dtype=float32)

>>> x = mt.arange(6)
>>> mt.ldexp(*mt.frexp(x)).execute()
array([ 0.,  1.,  2.,  3.,  4.,  5.])