raytrace

Plot propagation paths between sites

Description

example

raytrace(tx,rx) 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.

Note

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

raytrace(___,Name,Value) plots propagation paths with additional options specified by one or more name-value pairs.

Examples

collapse all

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.

los(tx,rx)

Show a reflected propagation path using ray tracing.

 raytrace(tx,rx)

Show multiple propagation paths, including first-order and second-order reflections.

 raytrace(tx,rx,'NumReflections',[1 2])

Input Arguments

collapse all

Receiver site, specified as a rxsite object or an array of rxsite objects. If the transmitter sites are specified as arrays, then the propagation paths are plotted from each transmitter to each receiver site.

Transmitter site, specified as a txsite object or an array of txsite objects. If the receiver sites are specified as arrays, then the propagation paths are plotted from each transmitter to each receiver site.

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 quantity to plot, specified as the comma-separated pair consisting of 'Type' and 'power' 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.

Data Types: char

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 elements are 0, 1, or 2.

The default value results in the search for a line-of-sight propagation path along with propagation paths that each contain a single reflection.

Data Types: double

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

Data Types: char | double

Color limits for colormap, specified as the comma-separated pair consisting of '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 'Type' parameter:

  • 'power'– Units are in dBm, and the default value is [-120 -5].

  • 'pathloss'– Units are in dB, and the default value is [45 160].

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.

Data Types: double

Show color legend on map, specified as the comma-separated pair consisting of 'ShowLegend' and true or false.

Data Types: logical

Map for visualization and surface data, specified as a siteviewer object. The default value is the current Site Viewer.

Data Types: char | string

See Also

|

Introduced in R2019b