Display antenna radiation pattern in Site Viewer
pattern( displays the 3-D antenna
radiation pattern for the transmitter site
txsite in the
current Site Viewer. Signal gain value (dBi) in a particular direction
determines the color of the pattern.
displays the 3-D radiation pattern with additional options specified by
name-value pair arguments.
Single Transmitter Site Pattern
Define and visualize the radiation pattern of a single transmitter site.
tx = txsite; pattern(tx)
Pattern for Cartesian Transmitter
Import and view an STL file. The file models a small conference room with one table and four chairs.
viewer = siteviewer('SceneModel','conferenceroom.stl');
Create a transmitter site that uses a three-element uniform linear array (ULA) with an element spacing of
0.05 meters. Specify the position using Cartesian coordinates in meters.
cfgArray = arrayConfig("Size",[3 1],"ElementSpacing",0.05); tx = txsite("cartesian", ... "AntennaPosition",[0; 0; 2.1], ... "Antenna",cfgArray);
Display the antenna pattern. Specify the size of the pattern plot as
Pan by left-clicking, zoom by right-clicking or by using the scroll wheel, and rotate the visualization by clicking the middle button and dragging or by pressing Ctrl and left-clicking and dragging.
Tilt the antenna by updating the
AntennaAngle property of the transmitter. Display the updated pattern.
tx.AntennaAngle = [0 90]; pattern(tx,"Transparency",0.6,"Size",0.4)
frequency — Frequency to calculate radiation pattern
Frequency to calculate radiation pattern, specified as a positive scalar.
Specify optional pairs of arguments as
the argument name and
Value is the corresponding value.
Name-value arguments must appear after other arguments, but the order of the
pairs does not matter.
Before R2021a, use commas to separate each name and value, and enclose
Name in quotes.
Size — Size of pattern plot
'auto' (default) | numerical scalar
Size of the pattern plot, specified as a numerical scalar in meters. This parameter represents the distance between the antenna position and the point on the plot with the highest gain.
The default value depends on the
property of the
siteviewer object. When
'geographic', the default size is 50 meters. When
'cartesian', the default size is approximately
1/6 of the scene model size.
Transparency — Transparency of pattern plot
0.4 (default) | real number in the range of [0,1]
Transparency of the pattern plot, specified as a real number in the
range of [0,1], where
0 is completely transparent and
1 is completely opaque.
Colormap — Colormap for coloring of pattern plot
'jet(256)' (default) | predefined colormap name | M-by-3 array of RGB triplets
Colormap for coloring of the pattern plot, specified as a predefined colormap name or an M-by-3 array of RGB (red, blue, green) triplets that define M individual colors.
Resolution — Resolution of 3-D pattern
'high' (default) |
Resolution of 3-D map, specified as
property controls the visual quality and the time taken to plot the
pattern where the value of
'low' corresponds to the
fastest and the least detailed pattern.
Introduced in R2019b
1 Alignment of boundaries and region labels are a presentation of the feature provided by the data vendors and do not imply endorsement by MathWorks®.