vsip_polar_p - Convert Cartesian to Polar Coordinates

Core

This manual is preliminary and incomplete.
While our Core implementation implements all functions given in the standard we are still working on completing this documentation.

Please refer to the VSIPL standard for a complete function reference of the Core profile until we have completed work on this documentation.

[next] [prev] [prev-tail] [tail] [up]

2.1.5 vsip_polar_p - Convert Cartesian to Polar Coordinates

void vsip_polar_f(vsip_cscalar_f a, vsip_scalar_f *radius, vsip_scalar_f *theta);

Description

This function converts a complex scalar from Cartesian coordinates (real and imaginary parts) to polar coordinates (magnitude and phase angle).

The function computes both the magnitude (radius) and phase angle (theta) of the complex number:

√︃------2--------2 radius= |a|= real(a) +imag(a)

theta=atan2(imag(a),real(a))

The phase angle is returned in radians in the range $[- π,π]$ .

Parameters

vsip_cscalar_p a: Input complex scalar in Cartesian coordinates.
vsip_scalar_p *radius: Pointer to store the magnitude (radius).
vsip_scalar_p *theta: Pointer to store the phase angle in radians.

[next] [prev] [prev-tail] [front] [up]