mars.tensor.log#

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

自然对数，逐元素。

自然对数 log 是指数函数的反函数，因此 log(exp(x)) = x。自然对数是以 e 为底的对数。

Parameters

  • x (array_like) – 输入值。

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

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

  • **kwargs –

Returns

y – x 的自然对数，逐元素计算。

Return type

张量

另请参阅

log10, log2, log1p

备注

对数是一个多值函数：对于每个 x，都有无限个 z 使得 exp(z) = x。约定是返回其虚部在 [-pi, pi] 范围内的 z。

对于实值输入数据类型， log 总是返回实数输出。对于每个无法表示为实数或无限的值，它返回 nan 并设置 invalid 浮点错误标志。

对于复数值输入，log 是一个复分析函数，其有一个支路切割 [-inf, 0]，并且在其上是从上方连续的。log 将浮点负零视为一个无限小的负数，符合C99标准。

参考文献

1

M. Abramowitz 和 I.A. Stegun，《数学函数手册》， 第10次印刷，1964，第67页。 http://www.math.sfu.ca/~cbm/aands/

2

维基百科，“对数”。 http://en.wikipedia.org/wiki/Logarithm

示例

>>> import mars.tensor as mt

>>> mt.log([1, mt.e, mt.e**2, 0]).execute()
array([  0.,   1.,   2., -Inf])