torch.mode

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

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

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

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

注意

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

参数

• input (Tensor) – 输入张量。

• dim (int, optional) – 要约简的维度。

• keepdim (bool, optional) – 输出张量是否保留 dim。默认为 False。

关键字参数

out (tuple, optional) – 包含两个输出张量（values, indices）的结果元组。

示例

>>> 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]))