Circular Aperture Antenna Model. More...
#include "circular-aperture-antenna-model.h"
Public Member Functions | |
CircularApertureAntennaModel ()=default | |
~CircularApertureAntennaModel () override=default | |
double | GetApertureRadius () const |
Return the antenna aperture radius. | |
double | GetGainDb (Angles a) override |
Get the gain in dB, using Bessel equation of first kind and first order. | |
double | GetMaxGain () const |
Return the antenna max gain. | |
double | GetMinGain () const |
Return the antenna min gain. | |
double | GetOperatingFrequency () const |
Return the antenna operating frequency. | |
void | SetApertureRadius (double aMeter) |
Set the antenna aperture radius. | |
void | SetMaxGain (double gainDb) |
Set the antenna max gain. | |
void | SetMinGain (double gainDb) |
Set the antenna min gain. | |
void | SetOperatingFrequency (double freqHz) |
Set the antenna operating frequency. | |
Public Member Functions inherited from ns3::AntennaModel | |
AntennaModel () | |
~AntennaModel () override | |
Public Member Functions inherited from ns3::Object | |
Object () | |
Constructor. | |
~Object () override | |
Destructor. | |
void | AggregateObject (Ptr< Object > other) |
Aggregate two Objects together. | |
void | Dispose () |
Dispose of this Object. | |
AggregateIterator | GetAggregateIterator () const |
Get an iterator to the Objects aggregated to this one. | |
TypeId | GetInstanceTypeId () const override |
Get the most derived TypeId for this Object. | |
template<typename T > | |
Ptr< T > | GetObject () const |
Get a pointer to the requested aggregated Object. | |
template<> | |
Ptr< Object > | GetObject () const |
Specialization of () for objects of type ns3::Object. | |
template<typename T > | |
Ptr< T > | GetObject (TypeId tid) const |
Get a pointer to the requested aggregated Object by TypeId. | |
template<> | |
Ptr< Object > | GetObject (TypeId tid) const |
Specialization of (TypeId tid) for objects of type ns3::Object. | |
void | Initialize () |
Invoke DoInitialize on all Objects aggregated to this one. | |
bool | IsInitialized () const |
Check if the object has been initialized. | |
void | UnidirectionalAggregateObject (Ptr< Object > other) |
Aggregate an Object to another Object. | |
Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
SimpleRefCount () | |
Default constructor. | |
SimpleRefCount (const SimpleRefCount &o) | |
Copy constructor. | |
uint32_t | GetReferenceCount () const |
Get the reference count of the object. | |
SimpleRefCount & | operator= (const SimpleRefCount &o) |
Assignment operator. | |
void | Ref () const |
Increment the reference count. | |
void | Unref () const |
Decrement the reference count. | |
Public Member Functions inherited from ns3::ObjectBase | |
virtual | ~ObjectBase () |
Virtual destructor. | |
void | GetAttribute (std::string name, AttributeValue &value, bool permissive=false) const |
Get the value of an attribute, raising fatal errors if unsuccessful. | |
bool | GetAttributeFailSafe (std::string name, AttributeValue &value) const |
Get the value of an attribute without raising errors. | |
void | SetAttribute (std::string name, const AttributeValue &value) |
Set a single attribute, raising fatal errors if unsuccessful. | |
bool | SetAttributeFailSafe (std::string name, const AttributeValue &value) |
Set a single attribute without raising errors. | |
bool | TraceConnect (std::string name, std::string context, const CallbackBase &cb) |
Connect a TraceSource to a Callback with a context. | |
bool | TraceConnectWithoutContext (std::string name, const CallbackBase &cb) |
Connect a TraceSource to a Callback without a context. | |
bool | TraceDisconnect (std::string name, std::string context, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected with a context. | |
bool | TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected without a context. | |
Static Public Member Functions | |
static TypeId | GetTypeId () |
Register this type. | |
Static Public Member Functions inherited from ns3::AntennaModel | |
static TypeId | GetTypeId () |
Get the type ID. | |
Static Public Member Functions inherited from ns3::Object | |
static TypeId | GetTypeId () |
Register this type. | |
Static Public Member Functions inherited from ns3::ObjectBase | |
static TypeId | GetTypeId () |
Get the type ID. | |
Private Attributes | |
double | m_apertureRadiusMeter |
antenna aperture radius in meters | |
double | m_maxGain |
antenna gain in dB towards the main orientation | |
double | m_minGain |
antenna min gain in dB | |
double | m_operatingFrequencyHz |
antenna operating frequency in Hz | |
Additional Inherited Members | |
Protected Member Functions inherited from ns3::Object | |
Object (const Object &o) | |
Copy an Object. | |
virtual void | DoDispose () |
Destructor implementation. | |
virtual void | DoInitialize () |
Initialize() implementation. | |
virtual void | NotifyNewAggregate () |
Notify all Objects aggregated to this one of a new Object being aggregated. | |
Protected Member Functions inherited from ns3::ObjectBase | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
Complete construction of ObjectBase; invoked by derived classes. | |
virtual void | NotifyConstructionCompleted () |
Notifier called once the ObjectBase is fully constructed. | |
Related Symbols inherited from ns3::ObjectBase | |
static TypeId | GetObjectIid () |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. | |
Circular Aperture Antenna Model.
This class implements the circular aperture antenna as described in 3GPP 38.811 6.4.1 https://www.3gpp.org/ftp/Specs/archive/38_series/38.811 without the cosine approximation, thanks to the Bessel functions introduced in C++17. Spherical coordinates are used, in particular of the azimuth and inclination angles. All working parameters can be set, namely: operating frequency, aperture radius, maximum and minimum gain. Since Clang libc++ does not support the Mathematical special functions (P0226R1) yet, this class falls back to Boost's implementation of cyl_bessel_j whenever the above standard library is in use. If neither is available in the host system, this class is not compiled.
Definition at line 36 of file circular-aperture-antenna-model.h.
|
default |
|
overridedefault |
double ns3::CircularApertureAntennaModel::GetApertureRadius | ( | ) | const |
Return the antenna aperture radius.
Definition at line 81 of file circular-aperture-antenna-model.cc.
References m_apertureRadiusMeter.
Get the gain in dB, using Bessel equation of first kind and first order.
a | the angle at which the gain need to be calculated with respect to the antenna bore sight |
Implements ns3::AntennaModel.
Definition at line 127 of file circular-aperture-antenna-model.cc.
References ns3::Angles::GetAzimuth(), ns3::Angles::GetInclination(), m_apertureRadiusMeter, m_maxGain, m_minGain, m_operatingFrequencyHz, and NS_LOG_FUNCTION.
double ns3::CircularApertureAntennaModel::GetMaxGain | ( | ) | const |
Return the antenna max gain.
Definition at line 108 of file circular-aperture-antenna-model.cc.
References m_maxGain.
double ns3::CircularApertureAntennaModel::GetMinGain | ( | ) | const |
Return the antenna min gain.
Definition at line 121 of file circular-aperture-antenna-model.cc.
References m_minGain.
double ns3::CircularApertureAntennaModel::GetOperatingFrequency | ( | ) | const |
Return the antenna operating frequency.
Definition at line 95 of file circular-aperture-antenna-model.cc.
References m_operatingFrequencyHz.
|
static |
Register this type.
Definition at line 42 of file circular-aperture-antenna-model.cc.
References ns3::MakeDoubleAccessor(), ns3::MakeDoubleChecker(), SetApertureRadius(), SetMaxGain(), SetMinGain(), SetOperatingFrequency(), and ns3::TypeId::SetParent().
void ns3::CircularApertureAntennaModel::SetApertureRadius | ( | double | aMeter | ) |
Set the antenna aperture radius.
Sets the antenna operating frequency, asserting that the provided value is within the acceptable range [0, +inf[.
aMeter | the strictly positive antenna radius in meters |
Definition at line 73 of file circular-aperture-antenna-model.cc.
References m_apertureRadiusMeter, NS_ASSERT_MSG, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::CircularApertureAntennaModel::SetMaxGain | ( | double | gainDb | ) |
Set the antenna max gain.
gainDb | the antenna max gain in dB |
Definition at line 101 of file circular-aperture-antenna-model.cc.
References m_maxGain, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::CircularApertureAntennaModel::SetMinGain | ( | double | gainDb | ) |
Set the antenna min gain.
gainDb | the antenna min gain in dB |
Definition at line 114 of file circular-aperture-antenna-model.cc.
References m_minGain, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::CircularApertureAntennaModel::SetOperatingFrequency | ( | double | freqHz | ) |
Set the antenna operating frequency.
Sets the antenna operating frequency, asserting that the provided value is within the acceptable range [0, +inf[.
freqHz | the strictly positive antenna operating frequency, in Hz |
Definition at line 87 of file circular-aperture-antenna-model.cc.
References m_operatingFrequencyHz, NS_ASSERT_MSG, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
|
private |
antenna aperture radius in meters
Definition at line 121 of file circular-aperture-antenna-model.h.
Referenced by GetApertureRadius(), GetGainDb(), and SetApertureRadius().
|
private |
antenna gain in dB towards the main orientation
Definition at line 123 of file circular-aperture-antenna-model.h.
Referenced by GetGainDb(), GetMaxGain(), and SetMaxGain().
|
private |
antenna min gain in dB
Definition at line 124 of file circular-aperture-antenna-model.h.
Referenced by GetGainDb(), GetMinGain(), and SetMinGain().
|
private |
antenna operating frequency in Hz
Definition at line 122 of file circular-aperture-antenna-model.h.
Referenced by GetGainDb(), GetOperatingFrequency(), and SetOperatingFrequency().