Implements the Ghassmezadeh stochastic UWB channel path loss model. More...

#include <UWBIRStochasticPathLoss.h>

Inheritance diagram for inet::physicallayer::UWBIRStochasticPathLoss:

Public Member Functions
	UWBIRStochasticPathLoss ()

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...

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

virtual double	getFDPathLoss (Hz frequency, m distance) const

virtual double	getGhassemzadehPathLoss (double gamma, double S, m distance) const

virtual double	getNarrowBandFreeSpacePathLoss (Hz frequency, m distance) const

virtual double	simtruncnormal (double mean, double stddev, double a, int rng) const

Protected Attributes
double	PL0

double	muGamma

double	muSigma

double	sigmaGamma

double	sigmaSigma

double	pathloss_exponent

bool	shadowing

Static Protected Attributes
static const Hz	fc = MHz(4492.8)

static const m	d0 = m(1)

static const double	n1_limit = 1.25

static const double	n2_limit = 2

static const double	n3_limit = 2

static const double	s_mu

static const double	s_sigma

static const double	kappa = 1

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

Implements the Ghassmezadeh stochastic UWB channel path loss model.

Citation of the following publication is appreciated if you use the MiXiM UWB PHY model for a publication of your own. J. Rousselot, J.-D. Decotignie, An ultra-wideband impulse radio PHY layer model for network simulation. SIMULATION January 2011 vol. 87 no. 1-2 82-112.

For more information, see also:

[1] J. Rousselot, J.-D. Decotignie, An ultra-wideband impulse radio PHY layer model for network simulation. SIMULATION January 2011 vol. 87 no. 1-2 82-112. http://dx.doi.org/10.1177/0037549710377767 [2] J. Rousselot, Ultra Low Power Communication Protocols for UWB Impulse Radio Wireless Sensor Networks. EPFL Thesis 4720, 2010. http://infoscience.epfl.ch/record/147987 [3] A High-Precision Ultra Wideband Impulse Radio Physical Layer Model for Network Simulation, Jérôme Rousselot, Jean-Dominique Decotignie, Second International Omnet++ Workshop,Simu'TOOLS, Rome, 6 Mar 09. http://portal.acm.org/citation.cfm?id=1537714

Constructor & Destructor Documentation

inet::physicallayer::UWBIRStochasticPathLoss::UWBIRStochasticPathLoss ( )

                                                  :
     PL0(0),
     muGamma(0),
     muSigma(0),
     sigmaGamma(0),
     sigmaSigma(0),
     pathloss_exponent(0.0),
     shadowing(true)
 {
 }

Member Function Documentation

double inet::physicallayer::UWBIRStochasticPathLoss::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.

Implements inet::physicallayer::PathLossBase.

 {
     double n1 = simtruncnormal(0, 1, n1_limit, 1);
     double n2 = simtruncnormal(0, 1, n2_limit, 2);
     double n3 = simtruncnormal(0, 1, n3_limit, 3);
     double gamma = muGamma + n1 * sigmaGamma;
     double sigma = muSigma + n3 * sigmaSigma;
     double S = n2 * sigma;
     return getGhassemzadehPathLoss(gamma, S, distance);
 }

virtual m inet::physicallayer::UWBIRStochasticPathLoss::computeRange	(	mps	propagationSpeed,
		Hz	frequency,
		double	loss
	)		const

inlineoverridevirtual

Returns the range for the given loss factor.

The value is in the range [0, +infinity) or NaN if unspecified.

Implements inet::physicallayer::IPathLoss.

82 { return m(NaN); }

NaN

#define NaN

Definition: INETMath.h:103

inet::units::values::m

value< double, units::m > m

Definition: Units.h:1047

double inet::physicallayer::UWBIRStochasticPathLoss::getFDPathLoss	(	Hz	frequency,
		m	distance
	)		const

protectedvirtual

                                                                             {
     return 0.5 * PL0 * pow(unit(frequency / fc).get(), -2 * (kappa + 1)) / pow(unit(distance / d0).get(), pathloss_exponent);
 }

double inet::physicallayer::UWBIRStochasticPathLoss::getGhassemzadehPathLoss	(	double	gamma,
		double	S,
		m	distance
	)		const

protectedvirtual

Referenced by computePathLoss().

 {
     double attenuation = PL0;
     if (distance < d0)
         distance = d0;
     attenuation = attenuation - 10 * gamma * log10(unit(distance / d0).get());
     if (shadowing)
         attenuation = attenuation - S;
     return math::dB2fraction(attenuation);
 }

double inet::physicallayer::UWBIRStochasticPathLoss::getNarrowBandFreeSpacePathLoss	(	Hz	frequency,
		m	distance
	)		const

protectedvirtual

 {
     double attenuation = 4 * M_PI * unit(distance * frequency / mps(SPEED_OF_LIGHT)).get();
     return 1.0 / (attenuation * attenuation);
 }

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

overrideprotectedvirtual

 {
     if (stage == INITSTAGE_LOCAL) {
         PL0 = par("PL0");
         muGamma = par("muGamma");
         muSigma = par("muSigma");
         sigmaGamma = par("sigmaGamma");
         sigmaSigma = par("sigmaSigma");
         shadowing = par("shadowing");
     }
 }

std::ostream & inet::physicallayer::UWBIRStochasticPathLoss::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::IPrintableObject.

 {
     stream << "UWBIRStochasticPathLoss";
     if (level <= PRINT_LEVEL_TRACE)
         stream << ", PL0 = " << PL0
                << ", muGamma = " << muGamma
                << ", muSigma = " << muSigma
                << ", sigmaGamma = " << sigmaGamma
                << ", sigmaSigma = " << sigmaSigma
                << ", shadowing = " << shadowing;
     return stream;
 }

double inet::physicallayer::UWBIRStochasticPathLoss::simtruncnormal	(	double	mean,
		double	stddev,
		double	a,
		int	rng
	)		const

protectedvirtual

Referenced by computePathLoss().

 {
     double result = a + 1;
     while (result > a || result < -a)
       result = normal(mean, stddev, 0);
     return result;
 }

Member Data Documentation

const m inet::physicallayer::UWBIRStochasticPathLoss::d0 = m(1)

staticprotected

Referenced by getFDPathLoss(), and getGhassemzadehPathLoss().

const Hz inet::physicallayer::UWBIRStochasticPathLoss::fc = MHz(4492.8)

staticprotected

Referenced by getFDPathLoss().

const double inet::physicallayer::UWBIRStochasticPathLoss::kappa = 1

staticprotected

Referenced by getFDPathLoss().

double inet::physicallayer::UWBIRStochasticPathLoss::muGamma

protected

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

double inet::physicallayer::UWBIRStochasticPathLoss::muSigma

protected

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

const double inet::physicallayer::UWBIRStochasticPathLoss::n1_limit = 1.25

staticprotected

Referenced by computePathLoss().

const double inet::physicallayer::UWBIRStochasticPathLoss::n2_limit = 2

staticprotected

Referenced by computePathLoss().

const double inet::physicallayer::UWBIRStochasticPathLoss::n3_limit = 2

staticprotected

Referenced by computePathLoss().

double inet::physicallayer::UWBIRStochasticPathLoss::pathloss_exponent

protected

Referenced by getFDPathLoss().

double inet::physicallayer::UWBIRStochasticPathLoss::PL0

protected

Referenced by getFDPathLoss(), getGhassemzadehPathLoss(), initialize(), and printToStream().

const double inet::physicallayer::UWBIRStochasticPathLoss::s_mu

staticprotected

const double inet::physicallayer::UWBIRStochasticPathLoss::s_sigma

staticprotected

bool inet::physicallayer::UWBIRStochasticPathLoss::shadowing

protected

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

double inet::physicallayer::UWBIRStochasticPathLoss::sigmaGamma

protected

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

double inet::physicallayer::UWBIRStochasticPathLoss::sigmaSigma

protected

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

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

Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation