This model provides means for simulating the following propagation phenomena in the presence of buildings: More...
#include "buildings-propagation-loss-model.h"
Classes | |
class | ShadowingLoss |
This model allows the computation of shadowing loss. More... | |
Public Member Functions | |
BuildingsPropagationLossModel () | |
double | DoCalcRxPower (double txPowerDbm, Ptr< MobilityModel > a, Ptr< MobilityModel > b) const override |
PropagationLossModel. | |
virtual double | GetLoss (Ptr< MobilityModel > a, Ptr< MobilityModel > b) const =0 |
Public Member Functions inherited from ns3::PropagationLossModel | |
PropagationLossModel () | |
PropagationLossModel (const PropagationLossModel &)=delete | |
~PropagationLossModel () override | |
int64_t | AssignStreams (int64_t stream) |
If this loss model uses objects of type RandomVariableStream, set the stream numbers to the integers starting with the offset 'stream'. | |
double | CalcRxPower (double txPowerDbm, Ptr< MobilityModel > a, Ptr< MobilityModel > b) const |
Returns the Rx Power taking into account all the PropagationLossModel(s) chained to the current one. | |
Ptr< PropagationLossModel > | GetNext () |
Gets the next PropagationLossModel in the chain of loss models that act on the signal. | |
PropagationLossModel & | operator= (const PropagationLossModel &)=delete |
void | SetNext (Ptr< PropagationLossModel > next) |
Enables a chain of loss models to act on the signal. | |
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 () |
Get the type ID. | |
Static Public Member Functions inherited from ns3::PropagationLossModel | |
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. | |
Protected Member Functions | |
int64_t | DoAssignStreams (int64_t stream) override |
Assign a fixed random variable stream number to the random variables used by this model. | |
double | EvaluateSigma (Ptr< MobilityBuildingInfo > a, Ptr< MobilityBuildingInfo > b) const |
Calculate the Standard deviation of the normal distribution used to calculate the shadowing. | |
double | ExternalWallLoss (Ptr< MobilityBuildingInfo > a) const |
Calculate the external wall loss. | |
double | GetShadowing (Ptr< MobilityModel > a, Ptr< MobilityModel > b) const |
Calculate the shadowing loss. | |
double | HeightLoss (Ptr< MobilityBuildingInfo > n) const |
Calculate the height loss. | |
double | InternalWallsLoss (Ptr< MobilityBuildingInfo > a, Ptr< MobilityBuildingInfo > b) const |
Calculate the internal wall loss. | |
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. | |
Protected Attributes | |
double | m_lossInternalWall |
loss from internal walls (in dBm) | |
Ptr< NormalRandomVariable > | m_randVariable |
Random variable. | |
std::map< Ptr< MobilityModel >, std::map< Ptr< MobilityModel >, ShadowingLoss > > | m_shadowingLossMap |
Map of the shadowng loss. | |
double | m_shadowingSigmaExtWalls |
Standard deviation of the normal distribution used to calculate the shadowing due to ext walls. | |
double | m_shadowingSigmaIndoor |
Standard deviation of the normal distribution used to calculate the shadowing for indoor nodes. | |
double | m_shadowingSigmaOutdoor |
Standard deviation of the normal distribution used to calculate the shadowing for outdoor nodes. | |
Additional Inherited Members | |
Related Symbols inherited from ns3::ObjectBase | |
static TypeId | GetObjectIid () |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. | |
This model provides means for simulating the following propagation phenomena in the presence of buildings:
The distance-dependent component of propagation loss is deferred to derived classes which are expected to implement the GetLoss method.
ns3::BuildingsPropagationLossModel is accessible through the following paths with Config::Set and Config::Connect:
No TraceSources are defined for this type.
Group: Buildings
Size of this type is 152 bytes (on a 64-bit architecture).
Definition at line 46 of file buildings-propagation-loss-model.h.
ns3::BuildingsPropagationLossModel::BuildingsPropagationLossModel | ( | ) |
Definition at line 96 of file buildings-propagation-loss-model.cc.
References ns3::CreateObject(), and m_randVariable.
|
overrideprotectedvirtual |
Assign a fixed random variable stream number to the random variables used by this model.
Subclasses must implement this; those not using random variables can return zero.
stream | first stream index to use |
Implements ns3::PropagationLossModel.
Definition at line 222 of file buildings-propagation-loss-model.cc.
References m_randVariable.
|
overridevirtual |
txPowerDbm | current transmission power (in dBm) |
a | the mobility model of the source |
b | the mobility model of the destination |
Implements ns3::PropagationLossModel.
Definition at line 214 of file buildings-propagation-loss-model.cc.
References GetLoss(), and GetShadowing().
|
protected |
Calculate the Standard deviation of the normal distribution used to calculate the shadowing.
Definition at line 182 of file buildings-propagation-loss-model.cc.
References m_shadowingSigmaExtWalls, m_shadowingSigmaIndoor, and m_shadowingSigmaOutdoor.
Referenced by GetShadowing().
|
protected |
Calculate the external wall loss.
a | Building data |
Definition at line 102 of file buildings-propagation-loss-model.cc.
References ns3::Building::ConcreteWithoutWindows, ns3::Building::ConcreteWithWindows, ns3::Building::StoneBlocks, and ns3::Building::Wood.
Referenced by ns3::HybridBuildingsPropagationLossModel::GetLoss(), and ns3::OhBuildingsPropagationLossModel::GetLoss().
|
pure virtual |
a | the mobility model of the source |
b | the mobility model of the destination |
Implemented in ns3::HybridBuildingsPropagationLossModel, and ns3::OhBuildingsPropagationLossModel.
Referenced by DoCalcRxPower().
|
protected |
Calculate the shadowing loss.
Definition at line 146 of file buildings-propagation-loss-model.cc.
References EvaluateSigma(), m_randVariable, m_shadowingLossMap, and NS_ASSERT_MSG.
Referenced by DoCalcRxPower().
|
static |
Get the type ID.
Definition at line 56 of file buildings-propagation-loss-model.cc.
References m_lossInternalWall, m_shadowingSigmaExtWalls, m_shadowingSigmaIndoor, m_shadowingSigmaOutdoor, ns3::MakeDoubleAccessor(), ns3::MakeDoubleChecker(), and ns3::TypeId::SetParent().
|
protected |
Calculate the height loss.
n | Building data |
Definition at line 126 of file buildings-propagation-loss-model.cc.
Referenced by ns3::HybridBuildingsPropagationLossModel::GetLoss().
|
protected |
Calculate the internal wall loss.
Definition at line 136 of file buildings-propagation-loss-model.cc.
References m_lossInternalWall.
Referenced by ns3::HybridBuildingsPropagationLossModel::GetLoss(), and ns3::OhBuildingsPropagationLossModel::GetLoss().
|
protected |
loss from internal walls (in dBm)
Definition at line 97 of file buildings-propagation-loss-model.h.
Referenced by GetTypeId(), and InternalWallsLoss().
|
protected |
Random variable.
Definition at line 148 of file buildings-propagation-loss-model.h.
Referenced by BuildingsPropagationLossModel(), DoAssignStreams(), and GetShadowing().
|
mutableprotected |
Map of the shadowng loss.
Definition at line 130 of file buildings-propagation-loss-model.h.
Referenced by GetShadowing().
|
protected |
Standard deviation of the normal distribution used to calculate the shadowing due to ext walls.
Definition at line 141 of file buildings-propagation-loss-model.h.
Referenced by EvaluateSigma(), and GetTypeId().
|
protected |
Standard deviation of the normal distribution used to calculate the shadowing for indoor nodes.
Definition at line 147 of file buildings-propagation-loss-model.h.
Referenced by EvaluateSigma(), and GetTypeId().
|
protected |
Standard deviation of the normal distribution used to calculate the shadowing for outdoor nodes.
Definition at line 144 of file buildings-propagation-loss-model.h.
Referenced by EvaluateSigma(), and GetTypeId().