Base class for the 3GPP channel condition models. More...
#include "channel-condition-model.h"
Classes | |
struct | Item |
Struct to store the channel condition in the m_channelConditionMap. More... | |
Public Member Functions | |
ThreeGppChannelConditionModel () | |
Constructor for the ThreeGppRmaChannelConditionModel class. | |
~ThreeGppChannelConditionModel () override | |
Destructor for the ThreeGppRmaChannelConditionModel class. | |
int64_t | AssignStreams (int64_t stream) override |
If this model uses objects of type RandomVariableStream, set the stream numbers to the integers starting with the offset 'stream'. | |
Ptr< ChannelCondition > | GetChannelCondition (Ptr< const MobilityModel > a, Ptr< const MobilityModel > b) const override |
Retrieve the condition of the channel between a and b. | |
Public Member Functions inherited from ns3::ChannelConditionModel | |
ChannelConditionModel () | |
Constructor for the ChannelConditionModel class. | |
ChannelConditionModel (const ChannelConditionModel &)=delete | |
~ChannelConditionModel () override | |
Destructor for the ChannelConditionModel class. | |
ChannelConditionModel & | operator= (const ChannelConditionModel &)=delete |
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 double | Calculate2dDistance (const Vector &a, const Vector &b) |
Computes the 2D distance between two 3D vectors. | |
static std::tuple< double, double > | GetQuantizedElevationAngle (Ptr< const MobilityModel > a, Ptr< const MobilityModel > b) |
Computes and quantizes the elevation angle to a two-digits integer in [10, 90]. | |
static TypeId | GetTypeId () |
Get the type ID. | |
Static Public Member Functions inherited from ns3::ChannelConditionModel | |
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 Types | |
enum | VehicleDensity { LOW , MEDIUM , HIGH , INVALID } |
Determine the density of vehicles in a V2V scenario. More... | |
Protected Member Functions | |
void | DoDispose () override |
Destructor implementation. | |
Protected Member Functions inherited from ns3::Object | |
Object (const Object &o) | |
Copy an Object. | |
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 | |
Ptr< UniformRandomVariable > | m_uniformVar |
uniform random variable | |
Private Member Functions | |
Ptr< ChannelCondition > | ComputeChannelCondition (Ptr< const MobilityModel > a, Ptr< const MobilityModel > b) const |
This method computes the channel condition based on a probabilistic model that is specific for the scenario of interest. | |
virtual ChannelCondition::O2iConditionValue | ComputeO2i (Ptr< const MobilityModel > a, Ptr< const MobilityModel > b) const |
Determines whether the channel condition is O2I or O2O. | |
virtual double | ComputePlos (Ptr< const MobilityModel > a, Ptr< const MobilityModel > b) const =0 |
Compute the LOS probability. | |
virtual double | ComputePnlos (Ptr< const MobilityModel > a, Ptr< const MobilityModel > b) const |
Compute the NLOS probability. | |
Static Private Member Functions | |
static uint32_t | GetKey (Ptr< const MobilityModel > a, Ptr< const MobilityModel > b) |
Returns a unique and reciprocal key for the channel between a and b. | |
Private Attributes | |
std::unordered_map< uint32_t, Item > | m_channelConditionMap |
map to store the channel conditions | |
bool | m_linkO2iConditionToAntennaHeight |
the indicator that determines whether the O2I/O2O condition is determined based on the UE height | |
double | m_o2iLowLossThreshold {0} |
the threshold for determining what is the ratio of low - high O2I building penetration losses | |
double | m_o2iThreshold |
the threshold for determining what is the ratio of channels with O2I | |
Ptr< UniformRandomVariable > | m_uniformO2iLowHighLossVar |
a uniform random variable for the calculation of the low/high losses, see TR38.901 Table 7.4.3-2 | |
Ptr< UniformRandomVariable > | m_uniformVarO2i |
uniform random variable that is used for the generation of the O2i conditions | |
Time | m_updatePeriod |
the update period for the channel condition | |
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. | |
Base class for the 3GPP channel condition models.
Definition at line 431 of file channel-condition-model.h.
|
protected |
Determine the density of vehicles in a V2V scenario.
Enumerator | |
---|---|
LOW | |
MEDIUM | |
HIGH | |
INVALID |
Definition at line 503 of file channel-condition-model.h.
ns3::ThreeGppChannelConditionModel::ThreeGppChannelConditionModel | ( | ) |
Constructor for the ThreeGppRmaChannelConditionModel class.
Definition at line 372 of file channel-condition-model.cc.
References ns3::CreateObject(), m_uniformO2iLowHighLossVar, m_uniformVar, and m_uniformVarO2i.
|
override |
Destructor for the ThreeGppRmaChannelConditionModel class.
Definition at line 383 of file channel-condition-model.cc.
|
overridevirtual |
If this model uses objects of type RandomVariableStream, set the stream numbers to the integers starting with the offset 'stream'.
Return the number of streams (possibly zero) that have been assigned.
stream | the offset used to set the stream numbers |
Implements ns3::ChannelConditionModel.
Definition at line 542 of file channel-condition-model.cc.
References m_uniformO2iLowHighLossVar, m_uniformVar, and m_uniformVarO2i.
|
static |
Computes the 2D distance between two 3D vectors.
a | the first 3D vector |
b | the second 3D vector |
Definition at line 552 of file channel-condition-model.cc.
Referenced by ns3::ProbabilisticV2vHighwayChannelConditionModel::ComputePlos(), ns3::ProbabilisticV2vUrbanChannelConditionModel::ComputePlos(), ns3::ThreeGppIndoorMixedOfficeChannelConditionModel::ComputePlos(), ns3::ThreeGppIndoorOpenOfficeChannelConditionModel::ComputePlos(), ns3::ThreeGppRmaChannelConditionModel::ComputePlos(), ns3::ThreeGppUmaChannelConditionModel::ComputePlos(), ns3::ThreeGppUmiStreetCanyonChannelConditionModel::ComputePlos(), ns3::ThreeGppV2vHighwayChannelConditionModel::ComputePlos(), ns3::ThreeGppV2vUrbanChannelConditionModel::ComputePlos(), ns3::ProbabilisticV2vHighwayChannelConditionModel::ComputePnlos(), ns3::ProbabilisticV2vUrbanChannelConditionModel::ComputePnlos(), and anonymous_namespace{three-gpp-propagation-loss-model.cc}::GetBsUtDistancesAndHeights().
|
private |
This method computes the channel condition based on a probabilistic model that is specific for the scenario of interest.
a | tx mobility model |
b | rx mobility model |
Definition at line 476 of file channel-condition-model.cc.
References ComputeO2i(), ComputePlos(), ComputePnlos(), ns3::CreateObject(), ns3::ChannelCondition::HIGH, ns3::ChannelCondition::LOS, ns3::ChannelCondition::LOW, m_o2iLowLossThreshold, m_uniformO2iLowHighLossVar, m_uniformVar, ns3::ChannelCondition::NLOS, ns3::ChannelCondition::NLOSv, NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::ChannelCondition::O2I.
Referenced by GetChannelCondition().
|
privatevirtual |
Determines whether the channel condition is O2I or O2O.
a | tx mobility model |
b | rx mobility model |
Definition at line 444 of file channel-condition-model.cc.
References m_linkO2iConditionToAntennaHeight, m_o2iThreshold, m_uniformVarO2i, NS_LOG_INFO, ns3::ChannelCondition::O2I, and ns3::ChannelCondition::O2O.
Referenced by ComputeChannelCondition().
|
privatepure virtual |
Compute the LOS probability.
a | tx mobility model |
b | rx mobility model |
Implemented in ns3::ProbabilisticV2vHighwayChannelConditionModel, ns3::ProbabilisticV2vUrbanChannelConditionModel, ns3::ThreeGppIndoorMixedOfficeChannelConditionModel, ns3::ThreeGppIndoorOpenOfficeChannelConditionModel, ns3::ThreeGppNTNDenseUrbanChannelConditionModel, ns3::ThreeGppNTNRuralChannelConditionModel, ns3::ThreeGppNTNSuburbanChannelConditionModel, ns3::ThreeGppNTNUrbanChannelConditionModel, ns3::ThreeGppRmaChannelConditionModel, ns3::ThreeGppUmaChannelConditionModel, ns3::ThreeGppUmiStreetCanyonChannelConditionModel, ns3::ThreeGppV2vHighwayChannelConditionModel, and ns3::ThreeGppV2vUrbanChannelConditionModel.
Referenced by ComputeChannelCondition(), and ComputePnlos().
|
privatevirtual |
Compute the NLOS probability.
By default returns 1 - PLOS
a | tx mobility model |
b | rx mobility model |
Reimplemented in ns3::ProbabilisticV2vHighwayChannelConditionModel, ns3::ProbabilisticV2vUrbanChannelConditionModel, ns3::ThreeGppV2vHighwayChannelConditionModel, and ns3::ThreeGppV2vUrbanChannelConditionModel.
Definition at line 533 of file channel-condition-model.cc.
References ComputePlos(), and NS_LOG_FUNCTION.
Referenced by ComputeChannelCondition().
|
overrideprotectedvirtual |
Destructor implementation.
This method is called by Dispose() or by the Object's destructor, whichever comes first.
Subclasses are expected to implement their real destruction code in an overridden version of this method and chain up to their parent's implementation once they are done. i.e, for simplicity, the destructor of every subclass should be empty and its content should be moved to the associated DoDispose() method.
It is safe to call GetObject() from within this method.
Reimplemented from ns3::Object.
Definition at line 388 of file channel-condition-model.cc.
References m_channelConditionMap, m_updatePeriod, and ns3::Seconds().
|
overridevirtual |
Retrieve the condition of the channel between a and b.
If the channel condition does not exists, the method computes it by calling ComputeChannelCondition and stores it in a local cache, that will be updated following the "UpdatePeriod" parameter.
a | mobility model |
b | mobility model |
Implements ns3::ChannelConditionModel.
Definition at line 395 of file channel-condition-model.cc.
References ComputeChannelCondition(), GetKey(), ns3::Time::IsZero(), m_channelConditionMap, ns3::ThreeGppChannelConditionModel::Item::m_condition, ns3::ThreeGppChannelConditionModel::Item::m_generatedTime, m_updatePeriod, ns3::Simulator::Now(), and NS_LOG_DEBUG.
|
staticprivate |
Returns a unique and reciprocal key for the channel between a and b.
a | tx mobility model |
b | rx mobility model |
Definition at line 562 of file channel-condition-model.cc.
References ns3::Node::GetId().
Referenced by GetChannelCondition().
|
static |
Computes and quantizes the elevation angle to a two-digits integer in [10, 90].
Asserts that the provided mobility models are of the expected type, i.e., GeocentricConstantPositionMobilityModel, and that the quantized angle is in the expected range [10, 90].
a | mobility model |
b | mobility model |
Definition at line 576 of file channel-condition-model.cc.
References ns3::ConstCast(), ns3::DynamicCast(), and NS_ASSERT_MSG.
Referenced by ns3::ThreeGppNTNDenseUrbanChannelConditionModel::ComputePlos(), ns3::ThreeGppNTNRuralChannelConditionModel::ComputePlos(), ns3::ThreeGppNTNSuburbanChannelConditionModel::ComputePlos(), ns3::ThreeGppNTNUrbanChannelConditionModel::ComputePlos(), ns3::ThreeGppNTNDenseUrbanPropagationLossModel::GetLossLos(), ns3::ThreeGppNTNRuralPropagationLossModel::GetLossLos(), ns3::ThreeGppNTNSuburbanPropagationLossModel::GetLossLos(), ns3::ThreeGppNTNUrbanPropagationLossModel::GetLossLos(), ns3::ThreeGppNTNDenseUrbanPropagationLossModel::GetLossNlos(), ns3::ThreeGppNTNRuralPropagationLossModel::GetLossNlos(), ns3::ThreeGppNTNSuburbanPropagationLossModel::GetLossNlos(), ns3::ThreeGppNTNUrbanPropagationLossModel::GetLossNlos(), ns3::ThreeGppNTNDenseUrbanPropagationLossModel::GetShadowingStd(), ns3::ThreeGppNTNRuralPropagationLossModel::GetShadowingStd(), ns3::ThreeGppNTNSuburbanPropagationLossModel::GetShadowingStd(), and ns3::ThreeGppNTNUrbanPropagationLossModel::GetShadowingStd().
|
static |
Get the type ID.
Get the type ID.
Definition at line 334 of file channel-condition-model.cc.
References m_linkO2iConditionToAntennaHeight, m_o2iLowLossThreshold, m_o2iThreshold, m_updatePeriod, ns3::MakeBooleanAccessor(), ns3::MakeBooleanChecker(), ns3::MakeDoubleAccessor(), ns3::MakeDoubleChecker(), ns3::MakeTimeAccessor(), ns3::MakeTimeChecker(), ns3::MilliSeconds(), and ns3::TypeId::SetParent().
|
private |
map to store the channel conditions
Definition at line 571 of file channel-condition-model.h.
Referenced by DoDispose(), and GetChannelCondition().
|
private |
the indicator that determines whether the O2I/O2O condition is determined based on the UE height
Definition at line 578 of file channel-condition-model.h.
Referenced by ComputeO2i(), and GetTypeId().
|
private |
the threshold for determining what is the ratio of low - high O2I building penetration losses
Definition at line 576 of file channel-condition-model.h.
Referenced by ComputeChannelCondition(), and GetTypeId().
|
private |
the threshold for determining what is the ratio of channels with O2I
Definition at line 574 of file channel-condition-model.h.
Referenced by ComputeO2i(), and GetTypeId().
|
private |
a uniform random variable for the calculation of the low/high losses, see TR38.901 Table 7.4.3-2
Definition at line 584 of file channel-condition-model.h.
Referenced by ThreeGppChannelConditionModel(), AssignStreams(), and ComputeChannelCondition().
|
protected |
uniform random variable
Definition at line 511 of file channel-condition-model.h.
Referenced by ThreeGppChannelConditionModel(), AssignStreams(), and ComputeChannelCondition().
|
private |
uniform random variable that is used for the generation of the O2i conditions
Definition at line 581 of file channel-condition-model.h.
Referenced by ThreeGppChannelConditionModel(), AssignStreams(), and ComputeO2i().
|
private |
the update period for the channel condition
Definition at line 572 of file channel-condition-model.h.
Referenced by DoDispose(), GetChannelCondition(), and GetTypeId().