numpy.unpackbits

numpy.unpackbits(a, /, axis=None, count=None, bitorder='big')

将 uint8 数组的元素解包为二进制值的输出数组.

a 的每个元素代表一个位域,该位域应解包到二进制值的输出数组中.输出数组的形状可以是 1-D(如果 axis 为 None ),也可以与输入数组的形状相同,并沿着指定的轴完成解包.

参数:

andarray,uint8 类型

输入数组.

轴int, optional

进行位解包的维度. None 表示解包展平的数组.

countint 或 None,可选

沿着 axis 解包的元素数量,作为撤消打包大小(不是 8 的倍数)的效果的一种方式.非负数表示仅解包 count 位.负数表示从末尾修剪掉那么多位. None 表示解包整个数组(默认值).大于可用位数的计数将向输出添加零填充.负数计数不得超过可用位数.

bitorder{‘big’, ‘little’}, 可选

返回的位的顺序."big"将模仿 bin(val), 3 = 0b00000011 => [0, 0, 0, 0, 0, 0, 1, 1] ,"little"将反转顺序为 [1, 1, 0, 0, 0, 0, 0, 0] .默认为"big".

返回:

unpackedndarray,uint8 类型

这些元素是二进制值(0 或 1).

参见

packbits

将二进制值数组的元素打包到 uint8 数组中的位.

示例

Try it in your browser!

>>> import numpy as np
>>> a = np.array([[2], [7], [23]], dtype=np.uint8)
>>> a
array([[ 2],
       [ 7],
       [23]], dtype=uint8)
>>> b = np.unpackbits(a, axis=1)
>>> b
array([[0, 0, 0, 0, 0, 0, 1, 0],
       [0, 0, 0, 0, 0, 1, 1, 1],
       [0, 0, 0, 1, 0, 1, 1, 1]], dtype=uint8)
>>> c = np.unpackbits(a, axis=1, count=-3)
>>> c
array([[0, 0, 0, 0, 0],
       [0, 0, 0, 0, 0],
       [0, 0, 0, 1, 0]], dtype=uint8)

>>> p = np.packbits(b, axis=0)
>>> np.unpackbits(p, axis=0)
array([[0, 0, 0, 0, 0, 0, 1, 0],
       [0, 0, 0, 0, 0, 1, 1, 1],
       [0, 0, 0, 1, 0, 1, 1, 1],
       [0, 0, 0, 0, 0, 0, 0, 0],
       [0, 0, 0, 0, 0, 0, 0, 0],
       [0, 0, 0, 0, 0, 0, 0, 0],
       [0, 0, 0, 0, 0, 0, 0, 0],
       [0, 0, 0, 0, 0, 0, 0, 0]], dtype=uint8)
>>> np.array_equal(b, np.unpackbits(p, axis=0, count=b.shape[0]))
True

Go BackOpen In Tab