NumPy参考 >例行程序 >Mathematical functions > numpy.log2
numpy.
log2
(X,/,出=无,*,其中=真,铸造= 'same_kind' ,为了= 'K' ,D型细胞=无,subok =真[,签名,extobj ] )= <ufunc '的log 2'> ¶x的以2为底的对数。
输入值。
结果存储的位置。如果提供,它必须具有输入广播到的形状。如果未提供或没有,则返回一个新分配的数组。元组(只能作为关键字参数)的长度必须等于输出的数量。
此条件通过输入广播。在条件为True的位置,将out数组设置为ufunc结果。在其他地方,out数组将保留其原始值。请注意,如果通过default创建未初始化的out数组out=None
,则条件为False的数组中的
位置将保持未初始化。
有关其他仅关键字的参数,请参见 ufunc docs。
x的以2为底的对数。如果x是标量,则这是标量。
笔记
1.3.0版的新功能。
对数是一个多值函数:每个x都有无限个z,使得2 ** z = x。约定是返回 虚部在[-pi,pi]中的z。
对于实值输入数据类型,log2
始终返回实输出。对于每个不能表示为实数或无穷大的值,它将产生nan
并设置无效的浮点错误标志。
对于复数值输入,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])