Main Content

add

Add data to polar plot

Description

example

add(p,data) adds antenna pattern data based on the real amplitude values in data to the polar plot p.

example

add(p,angle,magnitude) adds data sets of angle vectors and corresponding magnitude matrices to polar plot p.

Examples

collapse all

Create a cosine-pattern antenna and plot the pattern from 0° to 36°.

az = [0:360];
p1 = abs(cosd(az));

Plot the polar pattern.

P = polarpattern(p1);

Create a second cosine-pattern antenna rotated by 60°. Add this pattern to the existing pattern.

p2 = abs(cosd(az - 50));
add(P,p2);

Create a cosine antenna and plot the polar pattern of its directivity at 75 MHz.

cosineantenna = phased.CosineAntennaElement('FrequencyRange',[1.0e0 100.0e9],...
    'CosinePower',[2,2]);
p1 = pattern(cosineantenna,75.0e6,[-90:90],0,'Type','Directivity');
P = polarpattern([-90:90],p1);

Create an isotropic antenna. Calculate the directivity of this antenna at 75 MHz.

isoantenna = phased.IsotropicAntennaElement('FrequencyRange',...
    [1.0e0 100.0e9]);
p2 = pattern(isoantenna,75.0e6,[-180:180],0,'Type','Directivity');

Add the directivity plot of the isotropic antenna to the directivity plot of the cosine antenna.

add(P,[-180:180],p2);

Input Arguments

collapse all

Polar plot, specified as a scalar handle.

Example: polarpattern

Antenna or array data, specified as one of the following:

  • A real length-M vector, where M contains the magnitude values with angles assumed to be (0:M1)M×360 degrees.

  • A real M-by-N matrix, where M contains the magnitude values and N contains the independent data sets. Each column in the matrix has angles taken from the vector (0:M1)M×360 degrees. The set of each angle can vary for each column.

  • A real N-D array, where N is the number of dimensions. Arrays with dimensions 2 and greater are independent data sets.

  • A complex vector or matrix, where data contains Cartesian coordinates ((x,y) of each point. x contains the real part of data and y contains the imaginary part of data.

When data is in a logarithmic form such as dB, magnitude values can be negative. In this case,polarpattern plots the lowest magnitude values at the origin of the polar plot and highest magnitude values at the maximum radius.

Example: pattern(dipole,70e6)

Set of angles, specified as a vector in degrees.

Set of magnitude values, specified as a vector or a matrix. For a matrix of magnitude values, each column is an independent set of magnitude values and corresponds to the same set of angles.

Version History

Introduced in R2016a