Plot propagation paths between sites
plots the propagation paths from the transmitter site (
tx) to the
receiver site (
rx). The propagation paths are found using ray
tracing with the terrain and buildings data defined in the Site Viewer map. Each
propagation path is color-coded according to the received power (dBm) or path loss
(dB) along the path, assuming unpolarized rays.
The ray tracing analysis includes surface reflections but does not include effects from refraction, diffraction, or scattering.
Path loss and received power values do not include reflection loss due to material or antenna polarization properties.
plots propagation paths with additional options specified by one or more name-value
Launch Site Viewer with buildings in Chicago.
viewer = siteviewer("Buildings","chicago.osm");
Create a transmitter site on a building.
tx = txsite('Latitude',41.8800, ... 'Longitude',-87.6295, ... 'TransmitterFrequency',2.5e9);
Create a receiver site on another building.
rx = rxsite('Latitude',41.881352, ... 'Longitude',-87.629771, ... 'AntennaHeight',30);
Show the obstruction to line of sight.
Show a reflected propagation path using ray tracing.
Show multiple propagation paths, including first-order and second-order reflections.
rx— Receiver site
rxsiteobject | array of
Receiver site, specified as a
rxsite object or an array of
objects. If the transmitter sites are specified as arrays, then the
propagation paths are plotted from each transmitter to each receiver
tx— Transmitter site
txsiteobject | array of
Transmitter site, specified as a
txsite object or an array of
objects. If the receiver sites are specified as arrays, then the propagation
paths are plotted from each transmitter to each receiver site.
comma-separated pairs of
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
'Type'— Type of quantity to plot
Type of quantity to plot, specified as the comma-separated pair
in dBm or
'pathloss' in dB.
When you specify
'power', each path is color-coded
according to the received power along the path. When you specify
'pathloss', each path is color-coded according to
the path loss along the path.
'NumReflections'— Number of reflections to search for in propagation paths
[0 1](default) | numeric row vector
Number of reflections to search for in propagation paths using ray
tracing, specified as the comma-separated pair consisting of
'NumReflections' and a numeric row vector whose
The default value results in the search for a line-of-sight propagation path along with propagation paths that each contain a single reflection.
'Colormap'— Color map for coloring propagation paths
'jet'(default) | predefined color map name | M-by-3 array of RGB
Color map for coloring propagation paths, specified as the
comma-separated pair consisting of
'Colormap' and a
predefined color map name or an M-by-3 array of RGB
(red, blue, green) triplets that define M individual
'ColorLimits'— Color limits for colormap
Color limits for colormap, specified as the comma-separated pair
'ColorLimits' and a two-element numeric
row vector of the form [min max]. The units and default values of the
color limits depend on the value of the
'power'– Units are in dBm, and the
default value is
'pathloss'– Units are in dB, and the
default value is
The color limits indicate the values that map to the first and last colors in the colormap. Propagation paths with values below the minimum color limit are not plotted.
'ShowLegend'— Show color legend on map
Show color legend on map, specified as the comma-separated pair
'Map'— Map for visualization and surface data
Map for visualization and surface data, specified as a
siteviewer object. The default value is
the current Site Viewer.