# tensorplay.functional.addcmul

Source: https://www.tensorplay.cn/docs/generated/tensorplay.functional.addcmul.html

```python
tensorplay.functional.addcmul(input, tensor1, tensor2, *, value=1, out=None) → Tensor
```

Performs the element-wise multiplication of tensor1
by tensor2, multiplies the result by the scalar value
and adds it to input.

$$\text{out}_i = \text{input}_i + \text{value} \times \text{tensor1}_i \times \text{tensor2}_i$$

The shapes of tensor, tensor1, and tensor2 must be
[broadcastable](/docs/notes/broadcasting.html#broadcasting-semantics).

For inputs of type FloatTensor or DoubleTensor, value must be
a real number, otherwise an integer.

Parameters:

- input ([Tensor](/docs/generated/tensorplay.Tensor.html#tensorplay.Tensor)) – the tensor to be added

- tensor1 ([Tensor](/docs/generated/tensorplay.Tensor.html#tensorplay.Tensor)) – the tensor to be multiplied

- tensor2 ([Tensor](/docs/generated/tensorplay.Tensor.html#tensorplay.Tensor)) – the tensor to be multiplied

Keyword Arguments:

- value (Number, optional) – multiplier for $tensor1 .* tensor2$

- out ([Tensor](/docs/generated/tensorplay.Tensor.html#tensorplay.Tensor), optional) – the output tensor.

Example:

```
>>> t = tensorplay.randn(1, 3)
>>> t1 = tensorplay.randn(3, 1)
>>> t2 = tensorplay.randn(1, 3)
>>> tensorplay.addcmul(t, t1, t2, value=0.1)
tensor([[-0.8635, -0.6391,  1.6174],
        [-0.7617, -0.5879,  1.7388],
        [-0.8353, -0.6249,  1.6511]])
```