coverage

Display coverage map

Description

example

coverage(tx) displays the coverage map for the transmitter site. Each colored contour of the map defines an area where the corresponding signal strength is transmitted to the mobile receiver.

coverage(tx,propmodel) displays the coverage map based on the specified propagation model.

coverage(tx,rx) displays the coverage map based on the receiver site properties.

example

coverage(tx,rx,propmodel) displays the coverage map based on the receiver site properties and specified propagation model.

example

coverage(___,Name,Value,___) displays the coverage map using additional options specified by the Name,Value pairs.

Examples

collapse all

Create a transmitter site at MathWorks headquarters.

tx = txsite('Name','MathWorks', ...
        'Latitude', 42.3001, ...
        'Longitude', -71.3503);

Show the coverage map.

coverage(tx)

Create a transmitter site at MathWorks headquarters.

tx = txsite('Name','MathWorks', ...
        'Latitude', 42.3001, ...
        'Longitude', -71.3503);

Create a receiver site at Fenway Park with an antenna height of 1.2 m and system loss of 10 dB.

rx = rxsite('Name','Fenway Park', ...
       'Latitude',42.3467, ...
       'Longitude',-71.0972,'AntennaHeight',1.2,'SystemLoss',10);

Calculate the coverage area of the transmitter using a close-in propagation model.

coverage(tx,rx,'PropagationModel','closein')

Define strong and weak signal strengths with corresponding colors.

strongSignal = -75;
strongSignalColor = "green";
weakSignal = -90;
weakSignalColor = "cyan";

Create a transmitter site and display the coverage map.

tx = txsite('Name','MathWorks','Latitude', 42.3001,'Longitude', -71.3503);
coverage(tx,'SignalStrengths',[strongSignal,weakSignal], ...
       'Colors', [strongSignalColor,weakSignalColor])

Define a Yagi-Uda antenna designed for a transmitter frequency of 4.5 GHz. Tilt the antenna to direct radiation in the XY-plane (i.e., geographic azimuth).

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

Create a transmitter site with this directional antenna.

tx = txsite('Name','MathWorks',...
        'Latitude', 42.3001, ...
        'Longitude', -71.3503, ...
        'Antenna', y, ...
        'AntennaHeight', 60, ...
        'TransmitterFrequency', fq, ...
        'TransmitterPower', 10);

Display the coverage map using the rain propagation model. The map pattern points east, which corresponds to default antenna angle value of 0 degrees.

coverage(tx,'rain','SignalStrengths',-90)

Define the names and the locations of sites around Boston.

names = ["Fenway Park","Faneuil Hall","Bunker Hill Monument"];
lats = [42.3467,42.3598,42.3763];
lons = [-71.0972,-71.0545,-71.0611];

Create the transmitter site array.

txs = txsite('Name', names,...
       'Latitude',lats,...
       'Longitude',lons, ...
       'TransmitterFrequency',2.5e9);

Display the combined coverage map for multiple signal strengths, using close-in propagation model.

coverage(txs,'close-in','SignalStrengths',-100:5:-60)

Input Arguments

collapse all

Transmitter site, specified as a txsite object. You can use array inputs to specify multiple sites.

Receiver site, specified as an rxsite object. You can also use the name-value pairs 'ReceiverGain' and 'ReceiverAntennaHeight' to specify the receiver values.

Propagation model, specified as a character vector or string. You can also use the name-value pair 'PropagationModel' to specify this parameter. You can also use the propagationModel function to define this input. The default propagation model is 'longeley-rice' when terrain is enabled and 'freespace' when terrain is disabled.

Data Types: char | string

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: 'Type','power'

Type of signal strength to compute, specified as 'power' or 'efield'.

Power is expressed in power units (dBm) of the signal at the receiver input. E-field is expressed in electric field strength units (dBμV/m) of signal wave incident on the antenna.

Data Types: char

Signal strengths to display on coverage map, specified as a numeric vector.

Each strength uses different colored filled contour on the map. The default value is -100 dBm if the 'Type' name-value pair is 'power' and 40 dBμV/m if 'Type' is 'efield'.

Data Types: | bus | char

Propagation model to use for the path loss calculations, specified as 'freespace', 'close-in', 'rain', 'gas', 'fog', 'longley-rice', or as an object created using the propagationModel function. The default propagation model is 'longeley-rice' when terrain is enabled and 'freespace' when terrain is disabled.

Data Types: char

Maximum range of the coverage map from each transmitter site, specified as a numeric scalar in meters representing a great circular distance. This property defines the region of interest on the map to plot. If the 'Map' is a siteviewer object with 'Buildings' specified, the default value is the distance to the farthest building. If using a terrain propagation model, the default value is 30000 m or 30 km. If using non-terrain propagation model, the default value is computed to include all SignalStrengths in the coverage map region.

Note

When using terrain, the MaxRange limit is 300000 m.

Data Types: double

Resolution of coverage map, specified as a numeric scalar in meters.

The resolution of 'auto' computes the maximum value scaled to 'MaxRange'. Decreasing the resolution increases the quality of the coverage map and the time required to create it.

Data Types: char | double

Mobile receiver gain, specified as a numeric scalar in dB. The receiver gain value includes the mobile receiver antenna gain and system loss.

The receiver gain computes received signal strength when the 'Type' is 'power'.

If receiver site argument rx is passed to coverage, the default value is the maximum gain of the receiver antenna with the system loss subtracted. Otherwise the default value is 2.1.

Data Types: char | double

Mobile receiver antenna height above ground elevation, specified as a numeric scalar in meters.

If receiver site argument rx is passed to coverage, the default value is the AntennaHeight of the receiver. Otherwise the default value is 1.

Data Types: double

Filled contours color of coverage map, specified as an M-by-3 array of RGB triplets, an array of strings, or a cell array of character vectors.

Colors are assigned element-wise to 'SignalStrengths' values for coloring the corresponding filled contours.

'Colors' cannot be used with 'ColorLimits' or 'ColorMap'.

For more information, see ColorSpec (Color Specification).

Data Types: char | string | double

Color limits for colormap, specified as a two-element vector of type [min max].

The color limits indicate the signal level values that map to the first and last colors on the colormap.

The default value is [-120 -5] if the 'Type' name-value pair is 'power' and [20 135] if 'Type' is 'efields'.

'ColorLimits' cannot be used with 'Color'.

Data Types: double

Colormap filled contours on coverage map, specified as a predefined colormap or M-by-3 array of RGB triplets, where M defines individual colors.

'ColorMap' cannot be used with 'Colors'.

Data Types: char | double

Transparency of coverage map, specified as a numeric scalar in the range 0 to 1. 0 is transparent and 1 is opaque.

Data Types: double

Map for surface data, specified as a siteviewer object or a terrain name. Valid terrain names are 'none', 'gmted2010', or the name of the custom terrain data added using addCustomTerrain. The default value is the current Site Viewer or 'gmted2010', if none is open.

Data Types: char | string

Introduced in R2017b