### Navigation

- index
- modules |
- modules |
- next |
- previous |
- NumPy v1.5 Manual (DRAFT) »
- NumPy Reference »
- Routines »
- Binary operations »

# numpy.packbits

`numpy.``packbits`(myarray, axis=None)

  Packs the elements of a binary-valued array into bits in a uint8 array.

  The result is padded to full bytes by inserting zero bits at the end.

  Parameters : | myarray : array_like An integer type array whose elements should be packed to bits. axis : int, optional The dimension over which bit-packing is done. `None` implies packing the flattened array.
  Returns : | packed : ndarray Array of type uint8 whose elements represent bits corresponding to the logical (0 or nonzero) value of the input elements. The shape of packed has the same number of dimensions as the input (unless axis is None, in which case the output is 1-D).

  See also

  `unpackbits`
    Unpacks elements of a uint8 array into a binary-valued output array.

  Examples

      >>> a = np.array([[[1,0,1],
      ...                [0,1,0]],
      ...               [[1,1,0],
      ...                [0,0,1]]])
      >>> b = np.packbits(a, axis=-1)
      >>> b
      array([[[160],[64]],[[192],[32]]], dtype=uint8)

  Note that in binary 160 = 1010 0000, 64 = 0100 0000, 192 = 1100 0000, and 32 = 0010 0000.

### Navigation

- index
- modules |
- modules |
- next |
- previous |
- NumPy v1.5 Manual (DRAFT) »
- NumPy Reference »
- Routines »
- Binary operations »