#include <radio-environment-map-helper.h>

Inheritance diagram for ns3::RadioEnvironmentMapHelper:

Collaboration diagram for ns3::RadioEnvironmentMapHelper:

Classes
struct	RemPoint

Public Member Functions
	RadioEnvironmentMapHelper ()
virtual	~RadioEnvironmentMapHelper ()
virtual void	DoDispose (void)
uint8_t	GetBandwidth () const
void	Install ()
void	SetBandwidth (uint8_t bw)
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
SimpleRefCount &	operator= (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 (void)
	This method returns the TypeId associated to ns3::RadioEnvironmentMapHelper.

Private Member Functions
void	DelayedInstall ()
void	Finalize ()
void	PrintAndReset ()
void	RunOneIteration (double xMin, double xMax, double yMin, double yMax)

Private Attributes
uint16_t	m_bandwidth
Ptr< SpectrumChannel >	m_channel
std::string	m_channelPath
uint16_t	m_earfcn
uint32_t	m_maxPointsPerIteration
double	m_noisePower
std::ofstream	m_outFile
std::string	m_outputFile
std::list< RemPoint >	m_rem
bool	m_stopWhenDone
double	m_xMax
double	m_xMin
uint16_t	m_xRes
double	m_xStep
double	m_yMax
double	m_yMin
uint16_t	m_yRes
double	m_yStep
double	m_z

Additional Inherited Members
Protected Member Functions inherited from ns3::Object
	Object (const Object &o)
virtual void	DoStart (void)
virtual void	NotifyNewAggregate (void)

Detailed Description

Generates a 2D map of the SINR from the strongest transmitter in the downlink of an LTE FDD system.

Definition at line 42 of file radio-environment-map-helper.h.

Constructor & Destructor Documentation

ns3::RadioEnvironmentMapHelper::RadioEnvironmentMapHelper ( )

Definition at line 50 of file radio-environment-map-helper.cc.

ns3::RadioEnvironmentMapHelper::~RadioEnvironmentMapHelper ( )

virtual

Definition at line 55 of file radio-environment-map-helper.cc.

Member Function Documentation

void ns3::RadioEnvironmentMapHelper::DelayedInstall ( )

private

Definition at line 198 of file radio-environment-map-helper.cc.

References ns3::SpectrumChannel::AddRx(), ns3::RadioEnvironmentMapHelper::RemPoint::bmm, Finalize(), ns3::LteSpectrumValueHelper::GetSpectrumModel(), m_bandwidth, m_channel, m_earfcn, m_maxPointsPerIteration, m_rem, m_xMax, m_xMin, m_xRes, m_xStep, m_yMax, m_yMin, m_yRes, m_yStep, NS_LOG_FUNCTION, ns3::RadioEnvironmentMapHelper::RemPoint::phy, RunOneIteration(), ns3::Simulator::Schedule(), ns3::Seconds(), ns3::RemSpectrumPhy::SetMobility(), ns3::RemSpectrumPhy::SetRxSpectrumModel(), and sample-rng-plot::x.

Referenced by Install().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::RadioEnvironmentMapHelper::DoDispose ( void )

virtual

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 62 of file radio-environment-map-helper.cc.

References NS_LOG_FUNCTION.

void ns3::RadioEnvironmentMapHelper::Finalize ( )

private

Definition at line 319 of file radio-environment-map-helper.cc.

References m_outFile, m_stopWhenDone, NS_LOG_FUNCTION, and ns3::Simulator::Stop().

Referenced by DelayedInstall().

Here is the call graph for this function:

Here is the caller graph for this function:

uint8_t ns3::RadioEnvironmentMapHelper::GetBandwidth ( ) const

Returns: the bandwidth (in num of RBs) over which SINR is calculated

Definition at line 141 of file radio-environment-map-helper.cc.

References m_bandwidth.

Referenced by GetTypeId().

Here is the caller graph for this function:

TypeId ns3::RadioEnvironmentMapHelper::GetTypeId ( void )

static

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

Attributes defined for this type:

ChannelPath: The path to the channel for which the Radio Environment Map is to be generated
- Set with class: StringValue
- Underlying type: std::string
- Initial value: /ChannelList/0
- Flags: construct write read
OutputFile: the filename to which the Radio Environment Map is saved
- Set with class: StringValue
- Underlying type: std::string
- Initial value: rem.out
- Flags: construct write read
XMin: The min x coordinate of the map.
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0
- Flags: construct write read
YMin: The min y coordinate of the map.
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0
- Flags: construct write read
XMax: The max x coordinate of the map.
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 1
- Flags: construct write read
YMax: The max y coordinate of the map.
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 1
- Flags: construct write read
XRes: The resolution (number of points) of the map along the x axis.
- Set with class: ns3::UintegerValue
- Underlying type: uint32_t 2:65535
- Initial value: 100
- Flags: construct write read
YRes: The resolution (number of points) of the map along the y axis.
- Set with class: ns3::UintegerValue
- Underlying type: uint16_t 2:65535
- Initial value: 100
- Flags: construct write read
Z: The value of the z coordinate for which the map is to be generated
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0
- Flags: construct write read
StopWhenDone: If true, Simulator::Stop () will be called as soon as the REM has been generated
- Set with class: BooleanValue
- Underlying type: bool
- Initial value: true
- Flags: construct write read
NoisePower: the power of the measuring instrument noise, in Watts. Default to a kT of -174 dBm with a noise figure of 9 dB and a bandwidth of 25 LTE Resource Blocks
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 1.423e-10
- Flags: construct write read
MaxPointsPerIteration: Maximum number of REM points to be calculated per iteration. Every point consumes approximately 5KB of memory.
- Set with class: ns3::UintegerValue
- Underlying type: uint32_t 1:4294967295
- Initial value: 20000
- Flags: construct write read
Earfcn: E-UTRA Absolute Radio Frequency Channel Number (EARFCN) as per 3GPP 36.101 Section 5.7.3.
- Set with class: ns3::UintegerValue
- Underlying type: uint16_t 0:65535
- Initial value: 100
- Flags: construct write read
Bandwidth: Transmission Bandwidth Configuration (in number of RBs) over which the SINR will be calculated
- Set with class: ns3::UintegerValue
- Underlying type: uint16_t 0:65535
- Initial value: 25
- Flags: construct write read