Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

coverage

Display coverage map

Syntax

coverage(tx)
coverage(tx,propmodel)
coverage(tx,rx)
coverage(tx,rx,propmodel)
coverage(___,Name,Value,___)

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.

Note

Signal strength is computed using a propagation model that disregards the curvature of the Earth, terrain, or other obstacles.

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.

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 single quotes (' '). You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'Type','power'

collapse all

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

collapse all

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'.

Note

Signal strength is computed using a propagation model that disregards the curvature of the Earth, terrain, or other obstacles.

Data Types: char

collapse all

Propagation model to use for the path loss calculation, specified as 'freespace', 'close-in', 'rain', 'gas', 'fog', or a propagation model object. You can also use the propagationModel function to define this input.

Data Types: char

Maximum range from site location to include in coverage map region, specified as a numeric scalar in meters.

The maximum range of 'auto' computes a value that includes all 'SignalStrengths' in the coverage map region.

Data Types: char | 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'.

Data Types: char | double

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

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'.

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 completely transparent and 1 is completely opaque.

Data Types: double

Introduced in R2017b

Was this topic helpful?