numpy.log

numpy.log(x, /, out=None, *, where=True, casting='same_kind', order='K', dtype=None, subok=True[, signature])=<ufunc 'log'>

Натуральный логарифм, поэлементно.

Натуральный логарифм log — это обратная функция экспоненты, так что log(exp(x)) = x. Натуральный логарифм — это логарифм по основанию e.

Параметры:

xarray_like

Входное значение.

outndarray, None, или кортеж ndarray и None, необязательно

Расположение, в которое сохраняется результат. Если указано, оно должно иметь форму, к которой векторизуются входные данные. Если не указано или равно None, возвращается только что выделенный массив. Кортеж (только в качестве ключевого аргумента) должен иметь длину, равную числу результатов.

wherearray_like, необязательно

Это условие векторизуется по входу. В местах, где условие равно True, массив out будет установлен в результат ufunc. В противном случае массив out сохранит своё исходное значение. Обратите внимание, что если массив out создается по умолчанию через out=None, места в нём, где условие False, останутся неинициализированными.

**kwargs

Для других ключевых аргументов см. документацию ufunc.

Возвращаемое значение:

yndarray

Натуральный логарифм x, поэлементно. Это скаляр, если x является скаляром.

См. также

log10, log2, log1p, emath.log

Примечания

Логарифм — многозначная функция: для каждого x существует бесконечное количество z таких, что exp(z) = x. Принято возвращать z, мнимая часть которого лежит в (-pi, pi].

Для вещественных типов данных входных данных log всегда возвращает вещественный результат. Для каждого значения, которое нельзя представить как вещественное число или бесконечность, возвращается nan и устанавливается флаг ошибки с плавающей точкой invalid.

Для комплексных значений ввода log является комплексной аналитической функцией, которая имеет разрыв ветви [-inf, 0] и непрерывна сверху на нём. log обрабатывает плавающее нулевое значение как бесконечно малое отрицательное число, в соответствии со стандартом C99.

В тех случаях, когда вход имеет отрицательную вещественную часть и очень маленькую отрицательную комплексную часть (стремящуюся к 0), результат настолько близок к -pi, что оценивается как точно -pi.

Ссылки

[1]

M. Abramowitz и I.A. Stegun, «Справочник по математическим функциям», 10-е издание, 1964, стр. 67. https://personal.math.ubc.ca/~cbm/aands/page_67.htm

[2]

Википедия, «Логарифм». https://en.wikipedia.org/wiki/Logarithm

Примеры

>>> np.log([1, np.e, np.e**2, 0])
array([  0.,   1.,   2., -inf])