inet::physicallayer::DipoleAntenna::AntennaGain Class Reference

#include <DipoleAntenna.h>

Inheritance diagram for inet::physicallayer::DipoleAntenna::AntennaGain:

Public Member Functions
	AntennaGain (const char *wireAxis, m length)
virtual m	getLength () const
virtual double	getMinGain () const override
	Returns the minimum possible antenna gain independent of any direction. More...
virtual double	getMaxGain () const override
	Returns the maximum possible antenna gain independent of any direction. More...
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
Coord	wireAxisDirection
m	length

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::DipoleAntenna::AntennaGain::AntennaGain	(	const char *	wireAxis,
		m	length
	)

                                                                    :
    length(length)
{
    wireAxisDirection = Coord::parse(wireAxis);
}

Member Function Documentation

computeGain()

double inet::physicallayer::DipoleAntenna::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) * wireAxisDirection));
    double angle = std::acos(product);
    double q = sin(angle);
    return 1.5 * q * q;
}

getLength()

virtual m inet::physicallayer::DipoleAntenna::AntennaGain::getLength ( ) const

inlinevirtual

{ return length; }

getMaxGain()

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

inlineoverridevirtual

Returns the maximum possible antenna gain independent of any direction.

Implements inet::physicallayer::IAntennaGain.

{ return 1.5; }

getMinGain()

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

inlineoverridevirtual

Returns the minimum possible antenna gain independent of any direction.

Implements inet::physicallayer::IAntennaGain.

{ return 0; }

Member Data Documentation

length

m inet::physicallayer::DipoleAntenna::AntennaGain::length

protected

wireAxisDirection

Coord inet::physicallayer::DipoleAntenna::AntennaGain::wireAxisDirection

protected

Referenced by AntennaGain().

---

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

• DipoleAntenna.h
• DipoleAntenna.cc