# Documentation

### This is machine translation

Translated by
Mouseover text to see original. Click the button below to return to the English verison of the 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. NoteSignal 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`