A simple distribution stat. More...

#include <statistics.hh>

Inheritance diagram for gem5::statistics::Distribution:

Public Member Functions
	Distribution (Group *parent=nullptr)

	Distribution (Group parent, const char name, const char *desc=nullptr)

	Distribution (Group parent, const char name, const units::Base unit, const char desc=nullptr)

Distribution &	init (Counter min, Counter max, Counter bkt)
	Set the parameters of this distribution.

Public Member Functions inherited from gem5::statistics::DistBase< Distribution, DistStor >
	DistBase (Group parent, const char name, const units::Base unit, const char desc)

void	sample (const U &v, int n=1)
	Add a value to the distribtion n times.

size_type	size () const
	Return the number of entries in this stat.

bool	zero () const
	Return true if no samples have been added.

void	prepare ()

void	reset ()
	Reset stat value to default.

void	add (DistBase &d)
	Add the argument distribution to the this distribution.

Public Member Functions inherited from gem5::statistics::DataWrap< Distribution, DistInfoProxy >
const Info *	info () const

	DataWrap ()=delete

	DataWrap (const DataWrap &)=delete

	DataWrap (Group parent, const char name, const units::Base unit, const char desc)

DataWrap &	operator= (const DataWrap &)=delete

Distribution &	name (const std::string &name)
	Set the name and marks this stat to print at the end of simulation.

const std::string &	name () const

Distribution &	setSeparator (const std::string &_sep)
	Set the character(s) used between the name and vector number on vectors, dist, etc.

const std::string &	setSeparator () const

Distribution &	unit (const units::Base *_unit)
	Set the unit of the stat.

Distribution &	desc (const std::string &_desc)
	Set the description and marks this stat to print at the end of simulation.

Distribution &	precision (int _precision)
	Set the precision and marks this stat to print at the end of simulation.

Distribution &	flags (Flags _flags)
	Set the flags and marks this stat to print at the end of simulation.

Distribution &	prereq (const Stat &prereq)
	Set the prerequisite stat and marks this stat to print at the end of simulation.

Public Member Functions inherited from gem5::statistics::InfoAccess
	InfoAccess ()

void	reset ()
	Reset the stat to the default state.

bool	zero () const

bool	check () const
	Check that this stat has been set up properly and is ready for use.

Additional Inherited Members
Public Types inherited from gem5::statistics::DistBase< Distribution, DistStor >
typedef DistInfoProxy< Distribution >	Info

typedef DistStor	Storage

typedef DistStor::Params	Params

Public Types inherited from gem5::statistics::DataWrap< Distribution, DistInfoProxy >
typedef DistInfoProxy< Distribution >	Info

Protected Member Functions inherited from gem5::statistics::DistBase< Distribution, DistStor >
	GEM5_ALIGNED (8) char storage[sizeof(Storage)]
	The storage for this stat.

Storage *	data ()
	Retrieve the storage.

const Storage *	data () const
	Retrieve a const pointer to the storage.

void	doInit ()

Protected Member Functions inherited from gem5::statistics::DataWrap< Distribution, DistInfoProxy >
Distribution &	self ()

Info *	info ()

Protected Member Functions inherited from gem5::statistics::InfoAccess
void	setInfo (Group parent, Info info)
	Set up an info class for this statistic.

void	setParams (const StorageParams *params)
	Save Storage class parameters if any.

void	setInit ()
	Save Storage class parameters if any.

Info *	info ()
	Grab the information class for this statistic.

const Info *	info () const
	Grab the information class for this statistic.

bool	newStyleStats () const
	Check if the info is new style stats.

Detailed Description

A simple distribution stat.

See also: Stat, DistBase, DistStor

Definition at line 2083 of file statistics.hh.

Constructor & Destructor Documentation

◆ Distribution() [1/3]

gem5::statistics::Distribution::Distribution ( Group * parent = nullptr )

inline

Definition at line 2086 of file statistics.hh.

◆ Distribution() [2/3]

gem5::statistics::Distribution::Distribution	(	Group *	parent,
		const char *	name,
		const char *	desc = nullptr )

inline

Definition at line 2092 of file statistics.hh.

◆ Distribution() [3/3]

gem5::statistics::Distribution::Distribution	(	Group *	parent,
		const char *	name,
		const units::Base *	unit,
		const char *	desc = nullptr )

inline

Definition at line 2098 of file statistics.hh.

Member Function Documentation

◆ init()

Distribution & gem5::statistics::Distribution::init	(	Counter	min,
		Counter	max,
		Counter	bkt )

inline

Set the parameters of this distribution.

See also: DistStor::Params

Parameters

min	The minimum value of the distribution.
max	The maximum value of the distribution.
bkt	The number of values in each bucket.

Returns: A reference to this distribution.

Definition at line 2112 of file statistics.hh.

References gem5::statistics::DistBase< Distribution, DistStor >::doInit(), gem5::statistics::DataWrap< Distribution, DistInfoProxy >::self(), and gem5::statistics::InfoAccess::setParams().

Referenced by gem5::o3::Commit::CommitStats::CommitStats(), gem5::ComputeUnit::ComputeUnitStats::ComputeUnitStats(), gem5::ExecStage::ExecStageStats::ExecStageStats(), gem5::FetchStage::FetchStageStats::FetchStageStats(), gem5::o3::Fetch::FetchStatGroup::FetchStatGroup(), gem5::o3::InstructionQueue::IQStats::IQStats(), gem5::o3::LSQUnit::LSQUnitStats::LSQUnitStats(), gem5::CommMonitor::MonitorStats::MonitorStats(), gem5::CoherentXBar::regStats(), gem5::Shader::ShaderStats::ShaderStats(), gem5::SMMUv3::SMMUv3Stats::SMMUv3Stats(), and gem5::Wavefront::WavefrontStats::WavefrontStats().

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

base/statistics.hh

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Distribution() [1/3]

◆ Distribution() [2/3]

◆ Distribution() [3/3]

Member Function Documentation

◆ init()