numpy.log1p

numpy.log1p(x, *ufunc_args) = <ufunc 'log1p'>

Функция log1p() вычисляет log(x+1) для всех x входного массива (Натуральный логарифм от x + 1).

Параметры:
x - массив или подобный массиву объект
Входной массив.
*ufunc_args - аргументы универсальной функции
Аргументы, позволяющие настроить и оптимизировать работу функции (подробнее см. универсальные функции).
Возвращает:
результат - массив NumPy или вещественное число
Массив вычисленных значений натурального логарифма от x + 1 для всех элементов входного массива или число, если на вход подано одно число.

Замечание

Функция numpy.log1p(x) для малых значений x вычисляется намного точнее чем numpy.log(x + 1).

Аргументами numpy.log1p() могут быть как вещественные так и комплексные числа. Для комплексных чисел данный логарифм возвращается таким, что его мнимая часть находится в интервале [-pi, pi].


Смотрите так же: expm1, log, log1p, log10,
Логарифм - https://ru.wikipedia.org/wiki/Логарифм
Комплексный логарифм - https://ru.wikipedia.org/wiki/Метод_трапеций


Примеры

Точное значение натурального логарифма от 1 + 7e-11 приблизительно равно 6.9999999997550000000114333333327330833333669473333313e-11. Следующий пример демонстрирует преимущество np.log1p(x) над np.log(x + 1) для малых значений:

>>> import numpy as np
>>> 
>>> np.log1p(7e-11)
6.999999999755e-11
>>> 
>>> np.log(7e-11 + 1)
7.000000578937596e-11