mindspore.Tensor.tril

mindspore.Tensor.tril(diagonal=0)

返回输入Tensor的下三角形部分(包含对角线和下面的元素)，并将其他元素设置为0。

参数：

diagonal (int，可选) - 指定对角线位置，默认值：0 ，指定主对角线。

返回：

Tensor。其数据类型和shape维度与输入相同。

异常：

TypeError - 如果 diagonal 不是int。
TypeError - 如果输入Tensor的数据类型既不是number也不是bool。
ValueError - 如果输入Tensor的秩小于2。

支持平台：

Ascend GPU CPU

样例：

>>> import numpy as np
>>> from mindspore import Tensor
>>> x = Tensor(np.array([[ 1,  2,  3,  4],
...                      [ 5,  6,  7,  8],
...                      [10, 11, 12, 13],
...                      [14, 15, 16, 17]]))
>>> result = Tensor.tril(x)
>>> print(result)
[[ 1  0  0  0]
 [ 5  6  0  0]
 [10 11 12  0]
 [14 15 16 17]]
>>> x = Tensor(np.array([[ 1,  2,  3,  4],
...                      [ 5,  6,  7,  8],
...                      [10, 11, 12, 13],
...                      [14, 15, 16, 17]]))
>>> result = Tensor.tril(x, diagonal=1)
>>> print(result)
[[ 1  2  0  0]
 [ 5  6  7  0]  
 [10 11 12 13]
 [14 15 16 17]]
>>> x = Tensor(np.array([[ 1,  2,  3,  4],
...                      [ 5,  6,  7,  8],
...                      [10, 11, 12, 13],
...                      [14, 15, 16, 17]]))
>>> result = Tensor.tril(x, diagonal=-1)
>>> print(result)
[[ 0  0  0  0]
 [ 5  0  0  0]
 [10 11  0  0]
 [14 15 16  0]]