torch.clamp

torch.clamp(input, min=None, max=None, *, out=None) → Tensor

Ограничивает все элементы в input диапазоном [ min, max ]. Если min_value и max_value — это, соответственно, min и max, функция возвращает:

$$y_i = \min(\max(x_i, \text{min\_value}_i), \text{max\_value}_i)$$

Если min равен None, нижняя граница отсутствует. Если же max равен None, верхняя граница отсутствует.

Примечание

Если min больше, чем max, torch.clamp(..., min, max) устанавливает для всех элементов в input значение max.

Параметры:

• input (Tensor) – входной тензор.
• min (Number or Tensor, optional) – нижняя граница диапазона, до которой выполняется ограничение
• max (Number or Tensor, optional) – верхняя граница диапазона, до которой выполняется ограничение

Ключевые аргументы:

out (Tensor, optional) – выходной тензор.

Пример:

>>> a = torch.randn(4)
>>> a
tensor([-1.7120,  0.1734, -0.0478, -0.0922])
>>> torch.clamp(a, min=-0.5, max=0.5)
tensor([-0.5000,  0.1734, -0.0478, -0.0922])

>>> min = torch.linspace(-1, 1, steps=4)
>>> torch.clamp(a, min=min)
tensor([-1.0000,  0.1734,  0.3333,  1.0000])