Convert u/v coordinates to azimuth/elevation angles

converts
the `AzEl`

= uv2azel(`UV`

)*u*/*v* space coordinates
to their corresponding azimuth/elevation angle pairs.

Find the corresponding azimuth/elevation representation for *u* = 0.5 and *v* = 0.

azel = uv2azel([0.5; 0])

`azel = `*2×1*
30.0000
0

`UV`

— Angle in u/v spacetwo-row matrix

Angle in *u*/*v* space, specified
as a two-row matrix. Each column of the matrix represents a pair of
coordinates in the form [*u*; *v*].
Each coordinate is between –1 and 1, inclusive. Also, each
pair must satisfy *u*^{2} + *v*^{2}≤
1.

**Data Types: **`double`

`AzEl`

— Azimuth/elevation angle pairstwo-row matrix

Azimuth and elevation angles, returned as a two-row matrix.
Each column of the matrix represents an angle in degrees, in the form
[azimuth; elevation]. The matrix dimensions of `AzEl`

are
the same as those of `UV`

.

The *u*/*v* coordinates
for the positive hemisphere *x* ≥ 0 can be
derived from the phi
and theta angles.

The relation between the two coordinates is

$$\begin{array}{l}u=\mathrm{sin}\theta \mathrm{cos}\varphi \\ v=\mathrm{sin}\theta \mathrm{sin}\varphi \end{array}$$

In these expressions, φ and θ are the phi and theta angles, respectively.

In terms of azimuth and elevation, the *u* and *v* coordinates
are

$$\begin{array}{l}u=\mathrm{cos}el\mathrm{sin}az\\ v=\mathrm{sin}el\end{array}$$

The values of *u* and *v* satisfy
the inequalities

$$\begin{array}{l}-1\le u\le 1\\ -1\le v\le 1\\ {u}^{2}+{v}^{2}\le 1\end{array}$$

Conversely, the phi and theta angles can be written in terms
of *u* and *v* using

$$\begin{array}{l}\mathrm{tan}\varphi =u/v\\ \mathrm{sin}\theta =\sqrt{{u}^{2}+{v}^{2}}\end{array}$$

The azimuth and elevation angles can also be written in terms
of *u* and *v*

$$\begin{array}{l}\mathrm{sin}el=v\\ \mathrm{tan}az=\frac{u}{\sqrt{1-{u}^{2}-{v}^{2}}}\end{array}$$

The φ angle is the angle from the positive *y*-axis
toward the positive *z*-axis, to the vector’s
orthogonal projection onto the *yz* plane. The φ
angle is between 0 and 360 degrees. The θ angle is the angle
from the *x*-axis toward the *yz* plane,
to the vector itself. The θ angle is between 0 and 180 degrees.

The figure illustrates φ and θ for a vector that appears as a green solid line. The coordinate system is relative to the center of a uniform linear array, whose elements appear as blue circles.

The coordinate transformations between φ/θ and *az/el* are
described by the following equations

$$\begin{array}{l}\mathrm{sin}(\text{el})=\mathrm{sin}\varphi \mathrm{sin}\theta \hfill \\ \mathrm{tan}(\text{az})=\mathrm{cos}\varphi \mathrm{tan}\theta \hfill \\ \hfill \\ \mathrm{cos}\theta =\mathrm{cos}(\text{el})\mathrm{cos}(\text{az})\hfill \\ \mathrm{tan}\varphi =\mathrm{tan}(\text{el})/\mathrm{sin}(\text{az})\hfill \end{array}$$

The *azimuth angle* of a vector is the angle between
the *x*-axis and the orthogonal projection of the vector onto the
*xy* plane. The angle is positive in going from the
*x* axis toward the *y* axis. Azimuth angles lie
between –180 and 180 degrees. The *elevation angle* is the angle
between the vector and its orthogonal projection onto the *xy*-plane. The
angle is positive when going toward the positive *z*-axis from the
*xy* plane. These definitions assume the boresight direction is the
positive *x*-axis.

The elevation angle is sometimes defined in the literature as the angle a vector makes
with the positive *z*-axis. The MATLAB^{®} and Phased Array
System Toolbox™ products do not use this definition.

This figure illustrates the azimuth angle and elevation angle for a vector shown as a green solid line. The coordinate system is relative to the center of a uniform linear array, whose elements appear as blue disks.

Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

Does not support variable-size inputs.

A modified version of this example exists on your system. Do you want to open this version instead?

You clicked a link that corresponds to this MATLAB command:

Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.

Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .

Select web siteYou can also select a web site from the following list:

Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.

- América Latina (Español)
- Canada (English)
- United States (English)

- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)

- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)