mindspore.ops.tril_indices

mindspore.ops.tril_indices(row, col, offset=0, *, dtype=mstype.int64)[源代码]

计算 row * col 行列矩阵的下三角元素的索引，并将它们作为一个 2xN 的Tensor返回。张量的第一行包含行坐标，第二行包含列坐标。坐标按行排序，然后按列排序。

矩阵的下三角部分包括对角线及其以下的所有元素。

说明

在CUDA上运行的时候， row * col 必须小于2^59以防止计算时溢出。

参数：

  • row (int) - 2-D 矩阵的行数。

  • col (int) - 2-D 矩阵的列数。

  • offset (int, 可选) - 对角线偏移量。默认值：0。

关键字参数：

  • dtype (mindspore.dtype, 可选) - 指定输出Tensor数据类型，支持的数据类型为 mstype.int32 和 mstype.int64 ，默认值： mstype.int64 。

返回：

  • y (Tensor) - 矩阵的下三角形部分的索引。数据类型由 dtype 指定，shape为 \((2, tril\_size)\) ，其中， \(tril\_size\) 为下三角矩阵的元素总数。

异常：

  • TypeError - 如果 row 、 col 或 offset 不是int。

  • TypeError - 如果 dtype 的类型不是int32或int64。

  • ValueError - 如果 row 或者 col 小于零。

支持平台：

Ascend GPU CPU

样例：

>>> output = ops.tril_indices(4, 3, -1, mindspore.int64)
>>> print(output)
[[1 2 2 3 3 3]
 [0 0 1 0 1 2]]
>>> print(output.dtype)
Int64