NumPy参考 >例行程序 >Mathematical functions > numpy.log1p
numpy.log1p（X，/，出=无，*，其中=真，铸造= 'same_kind' ，为了= 'K' ，D型细胞=无，subok =真[，签名，extobj ] ）= <ufunc 'log1p'> ¶返回元素加一个输入数组的自然对数。
计算。log(1 + x)
输入值。
结果存储的位置。如果提供，它必须具有输入广播到的形状。如果未提供或没有，则返回一个新分配的数组。元组（只能作为关键字参数）的长度必须等于输出的数量。
此条件通过输入广播。在条件为True的位置，将out数组设置为ufunc结果。在其他地方，out数组将保留其原始值。请注意，如果通过default创建未初始化的out数组out=None，则条件为False的数组中的
位置将保持未初始化。
有关其他仅关键字的参数，请参见 ufunc docs。
1 + x的自然对数，逐元素。如果x是标量，则这是标量。
笔记
对于实值输入，log1p对于x如此小以至于浮点精度为1 + x == 1的精度也是正确的。
对数是一个多值函数：每个x都有无限多个z，使得exp（z）= 1 + x。约定是返回虚部在[-pi，pi]中的z。
对于实值输入数据类型，log1p始终返回实输出。对于每个不能表示为实数或无穷大的值，它将产生nan并设置无效的浮点错误标志。
对于复数值输入，log1p是一个复杂的分析函数，具有分支剪切[-inf，-1]并从上方连续。
log1p将浮点负零作为无穷负数处理，符合C99标准。
参考文献
M. Abramowitz和IA Stegun，“数学函数手册”，第10版，1964年，第67页。http://www.math.sfu.ca/~cbm/aands/
维基百科，“对数”。https://zh.wikipedia.org/wiki/对数
例子
>>> np.log1p(1e-99)
1e-99
>>> np.log(1 + 1e-99)
0.0