numpy.log1p

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 == 1的x也是准确的。

对数是多值函数：对于每个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