A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros 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:
+ Collaboration 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

 TraceFadingLossModel ()
virtual ~TraceFadingLossModel ()
int64_t AssignStreams (int64_t stream)
virtual void DoStart (void)
- Public Member Functions inherited from ns3::SpectrumPropagationLossModel
 SpectrumPropagationLossModel ()
virtual ~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
 Object ()
virtual ~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 Start (void)
- Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
 SimpleRefCount ()
 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
virtual ~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 ()
 This method returns the TypeId associated to ns3::TraceFadingLossModel.

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.
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 ()

Detailed Description

fading loss model based on precalculated fading traces

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

Member Typedef Documentation

The couple of mobility mnode that form a fading channel realization.

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

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.

Constructor & Destructor Documentation

ns3::TraceFadingLossModel::TraceFadingLossModel ( )

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

References NS_LOG_FUNCTION, and ns3::SpectrumPropagationLossModel::SetNext().

+ Here is the call graph for this function:

ns3::TraceFadingLossModel::~TraceFadingLossModel ( )
virtual

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

References m_fadingTrace, m_startVariableMap, and m_windowOffsetsMap.

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 221 of file trace-fading-loss-model.cc.

References m_startVariableMap, and NS_LOG_FUNCTION.

Ptr< SpectrumValue > ns3::TraceFadingLossModel::DoCalcRxPowerSpectralDensity ( Ptr< const SpectrumValue txPsd,
Ptr< const MobilityModel a,
Ptr< const MobilityModel b 
) const
private
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.

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

References ns3::Time::GetMilliSeconds(), ns3::Time::GetSeconds(), m_fadingTrace, m_lastWindowUpdate, m_startVariableMap, m_timeGranularity, m_traceLength, m_windowOffsetsMap, m_windowSize, ns3::Now(), ns3::Simulator::Now(), NS_ASSERT, NS_LOG_FUNCTION, NS_LOG_INFO, NS_LOG_LOGIC, ns3::ObjectBase::SetAttribute(), ns3::SpectrumValue::ValuesBegin(), and ns3::SpectrumValue::ValuesEnd().

+ Here is the call graph for this function:

void ns3::TraceFadingLossModel::DoStart ( void  )
virtual

This method is called only once by Object::Start. If the user calls Object::Start multiple times, DoStart 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.

References LoadTrace().

+ Here is the call graph for this function:

TypeId ns3::TraceFadingLossModel::GetTypeId ( void  )
static

This method returns the TypeId associated to ns3::TraceFadingLossModel.

Attributes defined for this type:

  • 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 defined for this type.

Reimplemented from ns3::SpectrumPropagationLossModel.

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

References m_rbNum, m_samplesNum, m_windowSize, ns3::Seconds(), ns3::TypeId::SetParent(), SetTraceFileName(), and SetTraceLength().

+ Here is the call graph for this function:

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
void ns3::TraceFadingLossModel::LoadTrace ( )
private

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

References ns3::Time::GetMilliSeconds(), m_fadingTrace, m_lastWindowUpdate, m_rbNum, m_samplesNum, m_timeGranularity, m_traceFile, m_traceLength, ns3::Now(), NS_ASSERT_MSG, NS_LOG_FUNCTION, and NS_LOG_INFO.

Referenced by DoStart().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::TraceFadingLossModel::SetTraceFileName ( std::string  fileName)
private

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

References m_traceFile, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

void ns3::TraceFadingLossModel::SetTraceLength ( Time  t)
private

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

References m_traceLength.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

Member Data Documentation

FadingTrace ns3::TraceFadingLossModel::m_fadingTrace
private
Time ns3::TraceFadingLossModel::m_lastWindowUpdate
mutableprivate

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

Referenced by DoCalcRxPowerSpectralDensity(), and LoadTrace().

uint8_t ns3::TraceFadingLossModel::m_rbNum
private

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

Referenced by GetTypeId(), and LoadTrace().

uint32_t ns3::TraceFadingLossModel::m_samplesNum
private

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

Referenced by GetTypeId(), and LoadTrace().

std::map<ChannelRealizationId_t, Ptr<UniformRandomVariable> > ns3::TraceFadingLossModel::m_startVariableMap
mutableprivate
uint8_t ns3::TraceFadingLossModel::m_timeGranularity
private

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

Referenced by DoCalcRxPowerSpectralDensity(), and LoadTrace().

std::string ns3::TraceFadingLossModel::m_traceFile
private

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

Referenced by LoadTrace(), and SetTraceFileName().

Time ns3::TraceFadingLossModel::m_traceLength
private
std::map<ChannelRealizationId_t, int > ns3::TraceFadingLossModel::m_windowOffsetsMap
mutableprivate
Time ns3::TraceFadingLossModel::m_windowSize
private

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

Referenced by DoCalcRxPowerSpectralDensity(), and GetTypeId().


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