inet::physicallayer::LogNormalShadowing Class Reference

This class implements the log normal shadowing model. More...

#include <LogNormalShadowing.h>

Inheritance diagram for inet::physicallayer::LogNormalShadowing:

Public Member Functions
	LogNormalShadowing ()
virtual std::ostream &	printToStream (std::ostream &stream, int level) const override
	Prints this object to the provided output stream. More...
virtual double	computePathLoss (mps propagationSpeed, Hz frequency, m distance) const override
	Returns the loss factor as a function of propagation speed, carrier frequency and distance. More...
Public Member Functions inherited from inet::physicallayer::FreeSpacePathLoss
	FreeSpacePathLoss ()
virtual m	computeRange (mps propagationSpeed, Hz frequency, double loss) const override
	Returns the range for the given loss factor. More...
Public Member Functions inherited from inet::physicallayer::PathLossBase
virtual double	computePathLoss (const ITransmission *transmission, const IArrival *arrival) const override
	Returns the loss factor for the provided transmission and arrival. More...
Public Member Functions inherited from inet::physicallayer::IPrintableObject
virtual	~IPrintableObject ()
virtual std::string	getInfoStringRepresentation () const
virtual std::string	getDetailStringRepresentation () const
virtual std::string	getDebugStringRepresentation () const
virtual std::string	getTraceStringRepresentation () const
virtual std::string	getCompleteStringRepresentation () const

Protected Member Functions
virtual void	initialize (int stage) override
Protected Member Functions inherited from inet::physicallayer::FreeSpacePathLoss
virtual double	computeFreeSpacePathLoss (m waveLength, m distance, double alpha, double systemLoss) const

Protected Attributes
double	sigma
Protected Attributes inherited from inet::physicallayer::FreeSpacePathLoss
double	alpha
double	systemLoss

Additional Inherited Members
Public Types inherited from inet::physicallayer::IPrintableObject
enum	PrintLevel {   PRINT_LEVEL_TRACE, PRINT_LEVEL_DEBUG, PRINT_LEVEL_DETAIL, PRINT_LEVEL_INFO,   PRINT_LEVEL_COMPLETE = INT_MIN }

Detailed Description

This class implements the log normal shadowing model.

Constructor & Destructor Documentation

inet::physicallayer::LogNormalShadowing::LogNormalShadowing

(

)

                                       :
    sigma(1)
{
}

Member Function Documentation

double inet::physicallayer::LogNormalShadowing::computePathLoss ( mps  propagationSpeed, Hz  frequency, m  distance  ) const

overridevirtual

Returns the loss factor as a function of propagation speed, carrier frequency and distance.

The value is in the range [0, 1] where 1 means no loss at all and 0 means all power is lost.

Reimplemented from inet::physicallayer::FreeSpacePathLoss.

{
    m d0 = m(1.0);
    // reference path loss
    double freeSpacePathLoss = computeFreeSpacePathLoss(propagationSpeed / frequency, d0, alpha, systemLoss);
    double PL_d0_db = 10.0 * log10(1 / freeSpacePathLoss);
    // path loss at distance d + normal distribution with sigma standard deviation
    double PL_db = PL_d0_db + 10 * alpha * log10(unit(distance / d0).get()) + normal(0.0, sigma);
    return math::dB2fraction(-PL_db);
}

void inet::physicallayer::LogNormalShadowing::initialize ( int  stage )

overrideprotectedvirtual

Reimplemented from inet::physicallayer::FreeSpacePathLoss.

{
    FreeSpacePathLoss::initialize(stage);
    if (stage == INITSTAGE_LOCAL) {
        sigma = par("sigma");
    }
}

std::ostream & inet::physicallayer::LogNormalShadowing::printToStream ( std::ostream &  stream, int  level  ) const

overridevirtual

Prints this object to the provided output stream.

Function calls to operator<< with pointers or references either const or not are all forwarded to this function.

Reimplemented from inet::physicallayer::FreeSpacePathLoss.

{
    stream << "LogNormalShadowing";
    if (level <= PRINT_LEVEL_TRACE)
        stream << ", alpha = " << alpha
               << ", systemLoss = " << systemLoss
               << ", sigma = " << sigma;
    return stream;
}

Member Data Documentation

double inet::physicallayer::LogNormalShadowing::sigma

protected

Referenced by computePathLoss(), initialize(), and printToStream().

---

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

• LogNormalShadowing.h
• LogNormalShadowing.cc