forked from mindspore-Ecosystem/mindspore
24 lines
1.4 KiB
ReStructuredText
24 lines
1.4 KiB
ReStructuredText
mindspore.ops.NthElement
|
||
========================
|
||
|
||
.. py:class:: mindspore.ops.NthElement(reverse=False)
|
||
|
||
寻找并返回输入Tensor最后一维第 :math:`n` 小的值。
|
||
如果输入是1-D Tensor(即Vector)，则找到Vector中第n小的值并将其输出为标量Tensor。
|
||
对于矩阵或更高维度的输入，分别计算每行中的第n小的值（或沿着最后一个维度的Vector），并输出这些值。因此，返回值 `values` 的shape满足 `values`.shape = `input`.shape[:-1]。
|
||
|
||
参数：
|
||
- **reverse** (bool，可选) - 可选参数，如果设为True，则寻找第 :math:`n` 大的值，如果设为False，则寻找第n小的值。默认值：False。
|
||
|
||
输入：
|
||
- **input** (Tensor) - 一维或者更高维度的Tensor，最后一维的大小必须大于等于 :math:`n+1` 。
|
||
- **n** (Union[int, Tensor]) - 如果 :math:`n` 为Tensor，则必须是零维的，数据类型是int32。 :math:`n` 的有效范围是：:math:`[0, input.shape[-1])` 。
|
||
|
||
输出：
|
||
- **values** (Tensor) - 其shape满足： `values`.shape = `input`.shape[:-1]，数据类型与 `input` 一致。
|
||
|
||
异常：
|
||
- **TypeError** - `input` 的数据类型不在有效类型列表内。
|
||
- **TypeError** - `n` 不是int32或者Tensor。
|
||
- **ValueError** - `n` 不在 :math:`[0, input.shape[-1])` 范围内。
|