This class is an ns-3 trace sink that performs the calculation of PDU statistics for uplink and downlink. More...

#include "radio-bearer-stats-calculator.h"

Inheritance diagram for ns3::RadioBearerStatsCalculator:

Public Member Functions
	RadioBearerStatsCalculator ()
	Class constructor. More...

	RadioBearerStatsCalculator (std::string protocolType)
	Class constructor. More...

virtual	~RadioBearerStatsCalculator ()
	Class destructor. More...

void	DlRxPdu (uint16_t cellId, uint64_t imsi, uint16_t rnti, uint8_t lcid, uint32_t packetSize, uint64_t delay)
	Notifies the stats calculator that an downlink reception has occurred. More...

void	DlTxPdu (uint16_t cellId, uint64_t imsi, uint16_t rnti, uint8_t lcid, uint32_t packetSize)
	Notifies the stats calculator that an downlink transmission has occurred. More...

void	DoDispose ()
	Destructor implementation. More...

uint32_t	GetDlCellId (uint64_t imsi, uint8_t lcid)
	Gets the attached Enb cellId. More...

double	GetDlDelay (uint64_t imsi, uint8_t lcid)
	Gets the downlink RLC to RLC delay. More...

std::vector< double >	GetDlDelayStats (uint64_t imsi, uint8_t lcid)
	Gets the downlink RLC to RLC statistics: average, min, max and standard deviation. More...

std::string	GetDlOutputFilename (void)
	Get the name of the file where the downlink statistics will be stored. More...

std::string	GetDlPdcpOutputFilename (void)
	Get the name of the file where the downlink PDCP statistics will be stored. More...

std::vector< double >	GetDlPduSizeStats (uint64_t imsi, uint8_t lcid)
	Gets the downlink PDU size statistics: average, min, max and standard deviation. More...

uint64_t	GetDlRxData (uint64_t imsi, uint8_t lcid)
	Gets the number of received downlink data bytes. More...

uint32_t	GetDlRxPackets (uint64_t imsi, uint8_t lcid)
	Gets the number of received downlink data bytes. More...

uint64_t	GetDlTxData (uint64_t imsi, uint8_t lcid)
	Gets the number of transmitted downlink data bytes. More...

uint32_t	GetDlTxPackets (uint64_t imsi, uint8_t lcid)
	Gets the number of transmitted downlink data bytes. More...

Time	GetEpoch () const

Time	GetStartTime () const

uint32_t	GetUlCellId (uint64_t imsi, uint8_t lcid)
	Gets the attached Enb cellId. More...

double	GetUlDelay (uint64_t imsi, uint8_t lcid)
	Gets the uplink RLC to RLC delay. More...

std::vector< double >	GetUlDelayStats (uint64_t imsi, uint8_t lcid)
	Gets the uplink RLC to RLC statistics: average, min, max and standard deviation. More...

std::string	GetUlOutputFilename (void)
	Get the name of the file where the uplink statistics will be stored. More...

std::string	GetUlPdcpOutputFilename (void)
	Get the name of the file where the uplink PDCP statistics will be stored. More...

std::vector< double >	GetUlPduSizeStats (uint64_t imsi, uint8_t lcid)
	Gets the uplink PDU size statistics: average, min, max and standard deviation. More...

uint64_t	GetUlRxData (uint64_t imsi, uint8_t lcid)
	Gets the number of received uplink data bytes. More...

uint32_t	GetUlRxPackets (uint64_t imsi, uint8_t lcid)
	Gets the number of received uplink packets. More...

uint64_t	GetUlTxData (uint64_t imsi, uint8_t lcid)
	Gets the number of transmitted uplink data bytes. More...

uint32_t	GetUlTxPackets (uint64_t imsi, uint8_t lcid)
	Gets the number of transmitted uplink packets. More...

void	SetDlPdcpOutputFilename (std::string outputFilename)
	Set the name of the file where the downlink PDCP statistics will be stored. More...

void	SetEpoch (Time e)

void	SetStartTime (Time t)

void	SetUlPdcpOutputFilename (std::string outputFilename)
	Set the name of the file where the uplink PDCP statistics will be stored. More...

void	UlRxPdu (uint16_t cellId, uint64_t imsi, uint16_t rnti, uint8_t lcid, uint32_t packetSize, uint64_t delay)
	Notifies the stats calculator that an uplink reception has occurred. More...

void	UlTxPdu (uint16_t cellId, uint64_t imsi, uint16_t rnti, uint8_t lcid, uint32_t packetSize)
	Notifies the stats calculator that an uplink transmission has occurred. More...

Public Member Functions inherited from ns3::LteStatsCalculator
	LteStatsCalculator ()
	Constructor. More...

virtual	~LteStatsCalculator ()
	Destructor. More...

bool	ExistsCellIdPath (std::string path)
	Checks if there is an already stored cell id for the given path. More...

bool	ExistsImsiPath (std::string path)
	Checks if there is an already stored IMSI for the given path. More...

uint16_t	GetCellIdPath (std::string path)
	Retrieves the cell id information for the given path. More...

std::string	GetDlOutputFilename (void)
	Get the name of the file where the downlink statistics will be stored. More...

uint64_t	GetImsiPath (std::string path)
	Retrieves the imsi information for the given path. More...

std::string	GetUlOutputFilename (void)
	Get the name of the file where the uplink statistics will be stored. More...

void	SetCellIdPath (std::string path, uint16_t cellId)
	Stores the (path, cellId) pairs in a map. More...

void	SetDlOutputFilename (std::string outputFilename)
	Set the name of the file where the downlink statistics will be stored. More...

void	SetImsiPath (std::string path, uint64_t imsi)
	Stores the (path, imsi) pairs in a map. More...

void	SetUlOutputFilename (std::string outputFilename)
	Set the name of the file where the uplink statistics will be stored. More...

Public Member Functions inherited from ns3::Object
	Object ()
	Constructor. More...

virtual	~Object ()
	Destructor. More...

void	AggregateObject (Ptr< Object > other)
	Aggregate two Objects together. More...

void	Dispose (void)
	Dispose of this Object. More...

AggregateIterator	GetAggregateIterator (void) const
	Get an iterator to the Objects aggregated to this one. More...

virtual TypeId	GetInstanceTypeId (void) const
	Get the most derived TypeId for this Object. More...

template<typename T >
Ptr< T >	GetObject (void) const
	Get a pointer to the requested aggregated Object. More...

template<typename T >
Ptr< T >	GetObject (TypeId tid) const
	Get a pointer to the requested aggregated Object by TypeId. More...

void	Initialize (void)
	Invoke DoInitialize on all Objects aggregated to this one. More...

bool	IsInitialized (void) const
	Check if the object has been initialized. More...

Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
	SimpleRefCount ()
	Default constructor. More...

	SimpleRefCount (const SimpleRefCount &o)
	Copy constructor. More...

uint32_t	GetReferenceCount (void) const
	Get the reference count of the object. More...

SimpleRefCount &	operator= (const SimpleRefCount &o)
	Assignment operator. More...

void	Ref (void) const
	Increment the reference count. More...

void	Unref (void) const
	Decrement the reference count. More...

Public Member Functions inherited from ns3::ObjectBase
virtual	~ObjectBase ()
	Virtual destructor. More...

void	GetAttribute (std::string name, AttributeValue &value) const
	Get the value of an attribute, raising fatal errors if unsuccessful. More...

bool	GetAttributeFailSafe (std::string name, AttributeValue &value) const
	Get the value of an attribute without raising erros. More...

void	SetAttribute (std::string name, const AttributeValue &value)
	Set a single attribute, raising fatal errors if unsuccessful. More...

bool	SetAttributeFailSafe (std::string name, const AttributeValue &value)
	Set a single attribute without raising errors. More...

bool	TraceConnect (std::string name, std::string context, const CallbackBase &cb)
	Connect a TraceSource to a Callback with a context. More...

bool	TraceConnectWithoutContext (std::string name, const CallbackBase &cb)
	Connect a TraceSource to a Callback without a context. More...

bool	TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)
	Disconnect from a TraceSource a Callback previously connected with a context. More...

bool	TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)
	Disconnect from a TraceSource a Callback previously connected without a context. More...

Static Public Member Functions
static TypeId	GetTypeId (void)
	Register this type. More...

Static Public Member Functions inherited from ns3::LteStatsCalculator
static TypeId	GetTypeId (void)
	Register this type. More...

Static Public Member Functions inherited from ns3::Object
static TypeId	GetTypeId (void)
	Register this type. More...

Static Public Member Functions inherited from ns3::ObjectBase
static TypeId	GetTypeId (void)
	Get the type ID. More...

Private Member Functions
void	EndEpoch (void)
	Function called in every endEpochEvent. More...

void	RescheduleEndEpoch ()
	Reschedules EndEpoch event. More...

void	ResetResults (void)
	Erases collected statistics. More...

void	ShowResults (void)
	Called after each epoch to write collected statistics to output files. More...

void	WriteDlResults (std::ofstream &outFile)
	Writes collected statistics to DL output file and closes DL output file. More...

void	WriteUlResults (std::ofstream &outFile)
	Writes collected statistics to UL output file and closes UL output file. More...

Private Attributes
Uint32Map	m_dlCellId
	List of DL CellIds by (IMSI, LCID) pair. More...

Uint64StatsMap	m_dlDelay
	DL delay by (IMSI, LCID) pair. More...

std::string	m_dlPdcpOutputFilename
	Name of the file where the downlink PDCP statistics will be saved. More...

Uint32StatsMap	m_dlPduSize
	DL PDU Size by (IMSI, LCID) pair. More...

Uint64Map	m_dlRxData
	Amount of DL RX Data by (IMSI, LCID) pair. More...

Uint32Map	m_dlRxPackets
	Number of DL RX Packets by (IMSI, LCID) pair. More...

Uint64Map	m_dlTxData
	Amount of DL TX Data by (IMSI, LCID) pair. More...

Uint32Map	m_dlTxPackets
	Number of DL TX Packets by (IMSI, LCID) pair. More...

EventId	m_endEpochEvent
	Event id for next end epoch event. More...

Time	m_epochDuration
	Epoch duration. More...

bool	m_firstWrite
	true if output files have not been opened yet More...

FlowIdMap	m_flowId
	List of FlowIds, ie. More...

bool	m_pendingOutput
	true if any output is pending More...

std::string	m_protocolType
	Protocol type, by default RLC. More...

Time	m_startTime
	Start time of the on going epoch. More...

Uint32Map	m_ulCellId
	List of UL CellIds by (IMSI, LCID) pair. More...

Uint64StatsMap	m_ulDelay
	UL delay by (IMSI, LCID) pair. More...

std::string	m_ulPdcpOutputFilename
	Name of the file where the uplink PDCP statistics will be saved. More...

Uint32StatsMap	m_ulPduSize
	UL PDU Size by (IMSI, LCID) pair. More...

Uint64Map	m_ulRxData
	Amount of UL RX Data by (IMSI, LCID) pair. More...

Uint32Map	m_ulRxPackets
	Number of UL RX Packets by (IMSI, LCID) pair. More...

Uint64Map	m_ulTxData
	Amount of UL TX Data by (IMSI, LCID) pair. More...

Uint32Map	m_ulTxPackets
	Number of UL TX Packets by (IMSI, LCID) pair. More...

Additional Inherited Members
Protected Member Functions inherited from ns3::Object
	Object (const Object &o)
	Copy an Object. More...

virtual void	DoInitialize (void)
	Initialize() implementation. More...

virtual void	NotifyNewAggregate (void)
	Notify all Objects aggregated to this one of a new Object being aggregated. More...

Protected Member Functions inherited from ns3::ObjectBase
void	ConstructSelf (const AttributeConstructionList &attributes)
	Complete construction of ObjectBase; invoked by derived classes. More...

virtual void	NotifyConstructionCompleted (void)
	Notifier called once the ObjectBase is fully constructed. More...

Static Protected Member Functions inherited from ns3::LteStatsCalculator
static uint16_t	FindCellIdFromEnbMac (std::string path, uint16_t rnti)
	Retrieves CellId from Enb MAC path in the attribute system. More...

static uint16_t	FindCellIdFromEnbRlcPath (std::string path)
	Retrieves CellId from Enb RLC path in the attribute system. More...

static uint64_t	FindImsiForEnb (std::string path, uint16_t rnti)
	Retrieves IMSI from path for Enb in the attribute system. More...

static uint64_t	FindImsiForUe (std::string path, uint16_t rnti)
	Retrieves IMSI from path for Ue in the attribute system. More...

static uint64_t	FindImsiFromEnbMac (std::string path, uint16_t rnti)
	Retrieves IMSI from Enb MAC path in the attribute system. More...

static uint64_t	FindImsiFromEnbRlcPath (std::string path)
	Retrieves IMSI from Enb RLC path in the attribute system. More...

static uint64_t	FindImsiFromLteNetDevice (std::string path)
	Retrieves IMSI from LteNetDevice path in the attribute system. More...

static uint64_t	FindImsiFromUePhy (std::string path)
	Retrieves IMSI from Ue PHY path in the attribute system. More...

Related Functions inherited from ns3::ObjectBase
static TypeId	GetObjectIid (void)
	Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. More...

Detailed Description

This class is an ns-3 trace sink that performs the calculation of PDU statistics for uplink and downlink.

Introspection did not find any typical Config paths.

Statistics are generated on a per radio bearer basis. This class can be used for RLC PDU stats or PDCP PDU stats by connecting to the appropriate trace sources at the RLC or PDCP layer.

The statistics are calculated at consecutive time windows and periodically written to a file. The calculated statistics are:

Number of transmitted PDUs
Number of received PDUs
Number of transmitted bytes
Number of received bytes
Average, min, max and standard deviation of PDU delay (delay is calculated from the generation of the PDU to its reception)
Average, min, max and standard deviation of PDU size

Attributes

StartTime: Start time of the on going epoch.
- Set with class: ns3::TimeValue
- Underlying type: Time –9223372036854775808.0ns:+9223372036854775807.0ns
- Initial value: +0.0ns
- Flags: construct write read
EpochDuration: Epoch duration.
- Set with class: ns3::TimeValue
- Underlying type: Time –9223372036854775808.0ns:+9223372036854775807.0ns
- Initial value: +250000000.0ns
- Flags: construct write read
DlRlcOutputFilename: Name of the file where the downlink results will be saved.
- Set with class: StringValue
- Underlying type:
- Initial value: DlRlcStats.txt
- Flags: construct write
UlRlcOutputFilename: Name of the file where the uplink results will be saved.
- Set with class: StringValue
- Underlying type:
- Initial value: UlRlcStats.txt
- Flags: construct write
DlPdcpOutputFilename: Name of the file where the downlink results will be saved.
- Set with class: StringValue
- Underlying type:
- Initial value: DlPdcpStats.txt
- Flags: construct write
UlPdcpOutputFilename: Name of the file where the uplink results will be saved.
- Set with class: StringValue
- Underlying type:
- Initial value: UlPdcpStats.txt
- Flags: construct write

No TraceSources are defined for this type.
Size of this type is 608 bytes (on a 64-bit architecture).

Definition at line 70 of file radio-bearer-stats-calculator.h.

Constructor & Destructor Documentation

◆ RadioBearerStatsCalculator() [1/2]

ns3::RadioBearerStatsCalculator::RadioBearerStatsCalculator ( )

Class constructor.

Definition at line 35 of file radio-bearer-stats-calculator.cc.

References NS_LOG_FUNCTION.

◆ RadioBearerStatsCalculator() [2/2]

ns3::RadioBearerStatsCalculator::RadioBearerStatsCalculator ( std::string protocolType )

Class constructor.

Parameters

protocolType the name of the protocol type

Definition at line 43 of file radio-bearer-stats-calculator.cc.

References m_protocolType, and NS_LOG_FUNCTION.

◆ ~RadioBearerStatsCalculator()

ns3::RadioBearerStatsCalculator::~RadioBearerStatsCalculator ( )

virtual

Class destructor.

Definition at line 51 of file radio-bearer-stats-calculator.cc.

References NS_LOG_FUNCTION.

Member Function Documentation

◆ DlRxPdu()

void ns3::RadioBearerStatsCalculator::DlRxPdu	(	uint16_t	cellId,
		uint64_t	imsi,
		uint16_t	rnti,
		uint8_t	lcid,
		uint32_t	packetSize,
		uint64_t	delay
	)

Notifies the stats calculator that an downlink reception has occurred.

Parameters

cellId	CellId of the attached Enb
imsi	IMSI of the UE who received the PDU
rnti	C-RNTI of the UE who received the PDU
lcid	LCID through which the PDU has been transmitted
packetSize	size of the PDU in bytes
delay	RLC to RLC delay in nanoseconds

Definition at line 189 of file radio-bearer-stats-calculator.cc.

References m_dlCellId, m_dlDelay, m_dlPduSize, m_dlRxData, m_dlRxPackets, ns3::ImsiLcidPair_t::m_imsi, ns3::ImsiLcidPair_t::m_lcId, m_pendingOutput, m_startTime, ns3::Simulator::Now(), NS_LOG_DEBUG, NS_LOG_FUNCTION, and packetSize.

Referenced by ns3::LteSimpleHelperDlRxPduCallback().

◆ DlTxPdu()

void ns3::RadioBearerStatsCalculator::DlTxPdu	(	uint16_t	cellId,
		uint64_t	imsi,
		uint16_t	rnti,
		uint8_t	lcid,
		uint32_t	packetSize
	)

Notifies the stats calculator that an downlink transmission has occurred.

Parameters

cellId	CellId of the attached Enb
imsi	IMSI of the UE who is receiving the PDU
rnti	C-RNTI of the UE who is receiving the PDU
lcid	LCID through which the PDU has been transmitted
packetSize	size of the PDU in bytes

Definition at line 149 of file radio-bearer-stats-calculator.cc.

References m_dlCellId, m_dlTxData, m_dlTxPackets, m_flowId, m_pendingOutput, m_startTime, ns3::Simulator::Now(), NS_LOG_FUNCTION, and packetSize.

Referenced by ns3::LteSimpleHelperDlTxPduCallback().

◆ DoDispose()

void ns3::RadioBearerStatsCalculator::DoDispose ( void )

virtual

Destructor implementation.

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

Subclasses are expected to implement their real destruction code in an overridden 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 98 of file radio-bearer-stats-calculator.cc.

References m_pendingOutput, NS_LOG_FUNCTION, and ShowResults().

◆ EndEpoch()

void ns3::RadioBearerStatsCalculator::EndEpoch ( void )

private

Function called in every endEpochEvent.

It calls ShowResults() to write statistics to output files and ResetResults() to clear collected statistics.

Definition at line 422 of file radio-bearer-stats-calculator.cc.

References m_endEpochEvent, m_epochDuration, m_startTime, NS_LOG_FUNCTION, ResetResults(), ns3::Simulator::Schedule(), and ShowResults().

Referenced by RescheduleEndEpoch().

◆ GetDlCellId()

uint32_t ns3::RadioBearerStatsCalculator::GetDlCellId	(	uint64_t	imsi,
		uint8_t	lcid
	)

Gets the attached Enb cellId.

Parameters

imsi	IMSI of the UE
lcid	LCID

Returns: Enb cellId

Definition at line 565 of file radio-bearer-stats-calculator.cc.

References m_dlCellId, and NS_LOG_FUNCTION.

Referenced by WriteDlResults().

◆ GetDlDelay()

double ns3::RadioBearerStatsCalculator::GetDlDelay	(	uint64_t	imsi,
		uint8_t	lcid
	)

Gets the downlink RLC to RLC delay.

Parameters

imsi	IMSI of the UE
lcid	LCID

Returns: RLC to RLC delay in seconds

Definition at line 573 of file radio-bearer-stats-calculator.cc.

References m_dlDelay, NS_LOG_ERROR, and NS_LOG_FUNCTION.

◆ GetDlDelayStats()

std::vector< double > ns3::RadioBearerStatsCalculator::GetDlDelayStats	(	uint64_t	imsi,
		uint8_t	lcid
	)

Gets the downlink RLC to RLC statistics: average, min, max and standard deviation.

Parameters

imsi	IMSI of the UE
lcid	LCID

Returns: RLC to RLC delay statistics average, min, max and standard deviation in seconds

Definition at line 587 of file radio-bearer-stats-calculator.cc.

References m_dlDelay, and NS_LOG_FUNCTION.

Referenced by WriteDlResults().

◆ GetDlOutputFilename()

std::string ns3::RadioBearerStatsCalculator::GetDlOutputFilename ( void )

Get the name of the file where the downlink statistics will be stored.

Returns: the name of the file where the downlink statistics will be stored

Definition at line 646 of file radio-bearer-stats-calculator.cc.

References ns3::LteStatsCalculator::GetDlOutputFilename(), GetDlPdcpOutputFilename(), and m_protocolType.

Referenced by ShowResults().

◆ GetDlPdcpOutputFilename()

std::string ns3::RadioBearerStatsCalculator::GetDlPdcpOutputFilename ( void )

Get the name of the file where the downlink PDCP statistics will be stored.

Returns: the name of the file where the downlink PDCP statistics will be stored

Definition at line 676 of file radio-bearer-stats-calculator.cc.

References m_dlPdcpOutputFilename.

Referenced by GetDlOutputFilename().

◆ GetDlPduSizeStats()

std::vector< double > ns3::RadioBearerStatsCalculator::GetDlPduSizeStats	(	uint64_t	imsi,
		uint8_t	lcid
	)

Gets the downlink PDU size statistics: average, min, max and standard deviation.

Parameters

imsi	IMSI of the UE
lcid	LCID

Returns: PDU size statistics average, min, max and standard deviation in seconds

Definition at line 610 of file radio-bearer-stats-calculator.cc.

References m_dlPduSize, and NS_LOG_FUNCTION.

Referenced by WriteDlResults().

◆ GetDlRxData()

uint64_t ns3::RadioBearerStatsCalculator::GetDlRxData	(	uint64_t	imsi,
		uint8_t	lcid
	)

Gets the number of received downlink data bytes.

Parameters

imsi	IMSI of the UE
lcid	LCID

Returns: number of received data bytes

Definition at line 549 of file radio-bearer-stats-calculator.cc.

References m_dlRxData, and NS_LOG_FUNCTION.

◆ GetDlRxPackets()

uint32_t ns3::RadioBearerStatsCalculator::GetDlRxPackets	(	uint64_t	imsi,
		uint8_t	lcid
	)

Gets the number of received downlink data bytes.

Parameters

imsi	IMSI of the UE
lcid	LCID

Returns: number of received data bytes

Definition at line 533 of file radio-bearer-stats-calculator.cc.

References m_dlRxPackets, and NS_LOG_FUNCTION.

Referenced by LenaDataPhyErrorModelTestCase::DoRun(), LenaDlCtrlPhyErrorModelTestCase::DoRun(), and WriteDlResults().

◆ GetDlTxData()

uint64_t ns3::RadioBearerStatsCalculator::GetDlTxData	(	uint64_t	imsi,
		uint8_t	lcid
	)

Gets the number of transmitted downlink data bytes.

Parameters

imsi	IMSI of the UE
lcid	LCID

Returns: number of transmitted data bytes

Definition at line 541 of file radio-bearer-stats-calculator.cc.

References m_dlTxData, and NS_LOG_FUNCTION.

Referenced by LenaHarqTestCase::DoRun(), and WriteDlResults().

◆ GetDlTxPackets()

uint32_t ns3::RadioBearerStatsCalculator::GetDlTxPackets	(	uint64_t	imsi,
		uint8_t	lcid
	)

Gets the number of transmitted downlink data bytes.

Parameters

imsi	IMSI of the UE
lcid	LCID

Returns: number of transmitted data bytes

Definition at line 525 of file radio-bearer-stats-calculator.cc.

References m_dlTxPackets, and NS_LOG_FUNCTION.

Referenced by LenaDataPhyErrorModelTestCase::DoRun(), LenaDlCtrlPhyErrorModelTestCase::DoRun(), and WriteDlResults().

◆ GetEpoch()

Time ns3::RadioBearerStatsCalculator::GetEpoch ( ) const

Returns: the epoch duration

Definition at line 128 of file radio-bearer-stats-calculator.cc.

References m_epochDuration.

Referenced by GetTypeId().

◆ GetStartTime()

Time ns3::RadioBearerStatsCalculator::GetStartTime ( ) const

Returns: the value of the StartTime attribute

Definition at line 115 of file radio-bearer-stats-calculator.cc.

References m_startTime.

Referenced by GetTypeId().

◆ GetTypeId()

TypeId ns3::RadioBearerStatsCalculator::GetTypeId ( void )

static

Register this type.

Returns: The object TypeId.

Definition at line 57 of file radio-bearer-stats-calculator.cc.

References GetEpoch(), GetStartTime(), ns3::MakeStringAccessor(), ns3::MakeStringChecker(), ns3::MakeTimeAccessor(), ns3::MakeTimeChecker(), ns3::Seconds(), ns3::LteStatsCalculator::SetDlOutputFilename(), SetDlPdcpOutputFilename(), SetEpoch(), ns3::TypeId::SetParent(), SetStartTime(), ns3::LteStatsCalculator::SetUlOutputFilename(), and SetUlPdcpOutputFilename().

◆ GetUlCellId()

uint32_t ns3::RadioBearerStatsCalculator::GetUlCellId	(	uint64_t	imsi,
		uint8_t	lcid
	)

Gets the attached Enb cellId.

Parameters

imsi	IMSI of the UE
lcid	LCID

Returns: Enb cellId

Definition at line 557 of file radio-bearer-stats-calculator.cc.

References m_ulCellId, and NS_LOG_FUNCTION.

Referenced by WriteUlResults().

◆ GetUlDelay()

double ns3::RadioBearerStatsCalculator::GetUlDelay	(	uint64_t	imsi,
		uint8_t	lcid
	)

Gets the uplink RLC to RLC delay.

Parameters

imsi	IMSI of the UE
lcid	LCID

Returns: RLC to RLC delay in seconds

Definition at line 464 of file radio-bearer-stats-calculator.cc.

References m_ulDelay, NS_LOG_ERROR, and NS_LOG_FUNCTION.

◆ GetUlDelayStats()

std::vector< double > ns3::RadioBearerStatsCalculator::GetUlDelayStats	(	uint64_t	imsi,
		uint8_t	lcid
	)

Gets the uplink RLC to RLC statistics: average, min, max and standard deviation.

Parameters

imsi	IMSI of the UE
lcid	LCID

Returns: RLC to RLC delay statistics average, min, max and standard deviation in seconds

Definition at line 479 of file radio-bearer-stats-calculator.cc.

References m_ulDelay, and NS_LOG_FUNCTION.

Referenced by WriteUlResults().

◆ GetUlOutputFilename()

std::string ns3::RadioBearerStatsCalculator::GetUlOutputFilename ( void )

Get the name of the file where the uplink statistics will be stored.

Returns: the name of the file where the uplink statistics will be stored

Definition at line 633 of file radio-bearer-stats-calculator.cc.

References ns3::LteStatsCalculator::GetUlOutputFilename(), GetUlPdcpOutputFilename(), and m_protocolType.

Referenced by ShowResults().

◆ GetUlPdcpOutputFilename()

std::string ns3::RadioBearerStatsCalculator::GetUlPdcpOutputFilename ( void )

Get the name of the file where the uplink PDCP statistics will be stored.

Returns: the name of the file where the uplink PDCP statistics will be stored

Definition at line 665 of file radio-bearer-stats-calculator.cc.

References m_ulPdcpOutputFilename.

Referenced by GetUlOutputFilename().

◆ GetUlPduSizeStats()

std::vector< double > ns3::RadioBearerStatsCalculator::GetUlPduSizeStats	(	uint64_t	imsi,
		uint8_t	lcid
	)

Gets the uplink PDU size statistics: average, min, max and standard deviation.

Parameters

imsi	IMSI of the UE
lcid	LCID

Returns: PDU size statistics average, min, max and standard deviation in seconds

Definition at line 502 of file radio-bearer-stats-calculator.cc.

References m_ulPduSize, and NS_LOG_FUNCTION.

Referenced by WriteUlResults().

◆ GetUlRxData()

uint64_t ns3::RadioBearerStatsCalculator::GetUlRxData	(	uint64_t	imsi,
		uint8_t	lcid
	)

Gets the number of received uplink data bytes.

Parameters

imsi	IMSI of the UE
lcid	LCID

Returns: number of received data bytes

Definition at line 456 of file radio-bearer-stats-calculator.cc.

References m_ulRxData, and NS_LOG_FUNCTION.

◆ GetUlRxPackets()

uint32_t ns3::RadioBearerStatsCalculator::GetUlRxPackets	(	uint64_t	imsi,
		uint8_t	lcid
	)

Gets the number of received uplink packets.

Parameters

imsi	IMSI of the UE
lcid	LCID

Returns: number of received uplink packets

Definition at line 440 of file radio-bearer-stats-calculator.cc.

References m_ulRxPackets, and NS_LOG_FUNCTION.

Referenced by WriteUlResults().

◆ GetUlTxData()

uint64_t ns3::RadioBearerStatsCalculator::GetUlTxData	(	uint64_t	imsi,
		uint8_t	lcid
	)

Gets the number of transmitted uplink data bytes.

Parameters

imsi	IMSI of the UE
lcid	LCID

Returns: number of transmitted data bytes

Definition at line 448 of file radio-bearer-stats-calculator.cc.

References m_ulTxData, and NS_LOG_FUNCTION.

Referenced by LenaRrFfMacSchedulerTestCase::DoRun(), and WriteUlResults().

◆ GetUlTxPackets()

uint32_t ns3::RadioBearerStatsCalculator::GetUlTxPackets	(	uint64_t	imsi,
		uint8_t	lcid
	)

Gets the number of transmitted uplink packets.

Parameters

imsi	IMSI of the UE
lcid	LCID

Returns: number of transmitted uplink packets

Definition at line 432 of file radio-bearer-stats-calculator.cc.

References m_ulTxPackets, and NS_LOG_FUNCTION.

Referenced by WriteUlResults().

◆ RescheduleEndEpoch()

void ns3::RadioBearerStatsCalculator::RescheduleEndEpoch ( void )

private

Reschedules EndEpoch event.

Usually used after execution of SetStartTime() or SetEpoch()

Definition at line 413 of file radio-bearer-stats-calculator.cc.

References ns3::EventId::Cancel(), EndEpoch(), m_endEpochEvent, m_epochDuration, m_startTime, ns3::Simulator::Now(), NS_ASSERT, NS_LOG_FUNCTION, and ns3::Simulator::Schedule().

Referenced by SetEpoch(), and SetStartTime().

◆ ResetResults()

void ns3::RadioBearerStatsCalculator::ResetResults ( void )

private

Erases collected statistics.

Definition at line 393 of file radio-bearer-stats-calculator.cc.

References m_dlDelay, m_dlPduSize, m_dlRxData, m_dlRxPackets, m_dlTxData, m_dlTxPackets, m_ulDelay, m_ulPduSize, m_ulRxData, m_ulRxPackets, m_ulTxData, m_ulTxPackets, and NS_LOG_FUNCTION.

Referenced by EndEpoch().

◆ SetDlPdcpOutputFilename()

void ns3::RadioBearerStatsCalculator::SetDlPdcpOutputFilename ( std::string outputFilename )

Set the name of the file where the downlink PDCP statistics will be stored.

Parameters

outputFilename string with the name of the file

Definition at line 670 of file radio-bearer-stats-calculator.cc.

References m_dlPdcpOutputFilename.

Referenced by GetTypeId().

◆ SetEpoch()

void ns3::RadioBearerStatsCalculator::SetEpoch ( Time e )

Parameters

e	the epoch duration

Definition at line 121 of file radio-bearer-stats-calculator.cc.

References m_epochDuration, and RescheduleEndEpoch().

Referenced by GetTypeId().

◆ SetStartTime()

void ns3::RadioBearerStatsCalculator::SetStartTime ( Time t )

Parameters

t	the value of the StartTime attribute

Definition at line 108 of file radio-bearer-stats-calculator.cc.

References m_startTime, and RescheduleEndEpoch().

Referenced by GetTypeId().

◆ SetUlPdcpOutputFilename()

void ns3::RadioBearerStatsCalculator::SetUlPdcpOutputFilename ( std::string outputFilename )

Set the name of the file where the uplink PDCP statistics will be stored.

Parameters

outputFilename string with the name of the file

Definition at line 659 of file radio-bearer-stats-calculator.cc.

References m_ulPdcpOutputFilename.

Referenced by GetTypeId().

◆ ShowResults()

void ns3::RadioBearerStatsCalculator::ShowResults ( void )

private

Called after each epoch to write collected statistics to output files.

During first call it opens output files and write columns descriptions. During next calls it opens output files in append mode.

Definition at line 213 of file radio-bearer-stats-calculator.cc.

References GetDlOutputFilename(), GetUlOutputFilename(), m_firstWrite, m_pendingOutput, NS_LOG_ERROR, NS_LOG_FUNCTION, NS_LOG_INFO, WriteDlResults(), and WriteUlResults().

Referenced by DoDispose(), and EndEpoch().

◆ UlRxPdu()

void ns3::RadioBearerStatsCalculator::UlRxPdu	(	uint16_t	cellId,
		uint64_t	imsi,
		uint16_t	rnti,
		uint8_t	lcid,
		uint32_t	packetSize,
		uint64_t	delay
	)

Notifies the stats calculator that an uplink reception has occurred.

Parameters

cellId	CellId of the attached Enb
imsi	IMSI of the UE who received the PDU
rnti	C-RNTI of the UE who received the PDU
lcid	LCID through which the PDU has been received
packetSize	size of the PDU in bytes
delay	RLC to RLC delay in nanoseconds

Definition at line 164 of file radio-bearer-stats-calculator.cc.

References ns3::ImsiLcidPair_t::m_imsi, ns3::ImsiLcidPair_t::m_lcId, m_pendingOutput, m_startTime, m_ulCellId, m_ulDelay, m_ulPduSize, m_ulRxData, m_ulRxPackets, ns3::Simulator::Now(), NS_LOG_DEBUG, NS_LOG_FUNCTION, and packetSize.

Referenced by ns3::LteSimpleHelperUlRxPduCallback().

◆ UlTxPdu()

void ns3::RadioBearerStatsCalculator::UlTxPdu	(	uint16_t	cellId,
		uint64_t	imsi,
		uint16_t	rnti,
		uint8_t	lcid,
		uint32_t	packetSize
	)

Notifies the stats calculator that an uplink transmission has occurred.

Parameters

cellId	CellId of the attached Enb
imsi	IMSI of the UE who transmitted the PDU
rnti	C-RNTI of the UE who transmitted the PDU
lcid	LCID through which the PDU has been transmitted
packetSize	size of the PDU in bytes