Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

uv2phitheta

Convert u/v coordinates to phi/theta angles

Syntax

Description

example

PhiTheta = uv2phitheta(UV) converts the u/v space coordinates to their corresponding phi/theta angle pairs.

Examples

collapse all

Find the corresponding φ/θ representation for u = 0.5 and v = 0.

PhiTheta = uv2phitheta([0.5; 0])
PhiTheta =

         0
   30.0000

Input Arguments

collapse all

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 u2 + v2≤ 1.

Data Types: double

Output Arguments

collapse all

Phi and theta angles, returned as a two-row matrix. Each column of the matrix represents an angle in degrees, in the form [phi; theta]. The matrix dimensions of PhiTheta are the same as those of UV.

More About

collapse all

U/V Space

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

u=sinθcosϕv=sinθsinϕ

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

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

u=coselsinazv=sinel

The values of u and v satisfy the inequalities

1u11v1u2+v21

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

tanϕ=u/vsinθ=u2+v2

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

sinel=vtanaz=u1u2v2

Phi Angle, Theta Angle

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

sin(el)=sinϕsinθtan(az)=cosϕtanθcosθ=cos(el)cos(az)tanϕ=tan(el)/sin(az)

See Also

Introduced in R2012a

Was this topic helpful?