EngeeComms.FreeSpacePathLoss

Simulates signal power loss in free space.

Library	`EngeeComms`
Block	Free Space Path Loss

Description

System object EngeeComms.FreeSpacePathLoss adds free space loss to the complex signal. The system object simulates the loss of signal power depending on the distance between the transmitter and receiver. Parameter Mode indicates whether the loss is set explicitly in decibels or calculated based on the distance and frequency of the RF signal.

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

Create an object EngeeComms.FreeSpacePathLoss and set its properties.
Call an 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 object of signal power loss in free space freespacepathloss with properties by default.

Example:
```
freespacepathloss = EngeeComms.FreeSpacePathLoss()
```
freespacepathloss = EngeeComms.FreeSpacePathLoss(Name=Value) — creates a system object freespacepathloss with the specified properties as a pair Name=Value, where Name — the name of the property, and Value — appropriate value. You can specify multiple pairs «name-value» the order of the pairs does not matter. Unspecified properties retain their by default values.

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

Usage

outsignal = freespacepathloss(insignal) — adds free-space losses to the complex signal, as indicated in freespacepathloss. The result is returned in outsignal.

Arguments

Input arguments

In — input signal

+ scalar | column vector

Details

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

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

Output arguments

Out — output signal

+ scalar | column vector

Details

The output signal returned as a scalar or column vector. The output signal has the same dimension and the same 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 and 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 to all system objects

step!

Run the algorithm of the system object