ns3::ThreeLogDistancePropagationLossModel Class Reference

A log distance path loss propagation model with three distance fields. This model is the same as ns3::LogDistancePropagationLossModel except that it has three distance fields: near, middle and far with different exponents. More...

#include <propagation-loss-model.h>

Inheritance diagram for ns3::ThreeLogDistancePropagationLossModel:

[legend]

Collaboration diagram for ns3::ThreeLogDistancePropagationLossModel:

[legend]

List of all members.

Static Public Member Functions

static TypeId GetTypeId (void)

This method returns the TypeId associated to ns3::ThreeLogDistancePropagationLossModel.

Detailed Description

A log distance path loss propagation model with three distance fields. This model is the same as ns3::LogDistancePropagationLossModel except that it has three distance fields: near, middle and far with different exponents.

Within each field the reception power is calculated using the log-distance propagation equation:

$L = L_0 + 10 \cdot n_0 log_{10}(\frac{d}{d_0})$

Each field begins where the previous ends and all together form a continuous function.

There are three valid distance fields: near, middle, far. Actually four: the first from 0 to the reference distance is invalid and returns txPowerDbm.

$\underbrace{0 \cdots\cdots}_{=0} \underbrace{d_0 \cdots\cdots}_{n_0} \underbrace{d_1 \cdots\cdots}_{n_1} \underbrace{d_2 \cdots\cdots}_{n_2} \infty$

Complete formula for the path loss in dB:

$\displaystyle L = \begin{cases} 0 & d < d_0 \\ L_0 + 10 \cdot n_0 \log_{10}(\frac{d}{d_0}) & d_0 \leq d < d_1 \\ L_0 + 10 \cdot n_0 \log_{10}(\frac{d_1}{d_0}) + 10 \cdot n_1 \log_{10}(\frac{d}{d_1}) & d_1 \leq d < d_2 \\ L_0 + 10 \cdot n_0 \log_{10}(\frac{d_1}{d_0}) + 10 \cdot n_1 \log_{10}(\frac{d_2}{d_1}) + 10 \cdot n_2 \log_{10}(\frac{d}{d_2})& d_2 \leq d \end{cases}$

where:

: resulting path loss (dB)
: distance (m)
: three distance fields (m)
: path loss distance exponent for each field (unitless)
: path loss at reference distance (dB)

When the path loss is requested at a distance smaller than the reference distance $ d_0 $ , the tx power (with no path loss) is returned. The reference distance defaults to 1m and reference loss defaults to ns3::FriisPropagationLossModel with 5.15 GHz and is thus $ L_0 $ = 46.67 dB.

Member Function Documentation

static TypeId ns3::ThreeLogDistancePropagationLossModel::GetTypeId ( void ) [static]

This method returns the TypeId associated to ns3::ThreeLogDistancePropagationLossModel.

Attributes defined for this type:

Distance0: Beginning of the first (near) distance field
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 1
- Flags: construct write read
Distance1: Beginning of the second (middle) distance field.
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 200
- Flags: construct write read
Distance2: Beginning of the third (far) distance field.
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 500
- Flags: construct write read
Exponent0: The exponent for the first field.
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 1.9
- Flags: construct write read
Exponent1: The exponent for the second field.
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 3.8
- Flags: construct write read
Exponent2: The exponent for the third field.
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 3.8
- Flags: construct write read
ReferenceLoss: The reference loss at distance d0 (dB). (Default is Friis at 1m with 5.15 GHz)
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 46.6777
- Flags: construct write read

No TraceSources defined for this type.

Reimplemented from ns3::PropagationLossModel.

The documentation for this class was generated from the following files:

src/devices/wifi/propagation-loss-model.h
doc/introspected-doxygen.h


Static Public Member Functions
static TypeId	GetTypeId (void)
	This method returns the TypeId associated to ns3::ThreeLogDistancePropagationLossModel.