Collects data. More...

#include "data-collector.h"

Inheritance diagram for ns3::DataCollector:

Collaboration diagram for ns3::DataCollector:

Public Member Functions
	DataCollector ()

	~DataCollector () override

void	AddDataCalculator (Ptr< DataCalculator > datac)
	Add a DataCalculator object to the DataCollector. More...

void	AddMetadata (std::string key, double value)
	Add the key and the value as a pair of strings to the metadata list. More...

void	AddMetadata (std::string key, std::string value)
	Add the key and the value as a pair of strings to the metadata list. More...

void	AddMetadata (std::string key, uint32_t value)
	Add the key and the value as a pair of strings to the metadata list. More...

DataCalculatorList::iterator	DataCalculatorBegin ()
	Returns an iterator to the beginning of the DataCalculator list. More...

DataCalculatorList::iterator	DataCalculatorEnd ()
	Returns an iterator to the past-the-end of the DataCalculator list. More...

void	DescribeRun (std::string experiment, std::string strategy, std::string input, std::string runID, std::string description="")
	Provide specific parameters to the DataCollector. More...

std::string	GetDescription () const
	Return the description label. More...

std::string	GetExperimentLabel () const
	Return the experiment label. More...

std::string	GetInputLabel () const
	Return the input label. More...

std::string	GetRunLabel () const
	Return the runID label. More...

std::string	GetStrategyLabel () const
	Return the strategy label. More...

MetadataList::iterator	MetadataBegin ()
	Returns an iterator to the beginning of the metadata list. More...

MetadataList::iterator	MetadataEnd ()
	Returns an iterator to the past-the-end of the metadata list. More...

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

	~Object () override
	Destructor. More...

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

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

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

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

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

template<>
Ptr< Object >	GetObject () const
	Specialization of () for objects of type ns3::Object. More...

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

template<>
Ptr< Object >	GetObject (TypeId tid) const
	Specialization of (TypeId tid) for objects of type ns3::Object. More...

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

bool	IsInitialized () 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[[maybe_unused]])
	Copy constructor. More...

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

SimpleRefCount &	operator= (const SimpleRefCount &o[[maybe_unused]])
	Assignment operator. More...

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

void	Unref () 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 errors. 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 ()
	Register this type. More...

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

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

Protected Member Functions
void	DoDispose () override
	Destructor implementation. More...

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

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

virtual void	NotifyNewAggregate ()
	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 ()
	Notifier called once the ObjectBase is fully constructed. More...

Private Attributes
DataCalculatorList	m_calcList
	List of data calculators. More...

std::string	m_description
	Description label. More...

std::string	m_experimentLabel
	Experiment label. More...

std::string	m_inputLabel
	Input label. More...

MetadataList	m_metadata
	List of experiment metadata. More...

std::string	m_runLabel
	Run label. More...

std::string	m_strategyLabel
	Strategy label. More...

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

Detailed Description

Collects data.

Definition at line 49 of file data-collector.h.

Constructor & Destructor Documentation

◆ DataCollector()

DataCollector::DataCollector ( )

Definition at line 33 of file data-collector.cc.

References NS_LOG_FUNCTION.

◆ ~DataCollector()

DataCollector::~DataCollector ( )

override

Definition at line 39 of file data-collector.cc.

References NS_LOG_FUNCTION.

Member Function Documentation

◆ AddDataCalculator()

void DataCollector::AddDataCalculator ( Ptr< DataCalculator > datac )

Add a DataCalculator object to the DataCollector.

Parameters

datac DataCalculator object to be added

Definition at line 87 of file data-collector.cc.

References m_calcList, and NS_LOG_FUNCTION.

◆ AddMetadata() [1/3]

void DataCollector::AddMetadata	(	std::string	key,
		double	value
	)

Add the key and the value as a pair of strings to the metadata list.

Parameters

key	Key value to include
value	Value to include of type double

Definition at line 134 of file data-collector.cc.

References m_metadata, and NS_LOG_FUNCTION.

◆ AddMetadata() [2/3]

void DataCollector::AddMetadata	(	std::string	key,
		std::string	value
	)

Add the key and the value as a pair of strings to the metadata list.

Parameters

key	Key value to include
value	Value to include of type string

Definition at line 111 of file data-collector.cc.

References m_metadata, and NS_LOG_FUNCTION.

◆ AddMetadata() [3/3]

void DataCollector::AddMetadata	(	std::string	key,
		uint32_t	value
	)

Add the key and the value as a pair of strings to the metadata list.

Parameters

key	Key value to include
value	Value to include of type uint32_t

Definition at line 121 of file data-collector.cc.

References m_metadata, and NS_LOG_FUNCTION.

◆ DataCalculatorBegin()

DataCalculatorList::iterator DataCollector::DataCalculatorBegin ( )

Returns an iterator to the beginning of the DataCalculator list.

Returns: Iterator pointing to the first value of the DataCalculator list

Definition at line 97 of file data-collector.cc.

References m_calcList.

Referenced by ns3::OmnetDataOutput::Output(), and ns3::SqliteDataOutput::Output().

Here is the caller graph for this function:

◆ DataCalculatorEnd()

DataCalculatorList::iterator DataCollector::DataCalculatorEnd ( )

Returns an iterator to the past-the-end of the DataCalculator list.

Returns: Iterator pointing to the past-the-end element of the DataCalculator list

Definition at line 104 of file data-collector.cc.

References m_calcList.

Referenced by ns3::OmnetDataOutput::Output(), and ns3::SqliteDataOutput::Output().

Here is the caller graph for this function:

◆ DescribeRun()

void DataCollector::DescribeRun	(	std::string	experiment,
		std::string	strategy,
		std::string	input,
		std::string	runID,
		std::string	description = `""`
	)

Provide specific parameters to the DataCollector.

Parameters

experiment	Label for the experiment
strategy	Label for the strategy
input	Label for the input
runID	Label for the runID
description	Description

Definition at line 69 of file data-collector.cc.

References experiment(), m_description, m_experimentLabel, m_inputLabel, m_runLabel, m_strategyLabel, and NS_LOG_FUNCTION.

Here is the call graph for this function:

◆ DoDispose()

void DataCollector::DoDispose ( void )

overrideprotectedvirtual

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 57 of file data-collector.cc.

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

Here is the call graph for this function: