phitheta2uvpat

Convert radiation pattern from phi/theta form to u/v form

Syntax

pat_uv = phitheta2uvpat(pat_phitheta,phi,theta)

pat_uv = phitheta2uvpat(pat_phitheta,phi,theta,u,v)

[pat_uv,u_pat,v_pat] = phitheta2uvpat(___)

Description

pat_uv = phitheta2uvpat(pat_phitheta,phi,theta) expresses the antenna radiation pattern pat_phitheta in u/v space coordinates instead of φ/θ angle coordinates. pat_phitheta samples the pattern at φ angles in phi and θ angles in theta. The pat_uv matrix uses a default grid that covers u values from –1 to 1 and v values from –1 to 1. In this grid, pat_uv is uniformly sampled with a step size of 0.01 for u and v. The function interpolates to estimate the response of the antenna at a given direction. Values in pat_uv are NaN for u and v values outside the unit circle because u and v are undefined outside the unit circle.

pat_uv = phitheta2uvpat(pat_phitheta,phi,theta,u,v) uses vectors u and v to specify the grid at which to sample pat_uv. To avoid interpolation errors, u should cover the range [–1, 1] and v should cover the range [–1, 1].

[pat_uv,u_pat,v_pat] = phitheta2uvpat(___) returns vectors containing the u and v coordinates at which pat_uv samples the pattern, using any of the input arguments in the previous syntaxes.

Examples

Conversion of Radiation Pattern

Convert a radiation pattern to u-v form, with the u and v coordinates spaced by 0.01.

Define the pattern in terms of φ and θ.

phi = 0:360;
theta = 0:90;
pat_phitheta = mag2db(repmat(cosd(theta)',1,numel(phi)));

Convert the pattern to u-v form.

pat_uv = phitheta2uvpat(pat_phitheta,phi,theta);

Convert and Plot Radiation Pattern

Convert a radiation pattern to $$u-v$$ coordinates, with the $$u$$ and $$v$$ coordinates spaced by 0.01.

Define the pattern in terms of $$\varphi$$ and $$\theta$$.

phi = 0:360;
theta = 0:90;
pat_phitheta = mag2db(repmat(cosd(theta)',1,numel(phi)));

Convert the pattern to $$u-v$$ coordinates. Store the $$u$$ and $$v$$ coordinates for use in plotting.

[pat_uv,u,v] = phitheta2uvpat(pat_phitheta,phi,theta);

Plot the result.

H = surf(u,v,pat_uv);
H.LineStyle = 'none';
xlabel('u');
ylabel('v');
zlabel('Pattern');

Convert Radiation Pattern for Specific U/V Values

Convert a radiation pattern to $$u-v$$ coordinates, with the $$u$$ and $$v$$ coordinates spaced by 0.05.

Define the pattern in terms of $$\varphi$$ and $$\theta$$.

phi = 0:360;
theta = 0:90;
pat_phitheta = mag2db(repmat(cosd(theta)',1,numel(phi)));

Define the set of $$u$$ and $$v$$ coordinates at which to sample the pattern. Then, convert the pattern.

u = -1:0.05:1;
v = -1:0.05:1;
pat_uv = phitheta2uvpat(pat_phitheta,phi,theta,u,v);

Plot the result.

H = surf(u,v,pat_uv);
H.LineStyle = 'none';
xlabel('u');
ylabel('v');
zlabel('Pattern');

Input Arguments

pat_phitheta — Antenna radiation pattern in phi/theta form

Q-by-P matrix

Antenna radiation pattern in phi/theta form, specified as a Q-by-P matrix. pat_phitheta samples the 3-D magnitude pattern in decibels, in terms of φ and θ angles. P is the length of the phi vector, and Q is the length of the theta vector.

Data Types: double

phi — Phi angles

vector of length P

Phi angles at which pat_phitheta samples the pattern, specified as a vector of length P. Each φ angle is in degrees, between 0 and 180.

Data Types: double

theta — Theta angles

vector of length Q

Theta angles at which pat_phitheta samples the pattern, specified as a vector of length Q. Each θ angle is in degrees, between 0 and 90. Such angles are in the hemisphere for which u and v are defined.

Data Types: double

u — u coordinates

[-1:0.01:1] (default) | vector of length L

u coordinates at which pat_uv samples the pattern, specified as a vector of length L. Each u coordinate is between –1 and 1.

Data Types: double

v — v coordinates

[-1:0.01:1] (default) | vector of length M

v coordinates at which pat_uv samples the pattern, specified as a vector of length M. Each v coordinate is between –1 and 1.

Data Types: double

Output Arguments

pat_uv — Antenna radiation pattern in u/v form

M-by-L matrix

Antenna radiation pattern in u/v form, returned as an M-by-L matrix. pat_uv samples the 3-D magnitude pattern in decibels, in terms of u and v coordinates. L is the length of the u vector, and M is the length of the v vector. Values in pat_uv are NaN for u and v values outside the unit circle because u and v are undefined outside the unit circle.

u_pat — u coordinates

vector of length L

u coordinates at which pat_uv samples the pattern, returned as a vector of length L.

v_pat — v coordinates

vector of length M

v coordinates at which pat_uv samples the pattern, returned as a vector of length M.

More About

Phi Angle, Theta Angle

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

The figure illustrates phi and theta for a vector that appears as a green solid line.

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

$$\begin{array}{l}\sin el=\sin \varphi \sin \theta \\ \tan az=\cos \varphi \tan \theta \\ \cos \theta =\cos el\cos az\\ \tan \varphi =\tan el/\sin az\end{array}$$

U/V Space

The u and v coordinates are the direction cosines of a vector with respect to the y-axis and z-axis, respectively.

The u/v coordinates for the hemisphere x ≥ 0 are derived from the phi and theta angles, as follows:

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

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

To convert azimuth and elevation to u and v use the transformation

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

which is valid only in the range abs(az)≤=90.

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}\tan \varphi =v/u\\ \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}\sin el=v\\ \tan az=\frac{u}{\sqrt{1-u^2-v^2}}\end{array}$$

Extended Capabilities

C/C++ Code Generation

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

Usage notes and limitations:

Does not support variable-size inputs.

Version History

Introduced in R2012a