EngeeComms.FreeSpacePathLoss

Simulates signal power loss in free space.

Library	`EngeeComms`.
Block	Free Space Path Loss

Description

The system object EngeeComms.FreeSpacePathLoss adds free-space loss to a complex signal. The system object models the loss of signal power as a function of the distance between transmitter and receiver. Parameters Mode indicates whether the loss is specified explicitly in decibels or calculated based on the distance and frequency of the RF signal.

To add free space loss to a complex signal, follow the steps below:

Create an object EngeeComms.FreeSpacePathLoss and set its properties.
Call the object with arguments as if it were a function.

To learn more about how to work with system objects, see Engee system objects.

Syntax

Creation

freespacepathloss = EngeeComms.FreeSpacePathLoss() creates a system signal power loss object in free space freespacepathloss with by default properties.

Example:
```
freespacepathloss = EngeeComms.FreeSpacePathLoss()
```
freespacepathloss = EngeeComms.FreeSpacePathLoss(Name=Value) creates a freespacepathloss system object with the specified Name property set to the specified Value value. You can specify additional arguments as a name-value pair in any order (Name1=Value1,…,NameN=ValueN).

Example:
```
freespacepathloss = EngeeComms.FreeSpacePathLoss(Loss=20)
```

Usage

outsignal = freespacepathloss(insignal) adds the freespace loss to the complex signal as specified in freespacepathloss. The result is returned in outsignal.

Arguments

Input arguments

In - input signal
scalar | vector-column

Details

A complex input signal given as a scalar or column vector.

Типы данных	`Complex`
Support for complex numbers	Yes

Output arguments

Out - output signal
scalar | vector-column

Details

An output signal returned as a scalar or column vector. The output signal has the same dimensionality and data type as the input signal.

Типы данных

Complex

Properties

# Loss — power losses
Real number

Details

Power loss in decibels, given as a scalar.

Dependencies

To use this property, set the property Mode property to Decibels.

# Mode — loss calculation mode
String

Details

A loss calculation mode specified as one of the parameters:

Decibels - losses are defined using the property Loss.
Distance and Frequency - losses are calculated by usage of properties * Distance и CarrierFrequency.

# Distance — distance between transmitter and receiver
Real number

Details

The distance between the transmitter and receiver in kilometres, given as a scalar.

Dependencies

To use this property, set the property Mode property to Distance and Frequency.

# CarrierFrequency — carrier frequency
Real number

Details

The carrier frequency in megahertz, specified as a scalar.

Dependencies

To use this property, set the property Mode property to Distance and Frequency.

Methods

Common for all system objects

step!

Start the system object’s operating algorithm