a Two-Ray Ground propagation loss model ported from NS2 More...
#include <propagation-loss-model.h>
Public Member Functions | |
double | GetFrequency (void) const |
double | GetMinDistance (void) const |
double | GetSystemLoss (void) const |
void | SetFrequency (double frequency) |
void | SetHeightAboveZ (double heightAboveZ) |
void | SetMinDistance (double minDistance) |
void | SetSystemLoss (double systemLoss) |
Public Member Functions inherited from ns3::PropagationLossModel | |
int64_t | AssignStreams (int64_t stream) |
double | CalcRxPower (double txPowerDbm, Ptr< MobilityModel > a, Ptr< MobilityModel > b) const |
Ptr< PropagationLossModel > | GetNext () |
Gets the next PropagationLossModel in the chain of loss models that act on the signal. More... | |
void | SetNext (Ptr< PropagationLossModel > next) |
Enables a chain of loss models to act on the signal. More... | |
Public Member Functions inherited from ns3::Object | |
void | AggregateObject (Ptr< Object > other) |
void | Dispose (void) |
AggregateIterator | GetAggregateIterator (void) const |
virtual TypeId | GetInstanceTypeId (void) const |
template<typename T > | |
Ptr< T > | GetObject (void) const |
template<typename T > | |
Ptr< T > | GetObject (TypeId tid) const |
void | Initialize (void) |
Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
SimpleRefCount (const SimpleRefCount &o) | |
uint32_t | GetReferenceCount (void) const |
SimpleRefCount & | operator= (const SimpleRefCount &o) |
void | Ref (void) const |
void | Unref (void) const |
Public Member Functions inherited from ns3::ObjectBase | |
void | GetAttribute (std::string name, AttributeValue &value) const |
bool | GetAttributeFailSafe (std::string name, AttributeValue &attribute) const |
void | SetAttribute (std::string name, const AttributeValue &value) |
bool | SetAttributeFailSafe (std::string name, const AttributeValue &value) |
bool | TraceConnect (std::string name, std::string context, const CallbackBase &cb) |
bool | TraceConnectWithoutContext (std::string name, const CallbackBase &cb) |
bool | TraceDisconnect (std::string name, std::string context, const CallbackBase &cb) |
bool | TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb) |
Static Public Member Functions | |
static TypeId | GetTypeId (void) |
Static Public Member Functions inherited from ns3::PropagationLossModel | |
static TypeId | GetTypeId (void) |
Static Public Member Functions inherited from ns3::Object | |
static TypeId | GetTypeId (void) |
Static Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
static void | Cleanup (void) |
Static Public Member Functions inherited from ns3::ObjectBase | |
static TypeId | GetTypeId (void) |
Private Member Functions | |
TwoRayGroundPropagationLossModel (const TwoRayGroundPropagationLossModel &o) | |
double | DbmFromW (double w) const |
double | DbmToW (double dbm) const |
virtual int64_t | DoAssignStreams (int64_t stream) |
virtual double | DoCalcRxPower (double txPowerDbm, Ptr< MobilityModel > a, Ptr< MobilityModel > b) const |
TwoRayGroundPropagationLossModel & | operator= (const TwoRayGroundPropagationLossModel &o) |
Private Attributes | |
double | m_frequency |
double | m_heightAboveZ |
double | m_lambda |
double | m_minDistance |
double | m_systemLoss |
Static Private Attributes | |
static const double | PI = 3.14159265358979323846 |
Additional Inherited Members | |
Protected Member Functions inherited from ns3::Object | |
Object (const Object &o) | |
virtual void | DoDispose (void) |
virtual void | DoInitialize (void) |
virtual void | NotifyNewAggregate (void) |
Protected Member Functions inherited from ns3::ObjectBase | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
virtual void | NotifyConstructionCompleted (void) |
a Two-Ray Ground propagation loss model ported from NS2
Two-ray ground reflection model.
The original equation in Rappaport's book assumes L = 1. To be consistent with the free space equation, L is added here.
Ht and Hr are set at the respective nodes z coordinate plus a model parameter set via SetHeightAboveZ.
The two-ray model does not give a good result for short distances, due to the oscillation caused by constructive and destructive combination of the two rays. Instead the Friis free-space model is used for small distances.
The crossover distance, below which Friis is used, is calculated as follows:
In the implementation, is calculated as , where m/s is the speed of light in vacuum, and is the frequency in Hz which can be configured by the user via the Frequency attribute.
ns3::TwoRayGroundPropagationLossModel is accessible through the following paths with Config::Set and Config::Connect:
No TraceSources are defined for this type.
Definition at line 266 of file propagation-loss-model.h.
|
privatevirtual |
Subclasses must implement this; those not using random variables can return zero
Implements ns3::PropagationLossModel.
Definition at line 445 of file propagation-loss-model.cc.
double ns3::TwoRayGroundPropagationLossModel::GetFrequency | ( | void | ) | const |
Definition at line 351 of file propagation-loss-model.cc.
double ns3::TwoRayGroundPropagationLossModel::GetMinDistance | ( | void | ) | const |
Definition at line 332 of file propagation-loss-model.cc.
double ns3::TwoRayGroundPropagationLossModel::GetSystemLoss | ( | void | ) | const |
Definition at line 322 of file propagation-loss-model.cc.
void ns3::TwoRayGroundPropagationLossModel::SetFrequency | ( | double | frequency | ) |
frequency | (Hz) |
Set the carrier frequency used in the TwoRayGround model calculation.
Definition at line 343 of file propagation-loss-model.cc.
void ns3::TwoRayGroundPropagationLossModel::SetHeightAboveZ | ( | double | heightAboveZ | ) |
heightAboveZ | the model antenna height above the node's Z coordinate |
Set the model antenna height above the node's Z coordinate
Definition at line 337 of file propagation-loss-model.cc.
void ns3::TwoRayGroundPropagationLossModel::SetMinDistance | ( | double | minDistance | ) |
minDistance | the minimum distance |
Below this distance, the txpower is returned unmodified as the rxpower.
Definition at line 327 of file propagation-loss-model.cc.
void ns3::TwoRayGroundPropagationLossModel::SetSystemLoss | ( | double | systemLoss | ) |
systemLoss | (dimension-less) |
Set the system loss used by the TwoRayGround propagation model.
Definition at line 317 of file propagation-loss-model.cc.