numpy.matlib.empty#

matlib.empty(shape, dtype=None, order='C')[source]#

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

Parameters:
shapeint or tuple of int

Shape of the empty matrix.

dtypedata-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]])