dpnp.imag

dpnp.imag(x, out=None, where=True, order='K', dtype=None, subok=True, **kwargs)

Computes imaginary part of each element x_i for input array x.

For full documentation refer to numpy.imag.

Parameters:

  • x ({dpnp.ndarray, usm_ndarray}) -- Input array, expected to have numeric data type.

  • out ({None, dpnp.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 imaginary component of input. If the input is a real-valued data type, the returned array has the same data type. If the input is a complex floating-point data type, the returned array has a floating-point data type with the same floating-point precision as complex input.

Return type:

dpnp.ndarray

See also

dpnp.real

Return the real part of the complex argument.

dpnp.conj

Return the complex conjugate, element-wise.

dpnp.conjugate

Return the complex conjugate, element-wise.

Examples

>>> import dpnp as np
>>> a = np.array([1+2j, 3+4j, 5+6j])
>>> a.imag
array([2., 4., 6.])

>>> a.imag = np.array([8, 10, 12])
>>> a
array([1. +8.j, 3.+10.j, 5.+12.j])

>>> np.imag(np.array(1 + 1j))
array(1.)