maxframe.tensor.log#

maxframe.tensor.log(x, out=None, where=None, **kwargs)[源代码]#

自然对数，逐元素计算。

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

参数:

  • x (array_like) -- 输入值。

  • out (Tensor, None, or tuple of tensor and None, optional) -- 用于存储结果的位置。如果提供，其形状必须与输入广播兼容。如果未提供或为 None，则返回一个新分配的 tensor。元组（只能作为关键字参数）的长度必须等于输出的数量。

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

  • **kwargs

返回:

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

返回类型:

Tensor

参见

log10, log2, log1p

备注

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

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

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

引用

示例

>>> import maxframe.tensor as mt

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