numpy.log2

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

以2为底的对数 x .

参数
xarray_like

输入值。

outndarray、none或ndarray和none的元组,可选

存储结果的位置。如果提供,它必须具有输入广播到的形状。如果未提供或没有,则返回新分配的数组。元组(只能作为关键字参数)的长度必须等于输出数。

where阵列式,可选

这种情况通过输入广播。在条件为真的位置 out 数组将被设置为ufunc结果。在其他地方 out 数组将保留其原始值。请注意,如果未初始化 out 数组是通过默认值创建的 out=None ,其中条件为False的位置将保持未初始化状态。

**kwargs

有关其他仅限关键字的参数,请参见 ufunc docs .

返回
y恩达雷

以2为底的对数 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])