add, +
Description
combines the specified propagation model objects into a composite propagation model
object. This syntax enables you to combine more than two propagation models, such as
pmc
= propmodel1
+ propmodel2
propmodel1 + propmodel2 + propmodel3
.
is an alternate way to combine propagation models.pmc
= add(propmodel1
,propmodel2
)
Examples
Create Composite Propagation Model
Create propagation models for gas and rain.
gasModel = propagationModel("gas"); rainModel = propagationModel("rain");
Combine the models by using the add
function. The result is a CompositePropagationModel
object.
pmc2 = add(gasModel,rainModel)
pmc2 = CompositePropagationModel with properties: PropagationModels: [1x2 rfprop.PropagationModel]
Create a propagation model for fog. Then, add the fog model to the combined gas and rain model.
fogModel = propagationModel("fog");
pmc3 = add(pmc2,fogModel)
pmc3 = CompositePropagationModel with properties: PropagationModels: [1x3 rfprop.PropagationModel]
Alternatively, you can combine all of the propagation models at once by using the +
operator.
pmcPlus = gasModel + rainModel + fogModel;
Calculate Signal Strength Using Composite Propagation Model
Create the transmitter and the receiver sites.
tx = txsite(Name="Fenway Park", ... Latitude=42.3467, ... Longitude=-71.0972, ... TransmitterFrequency=6e9); rx = rxsite(Name="Bunker Hill Monument", ... Latitude=42.3763, ... Longitude=-71.0611);
Calculate the signal strength using the default Longley-Rice propagation model.
ss1 = sigstrength(rx,tx)
ss1 = -80.9353
Create a composite propagation model by combining the Longley-Rice model with gas and rain models.
propmodel1 = propagationModel("longley-rice"); propmodel2 = propagationModel("gas"); propmodel3 = propagationModel("rain"); cpm = propmodel1 + propmodel2 + propmodel3;
Calculate the signal strength again, this time using the composite propagation model.
ss2 = sigstrength(rx,tx,cpm)
ss2 = -81.2259
Input Arguments
propmodel1
, propmodel2
— Propagation model
FreeSpace
object | CloseIn
object | Rain
object | Gas
object | Fog
object | LongleyRice
object | RayTracing
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.
Specifying more than one model that includes the effects of free-space loss is not supported. For more information about combining propagation models, see Choose a Propagation Model.
The propmodel1
and propmodel2
arguments must specify different types of objects.
Output Arguments
pmc
— Composite propagation model
CompositePropagationModel
object
Composite propagation model, returned as a
CompositePropagationModel
object.
A CompositePropagationModel
object has one property,
PropagationModels
, which stores the propagation
models that comprise the object. The PropagationModels
property stores the models using FreeSpace
, Rain
,
Gas
,
Fog
,
CloseIn
,
LongleyRice
, TIREM
(Antenna Toolbox), or RayTracing
objects.
The path loss for the composite propagation model is the sum of the path losses for the input propagation models. If either input is a ray tracing model, then the output contains a ray tracing model that adds the path losses from rain, gas, or fog models to the path loss for each propagation path.
Version History
Introduced in R2020a
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)