快捷方式

torch.unique_consecutive

torch.unique_consecutive(*args, **kwargs)

消除每个连续等效元素组中除第一个元素之外的所有元素。

注意

此函数与 torch.unique() 不同,因为它只消除连续的重复值。此语义类似于 C++ 中的 std::unique

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

  • return_inverse (bool) – 是否也返回原始输入中元素在返回的唯一列表中的最终位置的索引。

  • return_counts (bool) – 是否也返回每个唯一元素的计数。

  • dim (int) – 应用唯一性的维度。如果为 None,则返回扁平化输入的唯一性。默认值:None

返回值

包含以下内容的张量或张量元组:

  • output (Tensor): 唯一标量元素的输出列表。

  • inverse_indices (Tensor): (可选) 如果 return_inverse 为 True,则将返回另一个张量(与输入形状相同),表示原始输入中的元素在输出中的映射索引;否则,此函数将只返回一个张量。

  • counts (Tensor): (可选) 如果 return_counts 为 True,则将返回另一个张量(与输出形状相同或输出.size(dim),如果指定了 dim),表示每个唯一值或张量的出现次数。

返回值类型

(Tensor, Tensor (可选), Tensor (可选))

示例

>>> x = torch.tensor([1, 1, 2, 2, 3, 1, 1, 2])
>>> output = torch.unique_consecutive(x)
>>> output
tensor([1, 2, 3, 1, 2])

>>> output, inverse_indices = torch.unique_consecutive(x, return_inverse=True)
>>> output
tensor([1, 2, 3, 1, 2])
>>> inverse_indices
tensor([0, 0, 1, 1, 2, 3, 3, 4])

>>> output, counts = torch.unique_consecutive(x, return_counts=True)
>>> output
tensor([1, 2, 3, 1, 2])
>>> counts
tensor([2, 2, 1, 2, 1])

文档

访问 PyTorch 的全面开发者文档

查看文档

教程

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

查看教程

资源

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

查看资源