mars.tensor.expm1#

mars.tensor.expm1(x, out=None, where=None, **kwargs)[来源]#

计算 exp(x) - 1 对张量中所有元素的值。

Parameters

  • x (array_like) – 输入值。

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

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

  • **kwargs –

Returns

out – 元素级指数减去一: out = exp(x) - 1.

Return type

张量

另请参阅

log1p

log(1 + x)，expm1的反函数。

备注

该函数提供比 exp(x) - 1 对于小值 x 更高的精度。

示例

在这个例子中，exp(1e-10) - 1 的真实值是 1.00000000005e-10，约有32位有效数字。这个例子显示了expm1在这种情况下的优越性。

>>> import mars.tensor as mt

>>> mt.expm1(1e-10).execute()
1.00000000005e-10
>>> (mt.exp(1e-10) - 1).execute()
1.000000082740371e-10