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, int evFlags=0) 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::IPrintableObject
virtual	~IPrintableObject ()

virtual std::string	printToString () const

virtual std::string	printToString (int level, int evFlags=0) const

virtual std::string	getInfoStringRepresentation (int evFlags=0) const

virtual std::string	getDetailStringRepresentation (int evFlags=0) const

virtual std::string	getDebugStringRepresentation (int evFlags=0) const

virtual std::string	getTraceStringRepresentation (int evFlags=0) const

virtual std::string	getCompleteStringRepresentation (int evFlags=0) 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::IPrintableObject
enum	PrintLevel { PRINT_LEVEL_TRACE, PRINT_LEVEL_DEBUG, PRINT_LEVEL_DETAIL, PRINT_LEVEL_INFO, PRINT_LEVEL_COMPLETE = INT_MIN }

enum	PrintFlag { PRINT_FLAG_FORMATTED = (1 << 0), PRINT_FLAG_MULTILINE = (1 << 1) }

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

◆ UwbIrStochasticPathLoss()

inet::physicallayer::UwbIrStochasticPathLoss::UwbIrStochasticPathLoss ( )

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

Member Function Documentation

◆ computePathLoss()

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);
 }

◆ computeRange()

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.

79 { return m(NaN); }

◆ getFDPathLoss()

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);
 }

◆ getGhassemzadehPathLoss()

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

protectedvirtual

 {
     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);
 }

Referenced by computePathLoss().

◆ getNarrowBandFreeSpacePathLoss()

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);
 }

◆ initialize()

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");
     }
 }

◆ printToStream()

std::ostream & inet::physicallayer::UwbIrStochasticPathLoss::printToStream	(	std::ostream &	stream,
		int	level,
		int	evFlags = `0`
	)		const

overridevirtual

Prints this object to the provided output stream.

Reimplemented from inet::IPrintableObject.

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

◆ simtruncnormal()

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

protectedvirtual

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

Referenced by computePathLoss().

Member Data Documentation

◆ d0

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

staticprotected

Referenced by getFDPathLoss(), and getGhassemzadehPathLoss().

◆ fc

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

staticprotected

Referenced by getFDPathLoss().

◆ kappa

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

staticprotected

Referenced by getFDPathLoss().

◆ muGamma

double inet::physicallayer::UwbIrStochasticPathLoss::muGamma

protected

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

◆ muSigma

double inet::physicallayer::UwbIrStochasticPathLoss::muSigma

protected

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

◆ n1_limit

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

staticprotected

Referenced by computePathLoss().

◆ n2_limit

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

staticprotected

Referenced by computePathLoss().

◆ n3_limit

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

staticprotected

Referenced by computePathLoss().

◆ pathloss_exponent

double inet::physicallayer::UwbIrStochasticPathLoss::pathloss_exponent

protected

Referenced by getFDPathLoss().

◆ PL0

double inet::physicallayer::UwbIrStochasticPathLoss::PL0

protected

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

◆ s_mu

const double inet::physicallayer::UwbIrStochasticPathLoss::s_mu

staticprotected

◆ s_sigma

const double inet::physicallayer::UwbIrStochasticPathLoss::s_sigma

staticprotected

◆ shadowing

bool inet::physicallayer::UwbIrStochasticPathLoss::shadowing

protected

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

◆ sigmaGamma

double inet::physicallayer::UwbIrStochasticPathLoss::sigmaGamma

protected

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

◆ sigmaSigma

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

◆ UwbIrStochasticPathLoss()

Member Function Documentation

◆ computePathLoss()

◆ computeRange()

◆ getFDPathLoss()

◆ getGhassemzadehPathLoss()

◆ getNarrowBandFreeSpacePathLoss()

◆ initialize()

◆ printToStream()

◆ simtruncnormal()

Member Data Documentation

◆ d0

◆ fc

◆ kappa

◆ muGamma

◆ muSigma

◆ n1_limit

◆ n2_limit

◆ n3_limit

◆ pathloss_exponent

◆ PL0

◆ s_mu

◆ s_sigma

◆ shadowing

◆ sigmaGamma

◆ sigmaSigma