Skip to main content
`Ctrl`+`K`

# numpy.matlib.empty

matlib.empty(shape, dtype=None, order='C')

  Return a new matrix of given shape and type, without initializing entries.

  Parameters:
    shape int or tuple of int

      Shape of the empty matrix.

    dtype data-type, optional

      Desired output data-type.

    order{‘C’, ‘F’}, optional

      Whether to store multi-dimensional data in row-major (C-style) or column-major (Fortran-style) order in memory.

  See also

  `numpy.empty`

    Equivalent array function.

  `matlib.zeros`

    Return a matrix of zeros.

  `matlib.ones`

    Return a matrix of ones.

  Notes

  Unlike other matrix creation functions (e.g. `matlib.zeros`, `matlib.ones`), `matlib.empty` does not initialize the values of the matrix, and may therefore be marginally faster. However, the values stored in the newly allocated matrix are arbitrary. For reproducible behavior, be sure to set each element of the matrix before reading.

  Examples

      >>> import numpy.matlib
      >>> np.matlib.empty((2, 2))    # filled with random data
      matrix([[  6.76425276e-320,   9.79033856e-307], # random
              [  7.39337286e-309,   3.22135945e-309]])
      >>> np.matlib.empty((2, 2), dtype=int)
      matrix([[ 6600475,        0], # random
              [ 6586976, 22740995]])