A Discrete-Event Network Simulator
API
Loading...
Searching...
No Matches
ns3::SpectrumSignalParameters Struct Reference

This struct provides the generic signal representation to be used by all wireless technologies. More...

#include "spectrum-signal-parameters.h"

+ Inheritance diagram for ns3::SpectrumSignalParameters:
+ Collaboration diagram for ns3::SpectrumSignalParameters:

Public Member Functions

 SpectrumSignalParameters ()
 default constructor
 
 SpectrumSignalParameters (const SpectrumSignalParameters &p)
 copy constructor
 
virtual ~SpectrumSignalParameters ()
 destructor
 
virtual Ptr< SpectrumSignalParametersCopy () const
 make a "virtual" copy of this class, where "virtual" refers to the fact that if the actual object is a derived class of SpectrumSignalParameters, then the copy is also a derived class of the same type.
 
- Public Member Functions inherited from ns3::SimpleRefCount< SpectrumSignalParameters >
 SimpleRefCount ()
 Default constructor.
 
 SimpleRefCount (const SimpleRefCount &o)
 Copy constructor.
 
uint32_t GetReferenceCount () const
 Get the reference count of the object.
 
SimpleRefCountoperator= (const SimpleRefCount &o)
 Assignment operator.
 
void Ref () const
 Increment the reference count.
 
void Unref () const
 Decrement the reference count.
 

Public Attributes

Time duration
 The duration of the packet transmission.
 
Ptr< const ComplexMatrixArrayprecodingMatrix
 The 3D precoding matrix where the dimensions are: the number of TX ports, the number of TX streams, the number of RBs.
 
Ptr< SpectrumValuepsd
 The Power Spectral Density of the waveform, in linear units.
 
Ptr< const ComplexMatrixArrayspectrumChannelMatrix
 The 3D channel matrix where the dimensions are: the number of RX ports, the number of TX Ports, the number of resource blocks (RBs).
 
Ptr< AntennaModeltxAntenna
 The AntennaModel instance that was used to transmit this signal.
 
Ptr< SpectrumPhytxPhy
 The SpectrumPhy instance that is making the transmission.
 

Detailed Description

This struct provides the generic signal representation to be used by all wireless technologies.

Any specific wireless technology is allowed to define additional signal parameters by inheriting from this struct and providing additional member variables. This makes sure that a minimum set of parameters (in particular, the ones needed for interference calculation) is common across all wireless technologies, while at the same time allowing each technology to have its own specific signal parameters.

Furthermore, since the signal parameters specific of every technology inherit directly from this struct, each PHY can test (by using a dynamic cast) if a signal being received belongs to a given technology or not.

Note
when inheriting from this class, make sure that the assignment operator and the copy constructor work properly, making deep copies if needed.

Definition at line 52 of file spectrum-signal-parameters.h.

Constructor & Destructor Documentation

◆ SpectrumSignalParameters() [1/2]

ns3::SpectrumSignalParameters::SpectrumSignalParameters ( )

default constructor

Definition at line 33 of file spectrum-signal-parameters.cc.

References NS_LOG_FUNCTION.

◆ ~SpectrumSignalParameters()

ns3::SpectrumSignalParameters::~SpectrumSignalParameters ( )
virtual

destructor

Definition at line 38 of file spectrum-signal-parameters.cc.

References NS_LOG_FUNCTION.

◆ SpectrumSignalParameters() [2/2]

ns3::SpectrumSignalParameters::SpectrumSignalParameters ( const SpectrumSignalParameters p)

copy constructor

Parameters
pobject to copy

Definition at line 43 of file spectrum-signal-parameters.cc.

References ns3::SpectrumValue::Copy(), duration, NS_LOG_FUNCTION, precodingMatrix, psd, spectrumChannelMatrix, txAntenna, and txPhy.

+ Here is the call graph for this function:

Member Function Documentation

◆ Copy()

Ptr< SpectrumSignalParameters > ns3::SpectrumSignalParameters::Copy ( ) const
virtual

make a "virtual" copy of this class, where "virtual" refers to the fact that if the actual object is a derived class of SpectrumSignalParameters, then the copy is also a derived class of the same type.

Each class inheriting from SpectrumSignalParameters should override this method and use it to call the copy constructor of the derived class.

Returns
a copy of the (possibly derived) class

Reimplemented in ns3::LrWpanSpectrumSignalParameters, ns3::LteSpectrumSignalParameters, ns3::LteSpectrumSignalParametersDataFrame, ns3::LteSpectrumSignalParametersDlCtrlFrame, ns3::LteSpectrumSignalParametersUlSrsFrame, ns3::HalfDuplexIdealPhySignalParameters, and ns3::WifiSpectrumSignalParameters.

Definition at line 57 of file spectrum-signal-parameters.cc.

References NS_LOG_FUNCTION.

Member Data Documentation

◆ duration

Time ns3::SpectrumSignalParameters::duration

The duration of the packet transmission.

It is assumed that the Power Spectral Density remains constant for the whole duration of the transmission. In other words, all waveform have a rect shape with respect to time.

Definition at line 102 of file spectrum-signal-parameters.h.

Referenced by SpectrumSignalParameters().

◆ precodingMatrix

Ptr<const ComplexMatrixArray> ns3::SpectrumSignalParameters::precodingMatrix

The 3D precoding matrix where the dimensions are: the number of TX ports, the number of TX streams, the number of RBs.

Definition at line 126 of file spectrum-signal-parameters.h.

Referenced by SpectrumSignalParameters().

◆ psd

Ptr<SpectrumValue> ns3::SpectrumSignalParameters::psd

The Power Spectral Density of the waveform, in linear units.

The exact unit will depend on the type of transmission medium involved: W for radio communications, Pa for underwater acoustic communications. Other transmission media to be defined.

Note
when SpectrumSignalParameters is copied, only the pointer to the PSD will be copied. This is because SpectrumChannel objects normally overwrite the psd anyway, so there is no point in making a copy.

Definition at line 94 of file spectrum-signal-parameters.h.

Referenced by SpectrumSignalParameters(), and ComputeSnr().

◆ spectrumChannelMatrix

Ptr<const ComplexMatrixArray> ns3::SpectrumSignalParameters::spectrumChannelMatrix

The 3D channel matrix where the dimensions are: the number of RX ports, the number of TX Ports, the number of resource blocks (RBs).

Needed in the MIMO system in which multiple TX and RX ports can exist, hence the PSD is multidimensional. Elements are the complex numbers.

Definition at line 120 of file spectrum-signal-parameters.h.

Referenced by SpectrumSignalParameters().

◆ txAntenna

Ptr<AntennaModel> ns3::SpectrumSignalParameters::txAntenna

The AntennaModel instance that was used to transmit this signal.

Definition at line 112 of file spectrum-signal-parameters.h.

Referenced by SpectrumSignalParameters().

◆ txPhy

Ptr<SpectrumPhy> ns3::SpectrumSignalParameters::txPhy

The SpectrumPhy instance that is making the transmission.

Definition at line 107 of file spectrum-signal-parameters.h.

Referenced by SpectrumSignalParameters().


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