Forms the base class for statistics gathering within SST. More...
#include <statbase.h>
Public Types | |
enum | StatMode_t { STAT_MODE_UNDEFINED, STAT_MODE_COUNT, STAT_MODE_PERIODIC } |
Statistic collection mode. | |
Public Member Functions | |
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 () |
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. | |
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.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. | |
Component * | 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. | |
void | delayCollection (const char *delayTime) |
Delay the statistic from collecting data for a specified delay time. | |
virtual bool | isReady () const |
Indicate that the Statistic is Ready to be used. | |
virtual bool | isNullStatistic () const |
Indicate if the Statistic is a NullStatistic. | |
Protected Member Functions | |
StatisticBase (Component *comp, std::string &statName, std::string &statSubId, Params &statParams) | |
Construct a StatisticBase. | |
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. | |
Friends | |
class | SST::Component |
class | SST::SubComponent |
class | SST::Statistics::StatisticProcessingEngine |
class | boost::serialization::access |
Forms the base class for statistics gathering within SST.
Statistics are gathered and processed into various (extensible) output forms. Statistics are expected to be named so that they can be located in the simulation output files.
SST::Statistics::StatisticBase::StatisticBase | ( | Component * | comp, | |
std::string & | statName, | |||
std::string & | statSubId, | |||
Params & | statParams | |||
) | [protected] |
Construct a StatisticBase.
comp | - Pointer to the parent constructor. | |
statName | - Name of the statistic to be registered. This name must match the name in the ElementInfoStatistic. | |
statSubId | - Additional name of the statistic | |
statParams | - The parameters for this statistic |
void SST::Statistics::StatisticBase::delayCollection | ( | const char * | delayTime | ) |
Delay the statistic from collecting data for a specified delay time.
delayTime | - Value in UnitAlgebra format for delay (i.e. 10ns). |
References SST::Simulation::getSimulation(), and SST::Simulation::registerOneShot().
void SST::Statistics::StatisticBase::delayOutput | ( | const char * | delayTime | ) |
Delay the statistic from outputting data for a specified delay time.
delayTime | - Value in UnitAlgebra format for delay (i.e. 10ns). |
References SST::Simulation::getSimulation(), and SST::Simulation::registerOneShot().
void SST::Statistics::StatisticBase::setFlagClearDataOnOutput | ( | bool | flag | ) | [inline] |
Set the Clear Data On Output flag.
If Set, the data in the statistic will be cleared by calling clearStatisticData().
void SST::Statistics::StatisticBase::setFlagOutputAtEndOfSim | ( | bool | flag | ) | [inline] |
Set the Output At End Of Sim flag.
If Set, the statistic will perform an output at the end of simulation.
void SST::Statistics::StatisticBase::setFlagResetCountOnOutput | ( | bool | flag | ) | [inline] |
Set the Reset Count On Output flag.
If Set, the collection count will be reset when statistic is output.