torch.topk

torch.topk(input, k, dim=None, largest=True, sorted=True, *, out=None)

返回给定input张量沿指定维度的前k个最大元素。

如果未给出dim，则选择输入的最后一个维度。

如果 largest 是 False，则返回最小的 k 个元素。

返回一个包含(values, indices)的namedtuple，其中values和indices分别是input张量在给定维度dim下每行的最大k个元素的值和索引。

布尔选项 sorted 如果 True，将确保返回的 k 元素本身是有序的

Parameters

• 输入 (张量) – 输入张量。

• k (int) – “top-k”中的k

• dim (int, 可选) – 要排序的维度

• 最大值 (bool, 可选) – 控制是否返回最大或最小元素

• sorted (bool, optional) – 控制是否返回排序后的元素

Keyword Arguments

out (元组, 可选) – 可以可选地提供用于用作输出缓冲区的 (Tensor, LongTensor) 的输出元组

示例：

>>> x = torch.arange(1., 6.)
>>> x
tensor([ 1.,  2.,  3.,  4.,  5.])
>>> torch.topk(x, 3)
torch.return_types.topk(values=tensor([5., 4., 3.]), indices=tensor([4, 3, 2]))