imag

Imaginary part of complex number

Syntax

Y = imag(Z)

Description

Y = imag(Z) returns the imaginary part of each element in array Z.

Examples

Imaginary Part of Complex Number

Find the imaginary part of the complex number Z.

Z = 2+3i;
Y = imag(Z)

Y = 
3

Imaginary Part of Vector of Complex Values

Find the imaginary part of each element in vector Z. The imag function acts on Z element-wise.

Z = [0.5i 1+3i -2.2];
Y = imag(Z)

Y = 1×3

    0.5000    3.0000         0

Input Arguments

Z — Input array

scalar | vector | matrix | multidimensional array

Input array, specified as a scalar, vector, matrix, or multidimensional array. imag operates element-wise when Z is nonscalar.

Extended Capabilities

Tall Arrays

Calculate with arrays that have more rows than fit in memory.

The imag function fully supports tall arrays. For more information, see Tall Arrays.

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

HDL Code Generation
Generate VHDL, Verilog and SystemVerilog code for FPGA and ASIC designs using HDL Coder™.

Thread-Based Environment

Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool.

This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

GPU Arrays

Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.

The imag function fully supports GPU arrays. To run the function on a GPU, specify the input data as a gpuArray (Parallel Computing Toolbox). For more information, see Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Distributed Arrays

Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

This function fully supports distributed arrays. For more information, see Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Version History

Introduced before R2006a