numpy.log2

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

Двоичный логарифм x.

Параметры

xarray_like

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

outndarray, None, or tuple of ndarray and None, optional

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

wherearray_like, optional

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

**kwargs

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

Возвращает

yndarray

Двоичный логарифм x. Это скаляр, если x является скаляром.

См. также

log, log10, log1p, emath.log2

Примечания

Новое в версии 1.3.0.

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

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

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

Примеры

>>> x = np.array([0, 1, 2, 2**4])
>>> np.log2(x)
array([-Inf,   0.,   1.,   4.])

>>> xi = np.array([0+1.j, 1, 2+0.j, 4.j])
>>> np.log2(xi)
array([ 0.+2.26618007j,  0.+0.j        ,  1.+0.j        ,  2.+2.26618007j])