azelcut2pat

Create 3-D response pattern from azimuth and elevation cuts

Syntax

pat = azelcut2pat(azcut,elcut)

Description

pat = azelcut2pat(azcut,elcut) creates a 3-D element response pattern, pat, from an azimuth cut, azcut, and an elevation cut, elcut. An azimuth cut consists of an antenna pattern over all azimuth angles at 0° elevation. An elevation cut consists of the antenna pattern over all elevation angles at 0° azimuth. You can specify cuts for different frequencies at the same time.

Examples

Create Custom Antenna Pattern from Azimuth and Elevations Cuts

Create a custom antenna pattern from azimuth and elevation cuts of a cosine-squared pattern.

az = -180:180;
azcut = mag2db(cosd(az).^2);
el = -90:90;
elcut = mag2db(cosd(el).^2);
pat = azelcut2pat(azcut,elcut);
antenna = phased.CustomAntennaElement('AzimuthAngles',az,...
    'ElevationAngles',el,'MagnitudePattern',pat,...
    'PhasePattern',zeros(size(pat)));

Display the antenna pattern for 200 MHz.

fs = 200.0e6;
pattern(antenna,fs);

Input Arguments

azcut — Azimuth pattern cut

zeros(1,361) (default) | real-valued 1-by-Q vector | real-valued L-by-Q matrix

Azimuth pattern cut, specified as a real-valued 1-by-Q vector or a real-valued L-by-Q matrix. Q is the number of azimuth angles, and L is the number of frequencies. Azimuth cuts are assumed to be made at 0° elevation. When azcut is a matrix, each column represents a different azimuth angle, and each row represents a different frequency. Units are in dB.

Data Types: double

elcut — Elevation pattern cut

zeros(1,181) (default) | real-valued 1-by-P vector | real-valued L-by-P matrix

Elevation pattern cut, specified as a real-valued 1-by-P vector or a real-valued L-by-P matrix. P is the number of elevation angles, and L is the number of frequencies. Elevation cuts are assumed to be made at 0° azimuth. When elcut is a matrix, each column represents a different elevation angle, and each row represents a different frequency. Units are in dB.

Data Types: double

Output Arguments

pat — 3-D antenna pattern

real-valued P-by-Q matrix | real-valued P-by-Q-by-L array

3-D array or antenna pattern, returned as a real-valued P-by-Q matrix or real-valued P-by-Q-by-L MATLAB^® array. Units are in dB.

Algorithms

The function returns a 3-D antenna pattern at the same azimuth and elevation angles used to define the azcut and elcut cuts. Because the cuts are specified in dB, the 3-D pattern is computed from the sum of the cut patterns.

pat(az,el) = pat(az) + pat(el)

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Version History

Introduced in R2019a