Computes the channel condition for the V2V Highway scenario. More...
#include "three-gpp-v2v-channel-condition-model.h"
Public Member Functions | |
ThreeGppV2vHighwayChannelConditionModel () | |
Constructor for the ThreeGppV2vHighwayChannelConditionModel class. | |
~ThreeGppV2vHighwayChannelConditionModel () override | |
Destructor for the ThreeGppV2vHighwayChannelConditionModel class. | |
![]() | |
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. | |
![]() | |
ChannelConditionModel () | |
Constructor for the ChannelConditionModel class. | |
ChannelConditionModel (const ChannelConditionModel &)=delete | |
~ChannelConditionModel () override | |
Destructor for the ChannelConditionModel class. | |
ChannelConditionModel & | operator= (const ChannelConditionModel &)=delete |
![]() | |
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 final |
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, 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 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 TypeId | GetTypeId () |
Get the type ID. | |
![]() | |
static TypeId | GetTypeId () |
Register this type. | |
![]() | |
static TypeId | GetTypeId () |
Get the type ID. | |
Private Member Functions | |
double | ComputePlos (Ptr< const MobilityModel > a, Ptr< const MobilityModel > b) const override |
Compute the LOS probability as specified in Table Table 6.2-1 of 3GPP TR 37.885 for the V2V Highway scenario. | |
double | ComputePnlos (Ptr< const MobilityModel > a, Ptr< const MobilityModel > b) const override |
Compute the NLOS probability. | |
Ptr< ChannelCondition > | GetChCondAndFixCallback (Ptr< const MobilityModel > a, Ptr< const MobilityModel > b) |
Get the channel condition and redirect the callback ComputeChCond to GetChCondWithBuildings or to GetChCondWithNoBuildings depending on if there are buildings in the scenario or not. | |
Ptr< ChannelCondition > | GetChCondWithBuildings (Ptr< const MobilityModel > a, Ptr< const MobilityModel > b) const |
Get the channel condition between a and b using BuildingsChannelConditionModel. | |
Ptr< ChannelCondition > | GetChCondWithNoBuildings (Ptr< const MobilityModel > a, Ptr< const MobilityModel > b) const |
Get the channel condition between a and b . | |
Private Attributes | |
std::function< Ptr< ChannelCondition >(Ptr< const MobilityModel >, Ptr< const MobilityModel >)> | ComputeChCond |
The callback which is hooked to a method to compute channel condition. | |
Ptr< BuildingsChannelConditionModel > | m_buildingsCcm |
used to determine the obstructions due to buildings | |
Additional Inherited Members | |
![]() | |
enum | VehicleDensity { LOW , MEDIUM , HIGH , INVALID } |
Determine the density of vehicles in a V2V scenario. More... | |
![]() | |
void | DoDispose () override |
Destructor implementation. | |
![]() | |
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. | |
![]() | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
Complete construction of ObjectBase; invoked by derived classes. | |
virtual void | NotifyConstructionCompleted () |
Notifier called once the ObjectBase is fully constructed. | |
![]() | |
Ptr< UniformRandomVariable > | m_uniformVar |
uniform random variable | |
![]() | |
static TypeId | GetObjectIid () |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. | |
Computes the channel condition for the V2V Highway scenario.
Computes the channel condition following the specifications for the V2V Highway scenario reported in Table 6.2-1 of 3GPP TR 37.885.
3GPP TR 37.885 defines 3 different channel states for vehicular environments: LOS, NLOS and NLOSv, the latter representing the case in which the LOS path is blocked by other vehicles in the scenario. The document defines a probabilistic model to determine if the channel state is LOS or NLOSv, while the NLOS state is determined in a deterministic way based on the buildings deployed in the scenario. For this reason, this class makes use of an instance of BuildingsChannelConditionModel to determine if the LOS is obstructed by buildings or not.
ns3::ThreeGppV2vHighwayChannelConditionModel is accessible through the following paths with Config::Set and Config::Connect:
No Attributes are defined for this type.
Time
-9.22337e+18ns:+9.22337e+18ns No TraceSources are defined for this type.
Group: Buildings
Size of this type is 208 bytes (on a 64-bit architecture).
Definition at line 104 of file three-gpp-v2v-channel-condition-model.h.
ns3::ThreeGppV2vHighwayChannelConditionModel::ThreeGppV2vHighwayChannelConditionModel | ( | ) |
Constructor for the ThreeGppV2vHighwayChannelConditionModel class.
Definition at line 99 of file three-gpp-v2v-channel-condition-model.cc.
References ComputeChCond, ns3::CreateObject(), GetChCondAndFixCallback(), and m_buildingsCcm.
|
override |
Destructor for the ThreeGppV2vHighwayChannelConditionModel class.
Definition at line 109 of file three-gpp-v2v-channel-condition-model.cc.
|
overrideprivatevirtual |
Compute the LOS probability as specified in Table Table 6.2-1 of 3GPP TR 37.885 for the V2V Highway scenario.
a | tx mobility model |
b | rx mobility model |
Implements ns3::ThreeGppChannelConditionModel.
Definition at line 114 of file three-gpp-v2v-channel-condition-model.cc.
References ns3::ThreeGppChannelConditionModel::Calculate2dDistance(), ComputeChCond, NS_ASSERT_MSG, and NS_LOG_FUNCTION.
|
overrideprivatevirtual |
Compute the NLOS probability.
It determines the presence of obstructions between the tx and the rx based on the buildings deployed in the scenario. It returns 1 if the LOS path is obstructed, 0 otherwise.
a | tx mobility model |
b | rx mobility model |
Reimplemented from ns3::ThreeGppChannelConditionModel.
Definition at line 144 of file three-gpp-v2v-channel-condition-model.cc.
References ComputeChCond, NS_ASSERT_MSG, and NS_LOG_FUNCTION.
|
private |
Get the channel condition and redirect the callback ComputeChCond to GetChCondWithBuildings or to GetChCondWithNoBuildings depending on if there are buildings in the scenario or not.
a | tx mobility model |
b | rx mobility model |
a
and b
Definition at line 163 of file three-gpp-v2v-channel-condition-model.cc.
References ns3::BuildingList::Begin(), ComputeChCond, ns3::BuildingList::End(), GetChCondWithBuildings(), and GetChCondWithNoBuildings().
Referenced by ThreeGppV2vHighwayChannelConditionModel().
|
private |
Get the channel condition between a
and b
using BuildingsChannelConditionModel.
This method will be called for the scenarios with buildings
a | tx mobility model |
b | rx mobility model |
a
and b
Definition at line 188 of file three-gpp-v2v-channel-condition-model.cc.
References m_buildingsCcm.
Referenced by GetChCondAndFixCallback().
|
private |
Get the channel condition between a
and b
.
This method will be called for the scenarios without buildings
a | tx mobility model |
b | rx mobility model |
a
and b
Definition at line 196 of file three-gpp-v2v-channel-condition-model.cc.
References ns3::CreateObject(), ns3::ChannelCondition::LOS, and ns3::ChannelCondition::O2O.
Referenced by GetChCondAndFixCallback().
|
static |
Get the type ID.
Get the type ID.
Definition at line 90 of file three-gpp-v2v-channel-condition-model.cc.
References ns3::TypeId::SetParent().
Referenced by ThreeGppV2vBuildingsChCondModelTestCase::DoRun(), and ThreeGppV2vHighwayLosNlosvChCondModelTestCase::DoRun().
|
private |
The callback which is hooked to a method to compute channel condition.
This callback is implemented to make this model robust against the presence and absence of buildings in a highway scenario. If there are buildings in a scenario, this model will use BuildingsChannelConditionModel, which requires MobilityBuildingInfo aggregated to the nodes to compute LOS and NLOS. Otherwise, the callback is hooked to a local method GetChCondWithNoBuildings , which construct the ChannelCondtion object and set the condition to outdoor to outdoor with LOS.
Definition at line 160 of file three-gpp-v2v-channel-condition-model.h.
Referenced by ThreeGppV2vHighwayChannelConditionModel(), ComputePlos(), ComputePnlos(), and GetChCondAndFixCallback().
|
private |
used to determine the obstructions due to buildings
Definition at line 201 of file three-gpp-v2v-channel-condition-model.h.
Referenced by ThreeGppV2vHighwayChannelConditionModel(), and GetChCondWithBuildings().