torch.heaviside

torch.heaviside(input, values, *, out=None) → Tensor

計算 input 中每個元素的 Heaviside 階躍函數。Heaviside 階躍函數定義為

$$\text{{heaviside}}(input, values) = \begin{cases} 0, & \text{if input < 0}\\ values, & \text{if input == 0}\\ 1, & \text{if input > 0} \end{cases}$$

參數

• input (Tensor) – 輸入張量。

• values (Tensor) – 當 input 為零時使用的值。

關鍵字參數

out (Tensor, optional) – 輸出張量（可選）。

範例

>>> input = torch.tensor([-1.5, 0, 2.0])
>>> values = torch.tensor([0.5])
>>> torch.heaviside(input, values)
tensor([0.0000, 0.5000, 1.0000])
>>> values = torch.tensor([1.2, -2.0, 3.5])
>>> torch.heaviside(input, values)
tensor([0., -2., 1.])