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 或 Tensor, optional) – 要限制到的範圍的下限

• max (Number 或 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])