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

#include <spectrum-analyzer.h>

+ Inheritance diagram for ns3::SpectrumAnalyzer:

Public Member Functions

Ptr< NetDeviceGetDevice ()
 
Ptr< MobilityModelGetMobility ()
 
Ptr< AntennaModelGetRxAntenna ()
 
Ptr< const SpectrumModelGetRxSpectrumModel () const
 
void SetAntenna (Ptr< AntennaModel > a)
 
void SetChannel (Ptr< SpectrumChannel > c)
 
void SetDevice (Ptr< NetDevice > d)
 
void SetMobility (Ptr< MobilityModel > m)
 
void SetRxSpectrumModel (Ptr< SpectrumModel > m)
 
virtual void Start ()
 
void StartRx (Ptr< SpectrumSignalParameters > params)
 
virtual void Stop ()
 
- 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 (void)
 
- Static Public Member Functions inherited from ns3::SpectrumPhy
static TypeId GetTypeId (void)
 
- 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)
 

Protected Member Functions

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

Private Member Functions

void AddSignal (Ptr< const SpectrumValue > psd)
 
virtual void GenerateReport ()
 
void SubtractSignal (Ptr< const SpectrumValue > psd)
 
void UpdateEnergyReceivedSoFar ()
 

Private Attributes

bool m_active
 
Ptr< AntennaModelm_antenna
 
TracedCallback< Ptr< const
SpectrumValue > > 
m_averagePowerSpectralDensityReportTrace
 
Ptr< SpectrumChannelm_channel
 
Ptr< SpectrumValuem_energySpectralDensity
 
Time m_lastChangeTime
 
Ptr< MobilityModelm_mobility
 
Ptr< NetDevicem_netDevice
 
double m_noisePowerSpectralDensity
 
Time m_resolution
 
Ptr< SpectrumModelm_spectrumModel
 
Ptr< SpectrumValuem_sumPowerSpectralDensity
 

Detailed Description

Simple SpectrumPhy implemetation that averages the spectrum power density of incoming transmissions to produce a spectrogram.

This PHY model supports a single antenna model instance which is used for reception (this PHY model never transmits).

Doxygen introspection did not find any typical Config paths.

Attributes

  • Resolution: the lengh of the time interval over which the power spectral density of incoming signals is averaged
    • Set with class: TimeValue
    • Underlying type: Time
    • Initial value: +1000000.0ns
    • Flags: construct write read
  • NoisePowerSpectralDensity: the power spectral density of the measuring instrument noise, in Watt/Hz. Mostly useful to make spectrograms look more similar to those obtained by real devices. Defaults to the value for thermal noise at 300K.
    • Set with class: ns3::DoubleValue
    • Underlying type: double -1.79769e+308:1.79769e+308
    • Initial value: 4.14e-21
    • Flags: construct write read

TraceSources

  • AveragePowerSpectralDensityReport: Trace fired whenever a new value for the average Power Spectral Density is calculated

Definition at line 48 of file spectrum-analyzer.h.

Member Function Documentation

void ns3::SpectrumAnalyzer::DoDispose ( void  )
protectedvirtual

This method is called by Object::Dispose or by the object's destructor, whichever comes first.

Subclasses are expected to implement their real destruction code in an overriden 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 57 of file spectrum-analyzer.cc.

References ns3::Object::DoDispose(), and NS_LOG_FUNCTION.

Ptr< NetDevice > ns3::SpectrumAnalyzer::GetDevice ( )
virtual

get the associated NetDevice instance

Returns
a Ptr to the associated NetDevice instance

Implements ns3::SpectrumPhy.

Definition at line 96 of file spectrum-analyzer.cc.

Ptr< MobilityModel > ns3::SpectrumAnalyzer::GetMobility ( )
virtual

get the associated MobilityModel instance

Returns
a Ptr to the associated MobilityModel instance

Implements ns3::SpectrumPhy.

Definition at line 103 of file spectrum-analyzer.cc.

Ptr< AntennaModel > ns3::SpectrumAnalyzer::GetRxAntenna ( )
virtual

get the AntennaModel used by the NetDevice for reception

Returns
a Ptr to the AntennaModel used by the NetDevice for reception

Implements ns3::SpectrumPhy.

Definition at line 140 of file spectrum-analyzer.cc.

Ptr< const SpectrumModel > ns3::SpectrumAnalyzer::GetRxSpectrumModel ( ) const
virtual
Returns
returns the SpectrumModel that this SpectrumPhy expects to be used for all SpectrumValues that are passed to StartRx. If 0 is returned, it means that any model will be accepted.

Implements ns3::SpectrumPhy.

Definition at line 110 of file spectrum-analyzer.cc.

void ns3::SpectrumAnalyzer::SetAntenna ( Ptr< AntennaModel a)

set the AntennaModel to be used

Parameters
athe Antenna Model

Definition at line 146 of file spectrum-analyzer.cc.

References NS_LOG_FUNCTION.

void ns3::SpectrumAnalyzer::SetChannel ( Ptr< SpectrumChannel c)
virtual

Set the channel attached to this device.

Parameters
cthe channel

Implements ns3::SpectrumPhy.

Definition at line 132 of file spectrum-analyzer.cc.

References NS_LOG_FUNCTION.

void ns3::SpectrumAnalyzer::SetDevice ( Ptr< NetDevice d)
virtual

set the associated NetDevice instance

Parameters
dthe NetDevice instance

Implements ns3::SpectrumPhy.

Definition at line 116 of file spectrum-analyzer.cc.

References NS_LOG_FUNCTION.

void ns3::SpectrumAnalyzer::SetMobility ( Ptr< MobilityModel m)
virtual

Set the mobility model associated with this device.

Parameters
mthe mobility model

Implements ns3::SpectrumPhy.

Definition at line 124 of file spectrum-analyzer.cc.

References NS_LOG_FUNCTION.

void ns3::SpectrumAnalyzer::SetRxSpectrumModel ( Ptr< SpectrumModel m)

Set the spectrum model used by the SpectrumAnalyzer to represent incoming signals

Parameters
m

Definition at line 219 of file spectrum-analyzer.cc.

References NS_ASSERT, and NS_LOG_FUNCTION.

void ns3::SpectrumAnalyzer::Start ( void  )
virtual

Start the spectrum analyzer

Definition at line 233 of file spectrum-analyzer.cc.

References NS_LOG_FUNCTION, NS_LOG_LOGIC, and ns3::Simulator::Schedule().

void ns3::SpectrumAnalyzer::StartRx ( Ptr< SpectrumSignalParameters params)
virtual

Notify the SpectrumPhy instance of an incoming signal

Parameters
paramsthe parameters of the signals being received

Implements ns3::SpectrumPhy.

Definition at line 155 of file spectrum-analyzer.cc.

References NS_LOG_FUNCTION, and ns3::Simulator::Schedule().

void ns3::SpectrumAnalyzer::Stop ( void  )
virtual

Stop the spectrum analyzer

Definition at line 246 of file spectrum-analyzer.cc.


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