torch.aminmax

torch.aminmax(input, *, dim=None, keepdim=False, out=None) -> (Tensor min, Tensor max)

计算 input 张量的最小值和最大值。

参数

input (Tensor) – 输入张量

关键字参数

• dim (Optional[int]) – 计算值所在的维度。如果为 None，则计算整个 input 张量的值。默认值为 None。

• keepdim (bool) – 如果为 True，则降维后的维度将作为大小为 1 的维度保留在输出张量中以进行广播；否则，它们将被移除，就像调用了 (torch.squeeze()) 一样。默认值为 False。

• out (Optional[Tuple[Tensor, Tensor]]) – 可选的张量，用于写入结果。必须与预期的输出具有相同的形状和数据类型 (dtype)。默认值为 None。

返回

一个命名元组 (min, max)，包含最小值和最大值。

抛出

RuntimeError – 如果任何要计算值的维度大小为 0。

注意

如果至少有一个值为 NaN，则 NaN 值会传播到输出。

另请参阅

torch.amin() 仅计算最小值 torch.amax() 仅计算最大值

示例

>>> torch.aminmax(torch.tensor([1, -3, 5]))
torch.return_types.aminmax(
min=tensor(-3),
max=tensor(5))

>>> # aminmax propagates NaNs
>>> torch.aminmax(torch.tensor([1, -3, 5, torch.nan]))
torch.return_types.aminmax(
min=tensor(nan),
max=tensor(nan))

>>> t = torch.arange(10).view(2, 5)
>>> t
tensor([[0, 1, 2, 3, 4],
        [5, 6, 7, 8, 9]])
>>> t.aminmax(dim=0, keepdim=True)
torch.return_types.aminmax(
min=tensor([[0, 1, 2, 3, 4]]),
max=tensor([[5, 6, 7, 8, 9]]))