numpy.matlib.eye#

matlib.eye(n, M=None, k=0, dtype=<class 'float'>, order='C')[source]#

Return a matrix with ones on the diagonal and zeros elsewhere.

Parameters:
nint

Number of rows in the output.

Mint, optional

Number of columns in the output, defaults to n.

kint, optional

Index of the diagonal: 0 refers to the main diagonal, a positive value refers to an upper diagonal, and a negative value to a lower diagonal.

dtypedtype, optional

Data-type of the returned matrix.

order{ā€˜Cā€™, ā€˜Fā€™}, optional

Whether the output should be stored in row-major (C-style) or column-major (Fortran-style) order in memory.

New in version 1.14.0.

Returns:
Imatrix

A n x M matrix where all elements are equal to zero, except for the k-th diagonal, whose values are equal to one.

See also

numpy.eye

Equivalent array function.

identity

Square identity matrix.

Examples

>>> import numpy.matlib
>>> np.matlib.eye(3, k=1, dtype=float)
matrix([[0.,  1.,  0.],
        [0.,  0.,  1.],
        [0.,  0.,  0.]])