pathloss

Path loss of radio wave propagation

Description

example

pl = pathloss(propmodel,rx,tx) returns the path loss of radio wave propagation at the receiver site from the transmitter site.

pl = pathloss(___,Name,Value) returns the path loss using additional options specified by Name,Value pairs.

[pl,info] = pathloss(___) returns the path loss and the information about the propagation paths.

Examples

collapse all

Specify the transmitter and the receiver sites.

tx = txsite('Name','MathWorks Apple Hill',...
       'Latitude',42.3001, ...
       'Longitude',-71.3504, ...
       'TransmitterFrequency', 2.5e9);
 
rx = rxsite('Name','Fenway Park',...
       'Latitude',42.3467, ...
       'Longitude',-71.0972);

Create the propagation model for heavy rainfall rate.

pm = propagationModel('rain','RainRate',50)
pm = 
  Rain with properties:

    RainRate: 50
        Tilt: 0

Calculate the pathloss at the receiver using the rain propagation model.

pl = pathloss(pm,rx,tx)
pl = 127.1559

Input Arguments

collapse all

Propagation model, specified as a character vector or string.

Data Types: char

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

Data Types: char

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

Data Types: char

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: 'Map','none'

Map for visualization or surface data, specified as the comma-separated pair consisting of 'Map and a siteviewer object or a terrain name. A terrain name may be specified if the function is called with an output argument. 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. If no Site Viewer is open, the default value is a new Site Viewer or else 'gmted2010' if the function is called with an output argument.

Data Types: char | string

Output Arguments

collapse all

Path loss, returned as a scalar or M-by-N arrays with each element in decibels. M is the number of TX sites and N is the number of RX sites.

Path loss is computed along the shortest path shortest path through space connecting the transmitter and receiver antenna centers.

For terrain propagation models, path loss is computed using terrain elevation profile that is computed at sample locations on the great circle path between the transmitter and the receiver. If Map is a siteviewer object with buildings specified, the terrain elevation is adjusted to include the height of the buildings.

Information corresponding to each propagation path, returned as a M-by-N cell array containing vector of structs in each cell for ray-tracing-image-method propagation model and M-by-N struct array fro all other propagation models. The field and values for the structures are:

  • PropagationDistance - Total distance of propagation path returned as a double scalar in meters.

  • AngleOfDeparture - Angle of departure of signal from transmitter site antenna returned as a 2-by-1 double vector of azimuth and elevation angles in degrees.

  • AngleOfArrival - Angle of arrival of signal at receiver site antenna returned as a 2-by-1 double vector of azimuth and elevation angles in degrees.

  • NumReflections - Number of reflections undergone by signal along propagation path, returned specified as 0, 1, or 2. This field and value is only for raytrtacing-image-method.

Angle values are defined using the antenna's local East-North-Up coordinate system. Azimuth angle is measured counter-clockwise from east in the range 0 to 360, and elevation angle is measured from the horizontal plane in the range -90 to 90.

Introduced in R2017b