快捷方式

torch.topk

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

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

如果未提供 dim,则选择 input 的最后一个维度。

如果 largestFalse,则返回前 k 个最小元素。

返回一个名为元组的 (values, indices),其中包含 input 张量在给定维度 dim 上每行的前 k 个最大元素的 valuesindices

如果布尔选项 sortedTrue,则确保返回的 k 个元素本身已排序

参数
  • input (Tensor) – 输入张量。

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

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

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

  • sorted (bool, 可选) – 控制是否按排序顺序返回元素

关键字参数

out (tuple, 可选) – (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]))

文档

访问 PyTorch 的全面开发者文档

查看文档

教程

获取针对初学者和高级开发者的深入教程

查看教程

资源

查找开发资源并获得问题的解答

查看资源