Two-Ray interference model borrowed from Veins (default parameterization) More...

#include <TwoRayInterference.h>

Inheritance diagram for inet::physicallayer::TwoRayInterference:

Public Member Functions
	TwoRayInterference ()

void	initialize (int stage) override

double	computePathLoss (const ITransmission , const IArrival ) const override
	Returns the loss factor for the provided transmission and arrival. More...

double	computePathLoss (mps propagation, Hz frequency, m distance) const override
	Returns the loss factor as a function of propagation speed, carrier frequency and distance. More...

m	computeRange (mps propagation, Hz frequency, double loss) const override
	Returns the range for the given loss factor. More...

std::ostream &	printToStream (std::ostream &, int level) const override
	Prints this object to the provided output stream. 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 double	computeTwoRayInterference (const Coord &posTx, const Coord &posRx, m waveLength) const

Protected Attributes
double	epsilon_r

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

Two-Ray interference model borrowed from Veins (default parameterization)

See "Using the Right Two-Way Model? A Measurement-based Evaluation of PHY Models in VANETs" by C. Sommer and F. Dressler (2011) or "On the Applicability of Two-Ray Path Loss Models for Vehicular Network Simulation" by C. Sommer, S. Joerer and F. Dressler (2012)

Constructor & Destructor Documentation

inet::physicallayer::TwoRayInterference::TwoRayInterference ( )

                                        :
     epsilon_r(1.0)
 {
 }

Member Function Documentation

double inet::physicallayer::TwoRayInterference::computePathLoss	(	const ITransmission *	transmission,
		const IArrival *	arrival
	)		const

overridevirtual

Returns the loss factor for the provided transmission and arrival.

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

 {
     auto radioMedium = transmission->getTransmitter()->getMedium();
     auto narrowbandSignalAnalogModel = check_and_cast<const INarrowbandSignal *>(transmission->getAnalogModel());
     mps propagationSpeed = radioMedium->getPropagation()->getPropagationSpeed();
     Hz carrierFrequency = Hz(narrowbandSignalAnalogModel->getCarrierFrequency());
     const m waveLength = propagationSpeed / carrierFrequency;
 
     return computeTwoRayInterference(transmission->getStartPosition(), arrival->getStartPosition(), waveLength);
 }

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

 {
     return NaN;
 }

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

overridevirtual

Returns the range for the given loss factor.

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

Implements inet::physicallayer::IPathLoss.

 {
     return m(NaN);
 }

double inet::physicallayer::TwoRayInterference::computeTwoRayInterference	(	const Coord &	posTx,
		const Coord &	posRx,
		m	waveLength
	)		const

protectedvirtual

Referenced by computePathLoss().

 {
     const m distance { pos_r.distance(pos_t) };
     const m h_sum { pos_t.z + pos_r.z };
     const m h_dif { pos_t.z - pos_r.z };
     const m d_los = sqrt(distance * distance + h_dif * h_dif);
     const m d_ref = sqrt(distance * distance + h_sum * h_sum);
 
     const double phi = 2 * M_PI * unit((d_los - d_ref) / lambda).get();
     const double sin_theta = unit(h_sum / d_ref).get();
     const double cos_theta = unit(distance / d_ref).get();
     const double gamma = sqrt(epsilon_r - cos_theta * cos_theta);
     const double Gamma = (sin_theta - gamma) / (sin_theta + gamma);
 
     const double space = 4 * M_PI * unit(distance / lambda).get();
     const double rays = sqrt(pow(1 + Gamma * cos(phi), 2) + Gamma * Gamma * pow(sin(phi), 2));
     return pow(space / rays, -2);
 }

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

override

 {
     if (stage == INITSTAGE_LOCAL) {
         epsilon_r = par("epsilon_r");
     }
 }

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

 {
     os << "TwoRayInterference";
     if (level >= PRINT_LEVEL_TRACE)
         os << ", epsilon_r = " << epsilon_r;
     return os;
 }

Member Data Documentation

double inet::physicallayer::TwoRayInterference::epsilon_r

protected

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

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

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation