inet::physicallayer::ParabolicAntenna::AntennaGain Class Reference

#include <ParabolicAntenna.h>

Inheritance diagram for inet::physicallayer::ParabolicAntenna::AntennaGain:

Public Member Functions
	AntennaGain (double maxGain, double minGain, deg beamWidth)
virtual double	getMaxGain () const override
	Returns the maximum possible antenna gain independent of any direction. More...
virtual double	getMinGain () const override
	Returns the minimum possible antenna gain independent of any direction. More...
virtual deg	getBeamWidth () const
virtual double	computeGain (const Quaternion &direction) const override
	Returns the antenna gain in the provided direction. More...
Public Member Functions inherited from inet::IPrintableObject
virtual	~IPrintableObject ()
virtual std::ostream &	printToStream (std::ostream &stream, int level, int evFlags=0) const
	Prints this object to the provided output stream. More...
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
Public Member Functions inherited from inet::IntrusivePtrCounter< IAntennaGain >
INET_ALWAYS_INLINE	IntrusivePtrCounter () noexcept
INET_ALWAYS_INLINE	IntrusivePtrCounter (IntrusivePtrCounter const &) noexcept
INET_ALWAYS_INLINE unsigned int	use_count () const noexcept
INET_ALWAYS_INLINE IntrusivePtrCounter &	operator= (IntrusivePtrCounter const &) noexcept
INET_ALWAYS_INLINE IntrusivePtr< IAntennaGain >	shared_from_this ()

Protected Attributes
double	maxGain
double	minGain
deg	beamWidth

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) }
Protected Member Functions inherited from inet::IntrusivePtrCounter< IAntennaGain >
INET_ALWAYS_INLINE	~IntrusivePtrCounter ()=default

Constructor & Destructor Documentation

AntennaGain()

inet::physicallayer::ParabolicAntenna::AntennaGain::AntennaGain	(	double	maxGain,
		double	minGain,
		deg	beamWidth
	)

                                                                                      :
    maxGain(maxGain), minGain(minGain), beamWidth(beamWidth)
{
}

Member Function Documentation

computeGain()

double inet::physicallayer::ParabolicAntenna::AntennaGain::computeGain ( const Quaternion &  direction ) const

overridevirtual

Returns the antenna gain in the provided direction.

The direction is determined by rotating the X axis using the given quaternion. The direction is to be interpreted in the local coordinate system of the radiation pattern. This way the gain depends only on the antenna radion pattern characteristics, and not on the antenna orientation determined by the antenna's mobility model.

For transmissions, it determines how well the antenna converts input power into radio waves headed in the specified direction. For receptions, it determines how well the antenna converts radio waves arriving from the specified direction.

Implements inet::physicallayer::IAntennaGain.

{
    double product = math::minnan(1.0, math::maxnan(-1.0, direction.rotate(Coord::X_AXIS) * Coord::X_AXIS));
 
    deg alpha = rad(std::acos(product));
    ASSERT(deg(0) <= alpha && alpha <= deg(360));
    if (alpha > deg(180))
        alpha = deg(360) - alpha;
    return math::maxnan(minGain, maxGain * math::dB2fraction(-12 * pow(unit(alpha / beamWidth).get(), 2)));
}

getBeamWidth()

virtual deg inet::physicallayer::ParabolicAntenna::AntennaGain::getBeamWidth ( ) const

inlinevirtual

{ return beamWidth; }

getMaxGain()

virtual double inet::physicallayer::ParabolicAntenna::AntennaGain::getMaxGain ( ) const

inlineoverridevirtual

Returns the maximum possible antenna gain independent of any direction.

Implements inet::physicallayer::IAntennaGain.

{ return maxGain; }

getMinGain()

virtual double inet::physicallayer::ParabolicAntenna::AntennaGain::getMinGain ( ) const

inlineoverridevirtual

Returns the minimum possible antenna gain independent of any direction.

Implements inet::physicallayer::IAntennaGain.

{ return minGain; }

Member Data Documentation

beamWidth

deg inet::physicallayer::ParabolicAntenna::AntennaGain::beamWidth

protected

maxGain

double inet::physicallayer::ParabolicAntenna::AntennaGain::maxGain

protected

minGain

double inet::physicallayer::ParabolicAntenna::AntennaGain::minGain

protected

---

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

• ParabolicAntenna.h
• ParabolicAntenna.cc