torch.addr

torch.addr(input, vec1, vec2, *, beta=1, alpha=1, out=None) → Tensor

計算向量 vec1 和 vec2 的外積，並將其加到矩陣 input。

可選參數 beta 和 alpha 分別是 vec1 和 vec2 外積以及所加矩陣 input 的縮放因子。

$$\text{out} = \beta\ \text{input} + \alpha\ (\text{vec1} \otimes \text{vec2})$$

如果 beta 為 0，則會忽略 input，並且其中的 nan 和 inf 不會傳播。

如果 vec1 是一個大小為 n 的向量，而 vec2 是一個大小為 m 的向量，則 input 必須與大小為 $(n \times m)$ 的矩陣 可廣播 (broadcastable)，並且 out 將是一個大小為 $(n \times m)$ 的矩陣。

參數

• input (Tensor) – 要加入的矩陣

• vec1 (Tensor) – 外積的第一個向量

• vec2 (Tensor) – 外積的第二個向量

關鍵字參數

• beta (Number, optional) – input 的乘數 ($\beta$)

• alpha (Number, optional) – $\text{vec1} \otimes \text{vec2}$ 的乘數 ($\alpha$)

• out (Tensor, optional) – 輸出張量。

範例

>>> vec1 = torch.arange(1., 4.)
>>> vec2 = torch.arange(1., 3.)
>>> M = torch.zeros(3, 2)
>>> torch.addr(M, vec1, vec2)
tensor([[ 1.,  2.],
        [ 2.,  4.],
        [ 3.,  6.]])