torch.mode

torch.mode(input, dim=-1, keepdim=False, *, out=None)

返回一个namedtuple (values, indices)，其中values是给定维度dim中input张量每行的众数值，即在该行中出现次数最多的值，而indices是找到的每个众数值的索引位置。

默认情况下，dim 是 input 张量的最后一个维度。

如果 keepdim 是 True，输出张量的大小与 input 相同，除了在维度 dim 上它们的大小为1。 否则，dim 被压缩（参见 torch.squeeze()），导致输出张量的维度比 input 少1。

注意

此函数尚未为 torch.cuda.Tensor 定义。

Parameters

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

• dim (int) – 要减少的维度。

• keepdim (布尔值) – 输出张量是否保留dim。

Keyword Arguments

out (元组, 可选) – 两个输出张量（值, 索引）的结果元组

示例：

>>> b = torch.tensor(
       [[0, 0, 0, 2, 0, 0, 2],
        [0, 3, 0, 0, 2, 0, 1],
        [2, 2, 2, 0, 0, 0, 3],
        [2, 2, 3, 0, 1, 1, 0],
        [1, 1, 0, 0, 2, 0, 2]])
>>> torch.mode(b, 0)
torch.return_types.mode(
values=tensor([0, 2, 0, 0, 0, 0, 2]),
indices=tensor([1, 3, 4, 4, 2, 4, 4]))