A Discrete-Event Network Simulator
API
ns3::BuildingsPropagationLossModel Class Referenceabstract

This model provides means for simulating the following propagation phenomena in the presence of buildings: More...

#include "buildings-propagation-loss-model.h"

+ Inheritance diagram for ns3::BuildingsPropagationLossModel:
+ Collaboration diagram for ns3::BuildingsPropagationLossModel:

Classes

class  ShadowingLoss
 

Public Member Functions

 BuildingsPropagationLossModel ()
 
virtual double DoCalcRxPower (double txPowerDbm, Ptr< MobilityModel > a, Ptr< MobilityModel > b) const
 Returns the Rx Power taking into account only the particular PropagatinLossModel. More...
 
virtual double GetLoss (Ptr< MobilityModel > a, Ptr< MobilityModel > b) const =0
 
- Public Member Functions inherited from ns3::PropagationLossModel
 PropagationLossModel ()
 
virtual ~PropagationLossModel ()
 
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'. More...
 
double CalcRxPower (double txPowerDbm, Ptr< MobilityModel > a, Ptr< MobilityModel > b) const
 Returns the Rx Power taking into account all the PropagatinLossModel(s) chained to the current one. More...
 
Ptr< PropagationLossModelGetNext ()
 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
 Object ()
 Constructor. More...
 
virtual ~Object ()
 Destructor. More...
 
void AggregateObject (Ptr< Object > other)
 Aggregate two Objects together. More...
 
void Dispose (void)
 Dispose of this Object. More...
 
AggregateIterator GetAggregateIterator (void) const
 Get an iterator to the Objects aggregated to this one. More...
 
virtual TypeId GetInstanceTypeId (void) const
 Implement the GetInstanceTypeId method defined in ObjectBase. More...
 
template<typename T >
Ptr< T > GetObject (void) const
 Get a pointer to the requested aggregated Object. More...
 
template<typename T >
Ptr< T > GetObject (TypeId tid) const
 Get a pointer to the requested aggregated Object by TypeId. More...
 
void Initialize (void)
 Invoke DoInitialize on all Objects aggregated to this one. More...
 
bool IsInitialized (void) const
 Check if the object has been initialized. More...
 
- Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
 SimpleRefCount ()
 Constructor. More...
 
 SimpleRefCount (const SimpleRefCount &o)
 Copy constructor. More...
 
uint32_t GetReferenceCount (void) const
 Get the reference count of the object. More...
 
SimpleRefCountoperator= (const SimpleRefCount &o)
 Assignment. More...
 
void Ref (void) const
 Increment the reference count. More...
 
void Unref (void) const
 Decrement the reference count. More...
 
- Public Member Functions inherited from ns3::ObjectBase
virtual ~ObjectBase ()
 Virtual destructor. More...
 
void GetAttribute (std::string name, AttributeValue &value) const
 Get the value of an attribute, raising fatal errors if unsuccessful. More...
 
bool GetAttributeFailSafe (std::string name, AttributeValue &value) const
 Get the value of an attribute without raising erros. More...
 
void SetAttribute (std::string name, const AttributeValue &value)
 Set a single attribute, raising fatal errors if unsuccessful. More...
 
bool SetAttributeFailSafe (std::string name, const AttributeValue &value)
 Set a single attribute without raising errors. More...
 
bool TraceConnect (std::string name, std::string context, const CallbackBase &cb)
 Connect a TraceSource to a Callback with a context. More...
 
bool TraceConnectWithoutContext (std::string name, const CallbackBase &cb)
 Connect a TraceSource to a Callback without a context. More...
 
bool TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)
 Disconnect from a TraceSource a Callback previously connected with a context. More...
 
bool TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)
 Disconnect from a TraceSource a Callback previously connected without a context. More...
 

Static Public Member Functions

static TypeId GetTypeId (void)
 
- Static Public Member Functions inherited from ns3::PropagationLossModel
static TypeId GetTypeId (void)
 Get the type ID. More...
 
- Static Public Member Functions inherited from ns3::Object
static TypeId GetTypeId (void)
 Register this type. More...
 
- Static Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
static void Cleanup (void)
 Noop. More...
 
- Static Public Member Functions inherited from ns3::ObjectBase
static TypeId GetTypeId (void)
 Get the type ID. More...
 

Protected Member Functions

virtual int64_t DoAssignStreams (int64_t stream)
 Subclasses must implement this; those not using random variables can return zero. More...
 
double EvaluateSigma (Ptr< MobilityBuildingInfo > a, Ptr< MobilityBuildingInfo > b) const
 
double ExternalWallLoss (Ptr< MobilityBuildingInfo > a) const
 
double GetShadowing (Ptr< MobilityModel > a, Ptr< MobilityModel > b) const
 
double HeightLoss (Ptr< MobilityBuildingInfo > n) const
 
double InternalWallsLoss (Ptr< MobilityBuildingInfo > a, Ptr< MobilityBuildingInfo > b) const
 
- Protected Member Functions inherited from ns3::Object
 Object (const Object &o)
 Copy an Object. More...
 
virtual void DoDispose (void)
 Destructor implementation. More...
 
virtual void DoInitialize (void)
 Initialize() implementation. More...
 
virtual void NotifyNewAggregate (void)
 Notify all Objects aggregated to this one of a new Object being aggregated. More...
 
- Protected Member Functions inherited from ns3::ObjectBase
void ConstructSelf (const AttributeConstructionList &attributes)
 Complete construction of ObjectBase; invoked by derived classes. More...
 
virtual void NotifyConstructionCompleted (void)
 Notifier called once the ObjectBase is fully constructed. More...
 

Protected Attributes

double m_lossInternalWall
 
Ptr< NormalRandomVariablem_randVariable
 
std::map< Ptr< MobilityModel >, std::map< Ptr< MobilityModel >, ShadowingLoss > > m_shadowingLossMap
 
double m_shadowingSigmaExtWalls
 
double m_shadowingSigmaIndoor
 
double m_shadowingSigmaOutdoor
 

Additional Inherited Members

Detailed Description

This model provides means for simulating the following propagation phenomena in the presence of buildings:

  • shadowing (indoor, outdoor)
  • external wall penetration loss
  • internal wall penetration loss

The distance-dependent component of propagation loss is deferred to derived classes which are expected to implement the GetLoss method.

Warning
This model works only when MobilityBuildingInfo is aggreegated to the mobility model

Config Paths

ns3::BuildingsPropagationLossModel is accessible through the following paths with Config::Set and Config::Connect:

  • "/NodeList/[i]/DeviceList/[i]/$ns3::WifiNetDevice/Channel/$ns3::YansWifiChannel/PropagationLossModel/$ns3::BuildingsPropagationLossModel"
  • "/NodeList/[i]/DeviceList/[i]/$ns3::WaveNetDevice/Channel/$ns3::YansWifiChannel/PropagationLossModel/$ns3::BuildingsPropagationLossModel"
  • "/ChannelList/[i]/$ns3::WifiChannel/$ns3::YansWifiChannel/PropagationLossModel/$ns3::BuildingsPropagationLossModel"
  • "/ChannelList/[i]/$ns3::YansWifiChannel/PropagationLossModel/$ns3::BuildingsPropagationLossModel"

Attributes

  • ShadowSigmaOutdoor: Standard deviation of the normal distribution used for calculate the shadowing for outdoor nodes
    • Set with class: ns3::DoubleValue
    • Underlying type: double -1.79769e+308:1.79769e+308
    • Initial value: 7
    • Flags: construct write read
  • ShadowSigmaIndoor: Standard deviation of the normal distribution used for calculate the shadowing for indoor nodes
    • Set with class: ns3::DoubleValue
    • Underlying type: double -1.79769e+308:1.79769e+308
    • Initial value: 8
    • Flags: construct write read
  • ShadowSigmaExtWalls: Standard deviation of the normal distribution used for calculate the shadowing due to ext walls
    • Set with class: ns3::DoubleValue
    • Underlying type: double -1.79769e+308:1.79769e+308
    • Initial value: 5
    • Flags: construct write read
  • InternalWallLoss: Additional loss for each internal wall [dB]
    • Set with class: ns3::DoubleValue
    • Underlying type: double -1.79769e+308:1.79769e+308
    • Initial value: 5
    • Flags: construct write read

No TraceSources are defined for this type.
Size of this type is 128 bytes (on a 64-bit architecture).

Definition at line 57 of file buildings-propagation-loss-model.h.

Constructor & Destructor Documentation

ns3::BuildingsPropagationLossModel::BuildingsPropagationLossModel ( )

Definition at line 98 of file buildings-propagation-loss-model.cc.

References m_randVariable.

Member Function Documentation

int64_t ns3::BuildingsPropagationLossModel::DoAssignStreams ( int64_t  stream)
protectedvirtual

Subclasses must implement this; those not using random variables can return zero.

Implements ns3::PropagationLossModel.

Definition at line 223 of file buildings-propagation-loss-model.cc.

References m_randVariable.

double ns3::BuildingsPropagationLossModel::DoCalcRxPower ( double  txPowerDbm,
Ptr< MobilityModel a,
Ptr< MobilityModel b 
) const
virtual

Returns the Rx Power taking into account only the particular PropagatinLossModel.

Parameters
txPowerDbmcurrent transmission power (in dBm)
athe mobility model of the source
bthe mobility model of the destination
Returns
the reception power after adding/multiplying propagation loss (in dBm)

Implements ns3::PropagationLossModel.

Definition at line 217 of file buildings-propagation-loss-model.cc.

References GetLoss(), and GetShadowing().

Referenced by BuildingsShadowingTestCase::DoRun().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

double ns3::BuildingsPropagationLossModel::EvaluateSigma ( Ptr< MobilityBuildingInfo a,
Ptr< MobilityBuildingInfo b 
) const
protected

Definition at line 188 of file buildings-propagation-loss-model.cc.

References m_shadowingSigmaExtWalls, m_shadowingSigmaIndoor, and m_shadowingSigmaOutdoor.

Referenced by GetShadowing().

+ Here is the caller graph for this function:

double ns3::BuildingsPropagationLossModel::ExternalWallLoss ( Ptr< MobilityBuildingInfo a) const
protected
virtual double ns3::BuildingsPropagationLossModel::GetLoss ( Ptr< MobilityModel a,
Ptr< MobilityModel b 
) const
pure virtual
Parameters
athe mobility model of the source
bthe mobility model of the destination
Returns
the propagation loss (in dBm)

Implemented in ns3::HybridBuildingsPropagationLossModel, and ns3::OhBuildingsPropagationLossModel.

Referenced by DoCalcRxPower(), and GetShadowing().

+ Here is the caller graph for this function:

double ns3::BuildingsPropagationLossModel::GetShadowing ( Ptr< MobilityModel a,
Ptr< MobilityModel b 
) const
protected

Definition at line 149 of file buildings-propagation-loss-model.cc.

References EvaluateSigma(), GetLoss(), ns3::Object::GetObject(), m_randVariable, m_shadowingLossMap, and NS_ASSERT_MSG.

Referenced by DoCalcRxPower().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

TypeId ns3::BuildingsPropagationLossModel::GetTypeId ( void  )
static
double ns3::BuildingsPropagationLossModel::HeightLoss ( Ptr< MobilityBuildingInfo n) const
protected

Definition at line 128 of file buildings-propagation-loss-model.cc.

Referenced by ns3::HybridBuildingsPropagationLossModel::GetLoss().

+ Here is the caller graph for this function:

double ns3::BuildingsPropagationLossModel::InternalWallsLoss ( Ptr< MobilityBuildingInfo a,
Ptr< MobilityBuildingInfo b 
) const
protected

Definition at line 138 of file buildings-propagation-loss-model.cc.

References m_lossInternalWall.

Referenced by ns3::OhBuildingsPropagationLossModel::GetLoss(), and ns3::HybridBuildingsPropagationLossModel::GetLoss().

+ Here is the caller graph for this function:

Member Data Documentation

double ns3::BuildingsPropagationLossModel::m_lossInternalWall
protected

Definition at line 81 of file buildings-propagation-loss-model.h.

Referenced by GetTypeId(), and InternalWallsLoss().

Ptr<NormalRandomVariable> ns3::BuildingsPropagationLossModel::m_randVariable
protected
std::map<Ptr<MobilityModel>, std::map<Ptr<MobilityModel>, ShadowingLoss> > ns3::BuildingsPropagationLossModel::m_shadowingLossMap
mutableprotected

Definition at line 96 of file buildings-propagation-loss-model.h.

Referenced by GetShadowing().

double ns3::BuildingsPropagationLossModel::m_shadowingSigmaExtWalls
protected

Definition at line 100 of file buildings-propagation-loss-model.h.

Referenced by EvaluateSigma(), and GetTypeId().

double ns3::BuildingsPropagationLossModel::m_shadowingSigmaIndoor
protected

Definition at line 102 of file buildings-propagation-loss-model.h.

Referenced by EvaluateSigma(), and GetTypeId().

double ns3::BuildingsPropagationLossModel::m_shadowingSigmaOutdoor
protected

Definition at line 101 of file buildings-propagation-loss-model.h.

Referenced by EvaluateSigma(), and GetTypeId().


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