torch.take_along_dim

torch.take_along_dim(input, indices, dim=None, *, out=None) → Tensor

沿着给定的 dim，根据 indices 中的一维索引从 input 中选取值。

如果 dim 为 None，则将输入数组视为已展平为一维。

返回沿某个维度的索引的函数，例如 torch.argmax() 和 torch.argsort()，被设计为与此函数一起使用。请参见下面的示例。

注意

此函数类似于 NumPy 的 take_along_axis。另请参阅 torch.gather()。

参数

• input (Tensor) – 输入张量。

• indices (LongTensor) – input 中的索引。必须是 long 数据类型。

• dim (int, optional) – 沿哪个维度选择。默认值：0

关键字参数

out (Tensor, optional) – 输出张量。

示例

>>> t = torch.tensor([[10, 30, 20], [60, 40, 50]])
>>> max_idx = torch.argmax(t)
>>> torch.take_along_dim(t, max_idx)
tensor([60])
>>> sorted_idx = torch.argsort(t, dim=1)
>>> torch.take_along_dim(t, sorted_idx, dim=1)
tensor([[10, 20, 30],
        [40, 50, 60]])