maxframe.tensor.log1p#

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

返回输入张量加一后的自然对数，逐元素计算。

计算 log(1 + x)。

参数:

  • x (array_like) -- 输入值。

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

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

  • **kwargs

返回:

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

返回类型:

Tensor

参见

expm1

exp(x) - 1，是 log1p 的反函数。

备注

对于实数输入，log1p 对于非常小的 x`（小到在浮点精度下 `1 + x == 1）也是准确的。

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

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

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

引用

示例

>>> import maxframe.tensor as mt

>>> mt.log1p(1e-99).execute()
1e-99
>>> mt.log(1 + 1e-99).execute()
0.0