Main Content

Complex to Magnitude-Angle HDL Optimized

Compute magnitude and phase angle of complex signal – optimized for HDL code generation using the CORDIC algorithm

  • Library:
  • DSP System Toolbox HDL Support / Math Functions

  • Complex to Magnitude-Angle HDL Optimized block

Description

The Complex to Magnitude-Angle HDL Optimized block computes the magnitude and phase angle of a complex signal and provides hardware-friendly control signals. To achieve an efficient HDL implementation, the block uses a pipelined Coordinate Rotation Digital Computer (CORDIC) algorithm.

You can use this block to implement operations such as atan2 in hardware.

Ports

Input

expand all

Complex input signal, specified as a scalar, a column vector representing samples in time, or a row vector representing channels. Using vector input increases data throughput while using more hardware resources. The block implements the conversion logic in parallel for each element of the vector. The input vector can contain up to 64 elements.

double and single data types are supported for simulation, but not for HDL code generation.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fixed point

When validIn is true, the block captures the data from the dataIn input port. The validIn signal applies to all samples in a vector input signal.

Data Types: Boolean

Output

expand all

Magnitude of the input signal, returned as a scalar, a column vector representing samples in time, or a row vector representing channels. The dimensions of this port match the dimensions of the dataIn port.

Dependencies

To enable this port, set the Output format parameter to Magnitude and Angle or Magnitude.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fixdt([],N,0)

Angle of the input signal, returned as a scalar, a column vector representing samples in time, or a row vector representing channels. The dimensions of this port match the dimensions of the dataIn port.

Dependencies

To enable this port, set the Output format parameter to Magnitude and Angle or Angle.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fixdt([],N,0)

The block sets validOut to true with each valid data returned on the Magnitude or Angle output ports. The validOut signal applies to all samples in a vector output signal.

Data Types: Boolean

Parameters

expand all

  • To set the number of iterations to input WL − 1, select Auto. If the input is of data type double or single, the number of iterations is set to 16, by default.

  • To specify the number of iterations by using Number of iterations parameter, select Property.

The number of iterations must be less than or equal to input WL − 1. The latency of the block depends on the number of iterations performed. For information about latency, see Latency.

Dependencies

To enable this parameter, set Number of iterations source to Property.

Use this parameter to specify which output ports are enabled.

  • To enable the Magnitude and Angle output ports, select Magnitude and Angle (default).

  • To enable the Magnitude output port and disable the Angle output port, select Magnitude.

  • To enable the Angle output port and disable the Magnitude output port, select Angle.

  • To return the Angle output as a fixed-point value that normalizes the angles in the range [–1,1], select Normalized. For more information see Normalized Angle Format.

  • To return the Angle output as a fixed-point value in the range [-π, π], select Radians. When using this block to implement the atan2 function, set this parameter to Radians.

Select this parameter to multiply the Angle output by the inverse of the CORDIC gain factor.

Note

If you clear this parameter and apply the CORDIC gain elsewhere in your design, you must exclude the π/4 term. Because the quadrant mapping algorithm replaces the first CORDIC iteration by mapping inputs onto the angle range [0, π/4], the initial rotation does not contribute a gain term.

Algorithms

expand all

Extended Capabilities

Introduced in R2014b