A Discrete-Event Network Simulator
API
ns3::SpectrumConverter Class Reference

Class which implements a converter between SpectrumValue which are defined over different SpectrumModel. More...

#include "spectrum-converter.h"

+ Inheritance diagram for ns3::SpectrumConverter:
+ Collaboration diagram for ns3::SpectrumConverter:

Public Member Functions

 SpectrumConverter (Ptr< const SpectrumModel > fromSpectrumModel, Ptr< const SpectrumModel > toSpectrumModel)
 Create a SpectrumConverter class that will be able to convert ValueVsFreq instances defined over one SpectrumModel to corresponding ValueVsFreq instances defined over a diffent SpectrumModel. More...
 
 SpectrumConverter ()
 
Ptr< SpectrumValueConvert (Ptr< const SpectrumValue > vvf) const
 Convert a particular ValueVsFreq instance to. More...
 
- Public Member Functions inherited from ns3::SimpleRefCount< SpectrumConverter >
 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...
 

Private Member Functions

double GetCoefficient (const BandInfo &from, const BandInfo &to) const
 Calculate the coefficient for value conversion between elements. More...
 

Private Attributes

std::vector< std::vector< double > > m_conversionMatrix
 matrix of conversion coefficients More...
 
Ptr< const SpectrumModelm_fromSpectrumModel
 the SpectrumModel this SpectrumConverter instance can convert from More...
 
Ptr< const SpectrumModelm_toSpectrumModel
 the SpectrumModel this SpectrumConverter instance can convert to More...
 

Additional Inherited Members

- Static Public Member Functions inherited from ns3::SimpleRefCount< SpectrumConverter >
static void Cleanup (void)
 Noop. More...
 

Detailed Description

Class which implements a converter between SpectrumValue which are defined over different SpectrumModel.

In more formal terms, this class allows conversion between different function spaces. In practical terms, this allows you to mix different spectrum representation within the same channel, such as a device using a coarse spectrum representation (e.g., one frequency for each IEEE 802.11 channel) and devices using a finer representation (e.g., one frequency for each OFDM subcarrier).

Definition at line 42 of file spectrum-converter.h.

Constructor & Destructor Documentation

ns3::SpectrumConverter::SpectrumConverter ( Ptr< const SpectrumModel fromSpectrumModel,
Ptr< const SpectrumModel toSpectrumModel 
)

Create a SpectrumConverter class that will be able to convert ValueVsFreq instances defined over one SpectrumModel to corresponding ValueVsFreq instances defined over a diffent SpectrumModel.

Parameters
fromSpectrumModelthe SpectrumModel to convert from
toSpectrumModelthe SpectrumModel to convert to

Definition at line 36 of file spectrum-converter.cc.

References ns3::SpectrumModel::Begin(), ns3::SpectrumModel::End(), GetCoefficient(), m_conversionMatrix, m_fromSpectrumModel, m_toSpectrumModel, NS_LOG_FUNCTION, and NS_LOG_LOGIC.

+ Here is the call graph for this function:

ns3::SpectrumConverter::SpectrumConverter ( )

Definition at line 32 of file spectrum-converter.cc.

Member Function Documentation

Ptr< SpectrumValue > ns3::SpectrumConverter::Convert ( Ptr< const SpectrumValue vvf) const

Convert a particular ValueVsFreq instance to.

Parameters
vvfthe ValueVsFreq instance to be converted
Returns
the converted version of the provided ValueVsFreq

Definition at line 74 of file spectrum-converter.cc.

References m_conversionMatrix, m_fromSpectrumModel, m_toSpectrumModel, NS_ASSERT, ns3::SpectrumValue::ValuesBegin(), and ns3::SpectrumValue::ValuesEnd().

Referenced by SpectrumConverterTestSuite::SpectrumConverterTestSuite().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

double ns3::SpectrumConverter::GetCoefficient ( const BandInfo from,
const BandInfo to 
) const
private

Calculate the coefficient for value conversion between elements.

Parameters
fromBandInfo to convert from
toBandInfo to convert to
Returns
the fraction of the value of the "from" BandInfos that is mapped to the "to" BandInfo

Definition at line 62 of file spectrum-converter.cc.

References ns3::BandInfo::fh, ns3::BandInfo::fl, max, min, and NS_LOG_FUNCTION.

Referenced by SpectrumConverter().

+ Here is the caller graph for this function:

Member Data Documentation

std::vector<std::vector<double> > ns3::SpectrumConverter::m_conversionMatrix
private

matrix of conversion coefficients

Definition at line 81 of file spectrum-converter.h.

Referenced by Convert(), and SpectrumConverter().

Ptr<const SpectrumModel> ns3::SpectrumConverter::m_fromSpectrumModel
private

the SpectrumModel this SpectrumConverter instance can convert from

Definition at line 82 of file spectrum-converter.h.

Referenced by Convert(), and SpectrumConverter().

Ptr<const SpectrumModel> ns3::SpectrumConverter::m_toSpectrumModel
private

the SpectrumModel this SpectrumConverter instance can convert to

Definition at line 83 of file spectrum-converter.h.

Referenced by Convert(), and SpectrumConverter().


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