dpnp.angle

dpnp.angle(z, deg=False)[source]

Return the angle of the complex argument.

For full documentation refer to numpy.angle.

Parameters:

x ({dpnp.ndarray, usm_ndarray}) – Input array, expected to have a complex-valued floating-point data type.
deg (bool, optional) – Return angle in degrees if True, radians if False (default).

Returns:

out – The counterclockwise angle from the positive real axis on the complex plane in the range (-pi, pi]. The returned array has a floating-point data type determined by the Type Promotion Rules.

Return type:

dpnp.ndarray

Notes

Although the angle of the complex number 0 is undefined, dpnp.angle(0) returns the value 0.

See also

dpnp.arctan2: Element-wise arc tangent of x1/x2 choosing the quadrant correctly.
dpnp.arctan: Trigonometric inverse tangent, element-wise.
dpnp.absolute: Calculate the absolute value element-wise.

Examples

>>> import dpnp as np
>>> a = np.array([1.0, 1.0j, 1+1j])
>>> np.angle(a) # in radians
array([0.        , 1.57079633, 0.78539816]) # may vary

>>> np.angle(a, deg=True) # in degrees
array([ 0., 90., 45.])