This is a pre-release version (2.5.0.dev0+git20251130.2de293a). Go to latest (2.4.4)
{ } Raw JSON

bundles / numpy 2.5.0.dev0+git20251130.2de293a / numpy / tril

_ArrayFunctionDispatcher

numpy:tril

source: /dev/numpy/build-install/usr/lib/python3.14/site-packages/numpy/lib/_twodim_base_impl.py :454

Signature

def   tril ( m k = 0 )

Summary

Lower triangle of an array.

Extended Summary

Return a copy of an array with elements above the k-th diagonal zeroed. For arrays with ndim exceeding 2, tril will apply to the final two axes.

Parameters

m : array_like, shape (..., M, N)

Input array.

k : int, optional

Diagonal above which to zero elements. k = 0 (the default) is the main diagonal, k < 0 is below it and k > 0 is above.

Returns

tril : ndarray, shape (..., M, N)

Lower triangle of m, of same shape and data-type as m.

Examples

import numpy as np
np.tril([[1,2,3],[4,5,6],[7,8,9],[10,11,12]], -1)
np.tril(np.arange(3*4*5).reshape(3, 4, 5))

See also

triu

same thing, only for the upper triangle

Aliases

  • numpy.tril