numpy.log1p

原文:https://docs.scipy.org/doc/numpy/reference/generated/numpy.log1p.html

译者:飞龙 UsyiyiCN

校对:(虚位以待)

numpy.log1p(x[, out]) = <ufunc 'log1p'>

返回一个加自然对数的输入数组,元素。

Calculates log(1 + x).

参数:

x:array_like

输入值。

返回:

y:ndarray

1 + x的自然对数,逐元素。

也可以看看

expm1
exp(x) - 1, the inverse of log1p.

笔记

对于实值输入,log1p对于小于在浮点精度中1 + x == 1x也是准确的。

对数是多值函数:对于每个x,存在无穷多的z,使得exp(z)= 1 + x约定是返回其虚部在[ - pi,pi]中的z

对于实值输入数据类型,log1p始终返回实际输出。对于不能表示为实数或无穷大的每个值,它会产生nan并设置无效浮点错误标志。

对于复值输入,log1p是具有分支切口[ - inf,-1]的复杂分析函数,并且从上面是连续的。log1p将浮点负零作为无穷小负数处理,符合C99标准。

参考文献

[R48]Abramowitz和I.A.Stegun,“Handbook of Mathematical Functions”,10th printing,1964,pp。67. http://www.math.sfu.ca/~cbm/aands/
[R49]维基百科,“对数”。http://en.wikipedia.org/wiki/Logarithm

例子

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