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. | |
![]() | |
AntennaModel () | |
~AntennaModel () override | |
virtual double | GetGainDb (Angles a)=0 |
this method is expected to be re-implemented by each antenna model | |
![]() | |
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. | |
![]() | |
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. | |
![]() | |
virtual | ~ObjectBase () |
Virtual destructor. | |
void | GetAttribute (std::string name, AttributeValue &value) 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. | |
virtual TypeId | GetInstanceTypeId () const =0 |
Get the most derived TypeId for this Object. | |
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 TypeId | GetTypeId () |
Get the type ID. | |
![]() | |
static TypeId | GetTypeId () |
Register this type. | |
![]() | |
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 | |
![]() | |
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. | |
![]() | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
Complete construction of ObjectBase; invoked by derived classes. | |
virtual void | NotifyConstructionCompleted () |
Notifier called once the ObjectBase is fully constructed. | |
![]() | |
static TypeId | GetObjectIid () |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. | |
Circular Aperture Antenna Model.
Introspection did not find any typical Config paths.
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.
No TraceSources are defined for this type.
Size of this type is 88 bytes (on a 64-bit architecture).
Definition at line 47 of file circular-aperture-antenna-model.h.
|
default |
|
overridedefault |
double ns3::CircularApertureAntennaModel::GetApertureRadius | ( | ) | const |
Return the antenna aperture radius.
Definition at line 92 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 138 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 119 of file circular-aperture-antenna-model.cc.
References m_maxGain.
double ns3::CircularApertureAntennaModel::GetMinGain | ( | ) | const |
Return the antenna min gain.
Definition at line 132 of file circular-aperture-antenna-model.cc.
References m_minGain.
double ns3::CircularApertureAntennaModel::GetOperatingFrequency | ( | ) | const |
Return the antenna operating frequency.
Definition at line 106 of file circular-aperture-antenna-model.cc.
References m_operatingFrequencyHz.
|
static |
Register this type.
Definition at line 53 of file circular-aperture-antenna-model.cc.
References ns3::MakeDoubleAccessor(), 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 84 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 112 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 125 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 98 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 132 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 134 of file circular-aperture-antenna-model.h.
Referenced by GetGainDb(), GetMaxGain(), and SetMaxGain().
|
private |
antenna min gain in dB
Definition at line 135 of file circular-aperture-antenna-model.h.
Referenced by GetGainDb(), GetMinGain(), and SetMinGain().
|
private |
antenna operating frequency in Hz
Definition at line 133 of file circular-aperture-antenna-model.h.
Referenced by GetGainDb(), GetOperatingFrequency(), and SetOperatingFrequency().