atan2

Four-quadrant inverse tangent

collapse all in page

Syntax

P = atan2(Y,X)

Description

P = atan2(Y,X) returns the four-quadrant inverse tangent (tan-1) of Y and X, which must be real. The atan2 function follows the convention that atan2(x,x) returns 0 when x is mathematically zero (either 0 or -0).

example

Examples

collapse all

Open Live Script

Find the four-quadrant inverse tangent of the point y = 4, x = -3. 

atan2(4,-3)
ans = 
2.2143
Open Live Script

Convert 4 + 3i into polar coordinates. 

z = 4 + 3i;
r = abs(z)
r = 
5

theta = atan2(imag(z),real(z))
theta = 
0.6435

The radius r and the angle theta are the polar coordinate representation of 4 + 3i.

Alternatively, use angle to calculate theta. 

theta = angle(z)
theta = 
0.6435

Convert r and theta back into the original complex number. 

z = r*exp(i*theta)
z = 
4.0000 + 3.0000i
Open Live Script

Plot atan2(Y,X) for -4<Y<4 and -4<X<4.

Define the interval to plot over.

[X,Y] = meshgrid(-4:0.1:4,-4:0.1:4);

Find atan2(Y,X) over the interval.

P = atan2(Y,X);

Use surf to generate a surface plot of the function. Note that plot plots the discontinuity that exists at Y=0 for all X<0.

surf(X,Y,P);
view(45,45);

Figure contains an axes object. The axes object contains an object of type surface.

Input Arguments

collapse all

y-coordinates, specified as a scalar, vector, matrix, multidimensional array, table, or timetable. Inputs Y and X must either be the same size or have sizes that are compatible (for example, Y is an M-by-N matrix and X is a scalar or 1-by-N row vector). For more information, see Compatible Array Sizes for Basic Operations.

Data Types: single | double | table | timetable

x-coordinates, specified as a scalar, vector, matrix, multidimensional array, table, or timetable. Inputs Y and X must either be the same size or have sizes that are compatible (for example, Y is an M-by-N matrix and X is a scalar or 1-by-N row vector). For more information, see Compatible Array Sizes for Basic Operations.

Data Types: single | double | table | timetable

More About

collapse all

Extended Capabilities

expand all

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

Version History

Introduced before R2006a

expand all

See Also

| | | |