A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
ns3::TraceFadingLossModel Class Reference

fading loss model based on precalculated fading traces More...

#include <trace-fading-loss-model.h>

+ Inheritance diagram for ns3::TraceFadingLossModel:

Public Types

typedef std::pair< Ptr< const
MobilityModel >, Ptr< const
MobilityModel > > 
ChannelRealizationId_t
 The couple of mobility mnode that form a fading channel realization.
 

Public Member Functions

int64_t AssignStreams (int64_t stream)
 
virtual void DoInitialize (void)
 
- Public Member Functions inherited from ns3::SpectrumPropagationLossModel
Ptr< SpectrumValueCalcRxPowerSpectralDensity (Ptr< const SpectrumValue > txPsd, Ptr< const MobilityModel > a, Ptr< const MobilityModel > b) const
 
void SetNext (Ptr< SpectrumPropagationLossModel > next)
 
- 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
 
SimpleRefCountoperator= (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 ()
 
- Static Public Member Functions inherited from ns3::SpectrumPropagationLossModel
static TypeId GetTypeId ()
 
- 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 Types

typedef std::vector
< FadingTraceSample
FadingTrace
 
typedef std::vector< double > FadingTraceSample
 

Private Member Functions

Ptr< SpectrumValueDoCalcRxPowerSpectralDensity (Ptr< const SpectrumValue > txPsd, Ptr< const MobilityModel > a, Ptr< const MobilityModel > b) const
 
double GetValue (int subChannel, double speed)
 Get the value for a particular sub channel and a given speed. More...
 
void LoadTrace ()
 
void SetTraceFileName (std::string fileName)
 
void SetTraceLength (Time t)
 

Private Attributes

FadingTrace m_fadingTrace
 
Time m_lastWindowUpdate
 
uint8_t m_rbNum
 
uint32_t m_samplesNum
 
std::map
< ChannelRealizationId_t, Ptr
< UniformRandomVariable > > 
m_startVariableMap
 
uint8_t m_timeGranularity
 
std::string m_traceFile
 
Time m_traceLength
 
std::map
< ChannelRealizationId_t, int > 
m_windowOffsetsMap
 
Time m_windowSize
 

Additional Inherited Members

- Protected Member Functions inherited from ns3::SpectrumPropagationLossModel
virtual void DoDispose ()
 
- Protected Member Functions inherited from ns3::Object
 Object (const Object &o)
 
virtual void NotifyNewAggregate (void)
 
- Protected Member Functions inherited from ns3::ObjectBase
void ConstructSelf (const AttributeConstructionList &attributes)
 
virtual void NotifyConstructionCompleted (void)
 

Detailed Description

fading loss model based on precalculated fading traces

Doxygen introspection did not find any typical Config paths.

Attributes

  • TraceFilename: Name of file to load a trace from.
    • Set with class: StringValue
    • Underlying type: std::string
    • Initial value:
    • Flags: construct write
  • TraceLength: The total length of the fading trace (default value 10 s.)
    • Set with class: TimeValue
    • Underlying type: Time
    • Initial value: +10000000000.0ns
    • Flags: construct write
  • SamplesNum: The number of samples the trace is made of (default 10000)
  • WindowSize: The size of the window for the fading trace (default value 0.5 s.)
    • Set with class: TimeValue
    • Underlying type: Time
    • Initial value: +500000000.0ns
    • Flags: construct write read
  • RbNum: The number of RB the trace is made of (default 100)

No TraceSources are defined for this type.

Definition at line 44 of file trace-fading-loss-model.h.

Member Typedef Documentation

Vector collecting the time fading traces in the frequency domain (per RB)

Definition at line 111 of file trace-fading-loss-model.h.

typedef std::vector<double> ns3::TraceFadingLossModel::FadingTraceSample
private

Vector with fading samples in time domain (for a fixed RB)

Definition at line 107 of file trace-fading-loss-model.h.

Member Function Documentation

int64_t ns3::TraceFadingLossModel::AssignStreams ( int64_t  stream)

Assign a fixed random variable stream number to the random variables used by this model. Return the number of streams (possibly zero) that have been assigned.

Parameters
streamfirst stream index to use
Returns
the number of stream indices assigned by this model

Definition at line 224 of file trace-fading-loss-model.cc.

References NS_LOG_FUNCTION.

Ptr< SpectrumValue > ns3::TraceFadingLossModel::DoCalcRxPowerSpectralDensity ( Ptr< const SpectrumValue txPsd,
Ptr< const MobilityModel a,
Ptr< const MobilityModel b 
) const
privatevirtual
Parameters
txPowerset of values vs frequency representing the transmission power. See SpectrumChannel for details.
asender mobility
breceiver mobility
Returns
set of values vs frequency representing the received power in the same units used for the txPower parameter.

Implements ns3::SpectrumPropagationLossModel.

Definition at line 144 of file trace-fading-loss-model.cc.

References ns3::Time::GetMilliSeconds(), ns3::Time::GetSeconds(), ns3::Simulator::Now(), NS_ASSERT, NS_LOG_FUNCTION, NS_LOG_INFO, NS_LOG_LOGIC, and ns3::ObjectBase::SetAttribute().

void ns3::TraceFadingLossModel::DoInitialize ( void  )
virtual

This method is called only once by Object::Initialize. If the user calls Object::Initialize multiple times, DoInitialize is called only the first time.

Subclasses are expected to override this method and chain up to their parent's implementation once they are done. It is safe to call GetObject and AggregateObject from within this method.

Reimplemented from ns3::Object.

Definition at line 106 of file trace-fading-loss-model.cc.

double ns3::TraceFadingLossModel::GetValue ( int  subChannel,
double  speed 
)
private

Get the value for a particular sub channel and a given speed.

Parameters
subChannelthe sub channel for which a value is requested
speedthe relative speed of the two devices
Returns
the loss for a particular sub channel

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