torch.kthvalue

torch.kthvalue(input, k, dim=None, keepdim=False, *, out=None)

返回一个命名元组 (values, indices)，其中 values 是给定维度 dim 中 input 张量每行的第 k 个最小元素。而 indices 是找到的每个元素的索引位置。

如果未给定 dim，则选择 input 的最后一个维度。

如果 keepdim 为 True，则 values 和 indices 张量的大小与 input 相同，除了维度 dim 大小为 1。否则，dim 会被压缩（参见 torch.squeeze()），导致 values 和 indices 张量都比 input 张量少一个维度。

注意

当 input 是 CUDA 张量且存在多个有效的第 k 个值时，此函数可能会不确定性地返回其中任何一个的 indices。

参数

• input (Tensor) – 输入张量。

• k (int) – 第 k 个最小元素的 k 值

• dim (int, 可选) – 沿其查找第 k 个值的维度

• keepdim (bool) – 指示输出张量是否保留 dim。

关键字参数

out (tuple, 可选) – 可以选择给定输出元组 (Tensor, LongTensor) 以用作输出缓冲区

示例

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

>>> x=torch.arange(1.,7.).resize_(2,3)
>>> x
tensor([[ 1.,  2.,  3.],
        [ 4.,  5.,  6.]])
>>> torch.kthvalue(x, 2, 0, True)
torch.return_types.kthvalue(values=tensor([[4., 5., 6.]]), indices=tensor([[1, 1, 1]]))