pathloss
Description
returns the path loss using additional options specified by
pl
= pathloss(___,Name,Value
)Name,Value
pairs.
Examples
Path Loss of Receiver In Heavy Rain
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.3208
Input Arguments
propmodel
— Propagation model
propagation model object
Propagation model, specified as a FreeSpace
, Rain
,
Gas
,
Fog
,
CloseIn
,
LongleyRice
, TIREM
(Antenna Toolbox), or RayTracing
object.
Create propagation models by using the propagationModel
function.
rx
— Receiver site
rxsite
object
Receiver site, specified as a rxsite
object. You can
use array inputs to specify multiple sites.
tx
— Transmitter site
txsite
object
Transmitter site, specified as a txsite
object. You can
use array inputs to specify multiple sites.
NameValue Arguments
Specify optional pairs of arguments as
Name1=Value1,...,NameN=ValueN
, where Name
is
the argument name and Value
is the corresponding value.
Namevalue arguments must appear after other arguments, but the order of the
pairs does not matter.
Before R2021a, use commas to separate each name and value, and enclose
Name
in quotes.
Example: 'Map','none'
Map
— Map for visualization or surface data
siteviewer
object  triangulation
object  string scalar  character vector
Map for visualization or surface data, specified as a siteviewer
object, a triangulation
object, a string scalar, or a character vector.
Valid and default values depend on the coordinate system.
Coordinate System  Valid map values  Default map value 

"geographic" 


"cartesian" 


^{a} Alignment of boundaries and region labels are a presentation of the feature provided by the data vendors and do not imply endorsement by MathWorks^{®}. 
In most cases, if you specify this argument as a value other than a siteviewer
or "none"
, then you must also specify an
output argument.
Data Types: char
 string
Output Arguments
pl
— Path loss
scalar  MbyN arrays
Path loss, returned as a scalar or MbyN cell arrays containing a row vector of path loss values 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 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.
info
— Information corresponding to each propagation path
MbyN structure array  MbyN cell array containing vector
of structures in each cell
Information corresponding to each propagation path, returned as a MbyN cell array containing vector of structures in each cell for ray tracing propagation models and MbyN structure array for 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 2by1 double vector of azimuth and elevation angles in degrees.AngleOfArrival
— Angle of arrival of signal at receiver site antenna returned as a 2by1 double vector of azimuth and elevation angles in degrees.NumReflections
— Number of reflections undergone by signal along propagation path, returned specified as0
,1
, or2
. This field and value is only for ray tracing propagation models.
Angle values in this structure are defined using the local EastNorthUp
coordinate system of the antenna when CoordinateSystem
is
set to geographic
. Angle values in this structure are
defined using global Cartesian coordinate system when
CoordinateSystem
is set to
cartesian
. Azimuth angle is measured either from east
(when 'geographic'
) or from the global xaxis around the
global zaxis (when 'cartesian'
). Elevation angle is
measured from the horizontal (or XY) plane to the xaxis of the antenna in
the range 90 to 90.
Version History
Introduced in R2019bR2023a: Ray tracing models discard paths based on path loss
Ray tracing propagation models discard propagation paths based on path loss
thresholds. By default, when you specify the propmodel
input
argument as a RayTracing
object, the propagation model discards paths that are more than 40 dB weaker than
the strongest path.
As a result, the pathloss
function can return different
values in R2023a compared to previous releases. To avoid discarding propagation
paths based on relative path loss thresholds, set the
MaxRelativePathLoss
property of the ray tracing object to
Inf
.
R2022b: Ray tracing models using SBR method find paths with exact geometric accuracy
Ray tracing models that find propagation paths by using the shooting and bouncing rays (SBR) method correct the results so that the geometric accuracy of each path is exact, using singleprecision floatingpoint computations. In previous releases, the paths have approximate geometric accuracy.
As a result, when you use a ray tracing model as input to the
pathloss
function, the function can return different
results than in previous releases.
See Also
Open Example
You have a modified version of this example. Do you want to open this example with your edits?
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
 América Latina (Español)
 Canada (English)
 United States (English)
Europe
 Belgium (English)
 Denmark (English)
 Deutschland (Deutsch)
 España (Español)
 Finland (English)
 France (Français)
 Ireland (English)
 Italia (Italiano)
 Luxembourg (English)
 Netherlands (English)
 Norway (English)
 Österreich (Deutsch)
 Portugal (English)
 Sweden (English)
 Switzerland
 United Kingdom (English)