Allows the online gathering of statistical information about a single quantity. More...

#include <stataccumulator.h>

Inheritance diagram for SST::Statistics::AccumulatorStatistic< NumberBase >:

Public Member Functions
	SST_ELI_DECLARE_STATISTIC_TEMPLATE (AccumulatorStatistic, "sst", "AccumulatorStatistic", SST_ELI_ELEMENT_VERSION(1, 0, 0), "Accumulate all contributions to a statistic", "SST::Statistic<T>") AccumulatorStatistic(BaseComponent *comp

this	setStatisticTypeName ("Accumulator")

NumberBase	getSum ()
	Provides the sum of the values presented so far. More...

NumberBase	getMax ()
	Provides the maxmimum value presented so far. More...

NumberBase	getMin ()
	Provides the minimum value presented so far. More...

NumberBase	getSumSquared ()
	Provides the sum of each value squared presented to the class so far. More...

NumberBase	getArithmeticMean ()
	Get the arithmetic mean of the values presented so far. More...

NumberBase	getVariance ()
	Get the variance of the values presented so far. More...

NumberBase	getStandardDeviation ()
	Get the standard deviation of the values presented so far. More...

uint64_t	getCount ()
	Get a count of the number of elements presented to the statistics collection so far. More...

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

void	registerOutputFields (StatisticFieldsOutput *statOutput) override
	Called by the system to tell the Statistic to register its output fields. More...

void	outputStatisticFields (StatisticFieldsOutput *statOutput, bool UNUSED(EndOfSimFlag)) override

bool	isStatModeSupported (StatisticBase::StatMode_t mode) const override

Public Member Functions inherited from SST::Statistics::Statistic< NumberBase >
	SST_ELI_DECLARE_INFO (ELI::ProvidesInterface, ELI::ProvidesParams) using Datum

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

void	addDataNTimes (uint64_t N, InArgs &&... args)

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. More...

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 newCount)
	Set the current collection count to a defined value.

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

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

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

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

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.StatName.SubId.

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.

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.

void	delayOutput (const char *delayTime)
	Delay the statistic from outputting data for a specified delay time. More...

void	delayCollection (const char *delayTime)
	Delay the statistic from collecting data for a specified delay time. More...

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

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

Data Fields
const std::string &	statName

const std::string const std::string &	statSubId

const std::string const std::string Params &	statParams: Statistic<NumberBase>(comp

const std::string const std::string Params	statName

const std::string const std::string Params	statSubId

const std::string const std::string Params	statParams

	m_sum_sq = static_cast<NumberBase>(0)

	m_min = std::numeric_limits<NumberBase>::max()

	m_max = std::numeric_limits<NumberBase>::min()

Protected Member Functions
void	addData_impl (NumberBase value) override
	Present a new value to the class to be included in the statistics. More...

void	addData_impl_Ntimes (uint64_t N, NumberBase value) override

Protected Member Functions inherited from SST::Statistics::Statistic< NumberBase >
	Statistic (BaseComponent *comp, const std::string &statName, const std::string &statSubId, Params &statParams)
	Construct a Statistic. More...

Protected Member Functions inherited from SST::Statistics::StatisticBase
	StatisticBase (BaseComponent *comp, const std::string &statName, const std::string &statSubId, Params &statParams)
	Construct a StatisticBase. More...

Params &	getParams ()
	Return the Statistic Parameters.

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

void	setStatisticTypeName (const char *typeName)
	Set an optional Statistic Type Name.

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.

Static Public Member Functions inherited from SST::Statistics::Statistic< NumberBase >
static fieldType_t	fieldId ()

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

Detailed Description

template<typename NumberBase>
class SST::Statistics::AccumulatorStatistic< NumberBase >

Allows the online gathering of statistical information about a single quantity.

The basic statistics are captured online removing the need to keep a copy of the values of interest.

Template Parameters

NumberBase A template for the basic numerical type of values

Member Function Documentation

◆ addData_impl()

template<typename NumberBase >

void SST::Statistics::AccumulatorStatistic< NumberBase >::addData_impl ( NumberBase value )

inlineoverrideprotected

Present a new value to the class to be included in the statistics.

Parameters

value New value to be presented

◆ clearStatisticData()

template<typename NumberBase >

void SST::Statistics::AccumulatorStatistic< NumberBase >::clearStatisticData ( )

inlineoverridevirtual

Inform the Statistic to clear its data.

Reimplemented from SST::Statistics::StatisticBase.

References SST::Statistics::StatisticBase::setCollectionCount().

◆ getArithmeticMean()

template<typename NumberBase >

NumberBase SST::Statistics::AccumulatorStatistic< NumberBase >::getArithmeticMean ( )

inline

Get the arithmetic mean of the values presented so far.

Returns: The arithmetic mean of the values presented so far.

References SST::Statistics::AccumulatorStatistic< NumberBase >::getCount().

◆ getCount()

template<typename NumberBase >

uint64_t SST::Statistics::AccumulatorStatistic< NumberBase >::getCount ( )

inline

Get a count of the number of elements presented to the statistics collection so far.

Returns: Count the number of values presented to the class.

References SST::Statistics::StatisticBase::getCollectionCount().

Referenced by SST::Statistics::AccumulatorStatistic< NumberBase >::getArithmeticMean(), and SST::Statistics::AccumulatorStatistic< NumberBase >::getVariance().

◆ getMax()

template<typename NumberBase >

NumberBase SST::Statistics::AccumulatorStatistic< NumberBase >::getMax ( )

inline

Provides the maxmimum value presented so far.

Returns: The maximum of values presented to the class so far

◆ getMin()

template<typename NumberBase >

NumberBase SST::Statistics::AccumulatorStatistic< NumberBase >::getMin ( )

inline

Provides the minimum value presented so far.

Returns: The minimum of values presented to the class so far

◆ getStandardDeviation()

template<typename NumberBase >

NumberBase SST::Statistics::AccumulatorStatistic< NumberBase >::getStandardDeviation ( )

inline

Get the standard deviation of the values presented so far.

Returns: The standard deviation of the values presented so far

References SST::Statistics::AccumulatorStatistic< NumberBase >::getVariance().

◆ getSum()

template<typename NumberBase >

NumberBase SST::Statistics::AccumulatorStatistic< NumberBase >::getSum ( )

inline

Provides the sum of the values presented so far.

Returns: The sum of values presented to the class so far.

◆ getSumSquared()

template<typename NumberBase >

NumberBase SST::Statistics::AccumulatorStatistic< NumberBase >::getSumSquared ( )

inline

Provides the sum of each value squared presented to the class so far.

Returns: The sum of squared values presented to the class so far.

◆ getVariance()

template<typename NumberBase >

NumberBase SST::Statistics::AccumulatorStatistic< NumberBase >::getVariance ( )

inline

Get the variance of the values presented so far.

Returns: The variance of the values presented so far

References SST::Statistics::AccumulatorStatistic< NumberBase >::getCount().

Referenced by SST::Statistics::AccumulatorStatistic< NumberBase >::getStandardDeviation().

◆ registerOutputFields()

template<typename NumberBase >

void SST::Statistics::AccumulatorStatistic< NumberBase >::registerOutputFields ( StatisticFieldsOutput * statOutput )

inlineoverridevirtual

Called by the system to tell the Statistic to register its output fields.

by calling statOutput->registerField(...)

Parameters

statOutput - Pointer to the statistic output

Implements SST::Statistics::StatisticBase.

References SST::Statistics::StatisticFieldsOutput::registerField().

Field Documentation

◆ statParams

template<typename NumberBase >

const std::string const std::string Params SST::Statistics::AccumulatorStatistic< NumberBase >::statParams

Initial value:

{

m_sum = static_cast<NumberBase>(0)

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

src/sst/core/statapi/stataccumulator.h

Public Member Functions

Data Fields

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ addData_impl()

◆ clearStatisticData()

◆ getArithmeticMean()

◆ getCount()

◆ getMax()

◆ getMin()

◆ getStandardDeviation()

◆ getSum()

◆ getSumSquared()

◆ getVariance()

◆ registerOutputFields()

Field Documentation

◆ statParams