NumPy | tril Method
Start your free 7-days trial now!
Numpy's tril(~)
method returns the lower triangle of a matrix as a new Numpy array.
Parameters
1. a
| array_like
The array from which to extract the lower triangle.
2. k
link | integer
| optional
The number of diagonals to exclude or include.
A negative value for k
represents exclusion. k=-1
means that the main diagonal is excluded. k=-2
means that the main diagonal and the diagonal on top are excluded.
A positive value for k
represents inclusion. k=1
means that we include an additional diagonal below the main diagonal.
By default, k=0
, which means that a perfect lower triangle is returned.
Return value
A new Numpy array containing the upper triangle of the provided input array.
Like almost all arrays returned Numpy's methods, the returned array of tril(~)
is copied, that is, modifying this returned array will not have an impact on the original input array - the original input array is left intact.
Examples
Basic usage
To get the lower triangle as a new Numpy array:
x = np.array([[1, 2, 3], [4 ,5, 6], [7, 8, 9]])np.tril(x)
array([[1, 0, 0], [4, 5, 0], [7, 8, 9]])
Specifying a negative k
To exclude the main diagonal, set k=-1
:
x = np.array([[1, 2, 3], [4 ,5, 6], [7, 8, 9]])np.tril(x, k=-1)
array([[0, 0, 0], [4, 0, 0], [7, 8, 0]])
To exclude the next diagonal as well, set k=-2
:
x = np.array([[1, 2, 3], [4 ,5, 6], [7, 8, 9]])np.tril(x, k=-2)
array([[0, 0, 0], [0, 0, 0], [7, 0, 0]])
Specifying a positive k
To include an additional diagonal, set k=1
:
x = np.array([[1, 2, 3], [4 ,5, 6], [7, 8, 9]])np.tril(x, k=1)
array([[1, 2, 0], [4, 5, 6], [7, 8, 9]])