dpnp.add

dpnp.add(x1, x2, /, out=None, *, where=True, order='K', dtype=None, subok=True, **kwargs)[source]

Add arguments element-wise.

For full documentation refer to numpy.add.

Returns:: out – The sum of x1 and x2, element-wise.
Return type:: dpnp.ndarray

Limitations

Parameters x1 and x2 are supported as either scalar, dpnp.ndarray or dpctl.tensor.usm_ndarray, but both x1 and x2 can not be scalars at the same time. Parameters where, dtype and subok are supported with their default values. Keyword argument kwargs is currently unsupported. Otherwise the function will be executed sequentially on CPU. Input array data types are limited by supported DPNP Data types.

Notes

Equivalent to x1 + x2 in terms of array broadcasting.

Examples

>>> import dpnp as np
>>> a = np.array([1, 2, 3])
>>> b = np.array([1, 2, 3])
>>> np.add(a, b)
array([2, 4, 6])

>>> x1 = np.arange(9.0).reshape((3, 3))
>>> x2 = np.arange(3.0)
>>> np.add(x1, x2)
array([[  0.,   2.,   4.],
    [  3.,   5.,   7.],
    [  6.,   8.,  10.]])

The + operator can be used as a shorthand for add on dpnp.ndarray.

>>> x1 + x2
array([[  0.,   2.,   4.],
    [  3.,   5.,   7.],
    [  6.,   8.,  10.]])