dpnp.reciprocal

dpnp.reciprocal(x, /, out=None, *, order='K', where=True, dtype=None, subok=True, **kwargs)[source]

Return the reciprocal of the argument, element-wise.

For full documentation refer to numpy.reciprocal.

Parameters:

  • x ({dpnp.ndarray, usm_ndarray}) – Input array.

  • out ({None, dpnp.ndarray, usm_ndarray}, optional) – Output array to populate. Array must have the correct shape and the expected data type.

  • order ({"C", "F", "A", "K"}, optional) – Memory layout of the newly output array, if parameter out is None. Default: “K”.

Returns:

out – An array containing the element-wise reciprocals.

Return type:

dpnp.ndarray

Notes

If x has a integral data type, the output will have the default real-valued floating-point data type for the device where input array x is allocated. If x has a floating-point data type, the output will have the same data type.

Limitations

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.

See also

dpnp.rsqrt

Return the reciprocal square-root of an array, element-wise.

Examples

>>> import dpnp as np
>>> x = np.array([1, 2., 3.33])
>>> np.reciprocal(x)
array([1.0, 0.5, 0.3003003])