Forms the template defined base class for statistics gathering within SST. More...

#include <statbase.h>

Inheritance diagram for SST::Statistics::Statistic< T >:

Public Member Functions
	SST_ELI_DECLARE_INFO (ELI::ProvidesInterface, ELI::ProvidesParams) SST_ELI_DOCUMENT_PARAMS(

template<class... InArgs>
void	addData (InArgs &&... args)
	Add data to the Statistic This will call the addData_impl() routine in the derived Statistic.

template<class... InArgs>
void	addDataNTimes (uint64_t N, InArgs &&... args)

virtual void	serialize_order (SST::Core::Serialization::serializer &ser) override
	Serialization.

Public Member Functions inherited from SST::Statistics::StatisticBase
void	enable ()
	Enable Statistic for collections.

void	disable ()
	Disable Statistic for collections.

virtual void	clearStatisticData ()
	Inform the Statistic to clear its data.

virtual void	resetCollectionCount ()
	Set the current collection count to 0.

virtual void	incrementCollectionCount (uint64_t increment)
	Increment current collection count.

virtual void	setCollectionCount (uint64_t new_count)
	Set the current collection count to a defined value.

virtual void	setCollectionCountLimit (uint64_t new_limit)
	Set the collection count limit to a defined value.

void	setFlagResetCountOnOutput (bool flag)
	Set the Reset Count On Output flag.

void	setFlagClearDataOnOutput (bool flag)
	Set the Clear Data On Output flag.

void	setFlagOutputAtEndOfSim (bool flag)
	Set the Output At End Of Sim flag.

const std::string &	getCompName () const
	Return the Component Name.

const std::string &	getStatName () const
	Return the Statistic Name.

const std::string &	getStatSubId () const
	Return the Statistic SubId.

const std::string &	getFullStatName () const
	Return the full Statistic name of component.stat_name.sub_id.

virtual std::string	getELIName () const =0
	Return the ELI type of the statistic The ELI registration macro creates this function automatically for child classes.

virtual const std::string &	getStatTypeName () const
	Return the Statistic type name.

const StatisticFieldInfo::fieldType_t &	getStatDataType () const
	Return the Statistic data type.

const char *	getStatDataTypeShortName () const
	Return the Statistic data type.

const char *	getStatDataTypeFullName () const
	Return the Statistic data type.

BaseComponent *	getComponent () const
	Return a pointer to the parent Component.

bool	isEnabled () const
	Return the enable status of the Statistic.

bool	isOutputEnabled () const
	Return the enable status of the Statistic's ability to output data.

UnitAlgebra &	getCollectionRate () const
	Return the rate at which the statistic should be output.

UnitAlgebra &	getStartAtTime () const
	Return the time at which the statistic should be enabled.

UnitAlgebra &	getStopAtTime () const
	Return the time at which the statistic should be disabled.

uint64_t	getCollectionCountLimit () const
	Return the collection count limit.

uint64_t	getCollectionCount () const
	Return the current collection count.

bool	getFlagResetCountOnOutput () const
	Return the ResetCountOnOutput flag value.

bool	getFlagClearDataOnOutput () const
	Return the ClearDataOnOutput flag value.

bool	getFlagOutputAtEndOfSim () const
	Return the OutputAtEndOfSim flag value.

StatMode_t	getRegisteredCollectionMode () const
	Return the collection mode that is registered.

virtual bool	isReady () const
	Indicate that the Statistic is Ready to be used.

virtual bool	isNullStatistic () const
	Indicate if the Statistic is a NullStatistic.

Static Public Member Functions
static fieldType_t	fieldId ()

Static Public Member Functions inherited from SST::Statistics::StatisticBase
static const std::vector< ElementInfoParam > &	ELI_getParams ()

Protected Member Functions
	Statistic (BaseComponent *comp, const std::string &stat_name, const std::string &stat_sub_id, Params &stat_params, bool null_stat=false)
	Construct a Statistic.

Protected Member Functions inherited from SST::Statistics::StatisticBase
	StatisticBase (BaseComponent *comp, const std::string &stat_name, const std::string &stat_sub_id, Params &stat_params, bool null_stat)
	Construct a StatisticBase.

void	setStatisticDataType (const StatisticFieldInfo::fieldType_t data_type)
	Set the Statistic Data Type.

void	setStatisticTypeName (const char *type_name)
	Set an optional Statistic Type Name (for output)

Friends
class	SST::Factory

class	SST::BaseComponent

Additional Inherited Members
Public Types inherited from SST::Statistics::StatisticBase
enum	StatMode_t { STAT_MODE_UNDEFINED , STAT_MODE_COUNT , STAT_MODE_PERIODIC , STAT_MODE_DUMP_AT_END }
	Statistic collection mode STAT_MODE_UNDEFINED - unknown mode STAT_MODE_COUNT - generating statistic output when the statistic has been added to a certain number of times STAT_MODE_PERIODIC - generating statistic output on a periodic time basis STAT_MODE_DUMP_AT_END - generating statistic output only at end of simulation.

Detailed Description

template<typename T>
class SST::Statistics::Statistic< T >

Forms the template defined base class for statistics gathering within SST.

Template Parameters

T	A template for the basic numerical data stored by this Statistic

Constructor & Destructor Documentation

◆ Statistic()

template<typename T>

SST::Statistics::Statistic< T >::Statistic	(	BaseComponent *	comp,
		const std::string &	stat_name,
		const std::string &	stat_sub_id,
		Params &	stat_params,
		bool	null_stat = false )

inlineprotected

Construct a Statistic.

Parameters

comp	- Pointer to the parent constructor.
stat_name	- Name of the statistic to be registered. This name must match the name in the ElementInfoStatistic.
stat_sub_id	- Additional name of the statistic
stat_params	- The parameters for this statistic
null_stat	- True if the statistic is null (not enabled). Defaults to False.

Member Function Documentation

◆ serialize_order()

template<typename T>

virtual void SST::Statistics::Statistic< T >::serialize_order ( SST::Core::Serialization::serializer & ser )

inlineoverridevirtual

Serialization.

Reimplemented from SST::Statistics::StatisticBase.

Reimplemented in SST::Statistics::AccumulatorStatistic< NumberBase >, SST::Statistics::HistogramStatistic< BinDataType >, and SST::Statistics::UniqueCountStatistic< T >.

Referenced by SST::Statistics::AccumulatorStatistic< NumberBase >::serialize_order(), SST::Statistics::HistogramStatistic< BinDataType >::serialize_order(), and SST::Statistics::UniqueCountStatistic< T >::serialize_order().

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

src/sst/core/eli/elementinfo.h
src/sst/core/statapi/statbase.h

Public Member Functions

Static Public Member Functions

Protected Member Functions

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Statistic()

Member Function Documentation

◆ serialize_order()