Main Content


Plot antenna radiation pattern on map



pattern(tx) plots the 3-D antenna radiation pattern for the transmitter site, txsite. Signal gain value (dBi) in a particular direction determines the color of the pattern.


This function only supports antenna sites with CoordinateSystem property set to 'geographic'.


pattern(rx,frequency) plots the 3-D radiation pattern for the receiver site, rxsite for the specified frequency.


pattern(___,Name,Value) plots the 3-D radiation pattern with additional options specified by name-value pair arguments.


collapse all

Define and visualize the radiation pattern of a single transmitter site.

tx = txsite;

Design a receiver site using a dipole antenna at a height of 30 meters.

 d = dipole;
 rx= rxsite('Name','Mathworks Lakeside','Latitude',42.30321,'Longitude',-71.3764,...
rx = 
  rxsite with properties:

                   Name: 'Mathworks Lakeside'
               Latitude: 42.3032
              Longitude: -71.3764
                Antenna: [1×1 dipole]
           AntennaAngle: 0
          AntennaHeight: 30
             SystemLoss: 0
    ReceiverSensitivity: -100


Visualize the pattern of the receiver site at 75 MHz.


Create directional antenna.

yagiAntenna = design(yagiUda,4.5e9);
yagiAntenna.Tilt = 90;
yagiAntenna.TiltAxis = 'y';

Create transmitter and receiver sites at a frequency of 4.5 GHz. Use the Yagi antenna as the transmitter antenna. Design a dipole at 4.5 GHz and use this as the receiver antenna.

fq = 4.5e9;
tx = txsite('Name','MathWorks','Latitude',42.3001,'Longitude', -71.3503, ...
      'Antenna', yagiAntenna,'AntennaAngle', 90,'AntennaHeight', 30, ...
      'TransmitterFrequency', fq,'TransmitterPower', 10);
rx = rxsite('Antenna',design(dipole, fq));

Position the receiver 200 meters from the transmitter.

 [lat,lon] = location(tx,200,90);
 rx.Latitude = lat;
 rx.Longitude = lon;

Display both transmitter and receiver patterns.

pattern(rx, fq);

Input Arguments

collapse all

Transmitter site, specified as a txsite object.

Receiver site, specified as a rxsite object.

Frequency to calculate radiation pattern, specified as a positive scalar.

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'Size',2

Size of the pattern plot, specified as the comma-separated pair consisting of 'Size' and a numerical scalar in meters. This parameter represents the distance between the antenna position and the point on the plot with the highest gain.

Data Types: double

Transparency of the pattern plot, specified as the comma-separated pair consisting of 'Transparency' and a real number in the range of [0,1], where 0 is completely transparent and 1 is completely opaque.

Data Types: double

Colormap for coloring of the pattern plot, specified as the comma-separated pair consisting of 'Colormap' and predefined colormap name or an M-by-3 array of RGB (red, blue, green) triplets that define M individual colors.

Data Types: double

Resolution of 3-D map, specified as the comma-separated pair consisting of 'Resolution' and 'low', 'medium', or 'high'. This 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.

Data Types: double

Map for visualization of surface data, specified as the comma-separated pair consisting of 'Map' and a siteviewer object.[1]

Data Types: char | string

See Also

Introduced in R2018b

[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®.