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