#include <itkHistogram.h>

Inheritance diagram for itk::Statistics::Histogram< TMeasurement, TFrequencyContainer >:

Collaboration diagram for itk::Statistics::Histogram< TMeasurement, TFrequencyContainer >:

Detailed Description

template<class TMeasurement = float, class TFrequencyContainer = DenseFrequencyContainer2>
class itk::Statistics::Histogram< TMeasurement, TFrequencyContainer >

This class stores measurement vectors in the context of n-dimensional histogram.

Histogram represents an ND histogram. Histogram bins can be regularly or irregularly spaced. The storage for the histogram is managed via the FrequencyContainer specified by the template argument. The default frequency container is a DenseFrequencyContainer. A SparseFrequencyContainer can be used as an alternative.

Frequencies of a bin (SetFrequency(), IncreaseFrequency()) can be specified by measurement, index, or instance identifier.

Measurements can be queried by bin index or instance identifier. In this case, the measurement returned in the centroid of the histogram bin.

The Initialize() method is used to specified the number of bins for each dimension of the histogram. An overloaded version also allows for regularly spaced bins to defined. To define irregularly sized bins, use the SetBinMin()/SetBinMax() methods.

If you do not know the length of the measurement vector at compile time, you should use the VariableDimensionHistogram class, instead of the Histogram class.

If you know the length of the measuremen vector at compile time, you can conveniently be obtained from MeasurementVectorTraits. For instance, instantiate a histogram as below:

typedef Histogram< THistogramMeasurement, typename TFrequencyContainer > HistogramType;

See Also: Sample, DenseFrequencyContainer, SparseFrequencyContainer, VariableDimensionHistogram

Wiki Examples:

All Examples

Compute a histogram from measurements.

Definition at line 77 of file itkHistogram.h.

Classes
class	ConstIterator
	class that walks through the elements of the histogram. More...

class	Iterator
	class that walks through the elements of the histogram. More...

Public Types
typedef FrequencyContainerType::AbsoluteFrequencyType	AbsoluteFrequencyType

typedef Array< TMeasurement >	ArrayType

typedef std::vector < BinMaxVectorType >	BinMaxContainerType

typedef std::vector < MeasurementType >	BinMaxVectorType

typedef std::vector < BinMinVectorType >	BinMinContainerType

typedef std::vector < MeasurementType >	BinMinVectorType

typedef SmartPointer< const Self >	ConstPointer

typedef FrequencyContainerType::Pointer	FrequencyContainerPointer

typedef TFrequencyContainer	FrequencyContainerType

typedef Array < ::itk::IndexValueType >	IndexType

typedef IndexType::ValueType	IndexValueType

typedef Superclass::InstanceIdentifier	InstanceIdentifier

typedef TMeasurement	MeasurementType

typedef Superclass::MeasurementVectorSizeType	MeasurementVectorSizeType

typedef Superclass::MeasurementVectorType	MeasurementVectorType

typedef SmartPointer< Self >	Pointer

typedef FrequencyContainerType::RelativeFrequencyType	RelativeFrequencyType

typedef Histogram	Self

typedef Array < ::itk::SizeValueType >	SizeType

typedef SizeType::ValueType	SizeValueType

typedef Sample< ArrayType >	Superclass

typedef FrequencyContainerType::TotalAbsoluteFrequencyType	TotalAbsoluteFrequencyType

typedef FrequencyContainerType::TotalRelativeFrequencyType	TotalRelativeFrequencyType

typedef MeasurementVectorType	ValueType

Public Types inherited from itk::Statistics::Sample< Array< TMeasurement > >
typedef MeasurementVectorTraits::AbsoluteFrequencyType	AbsoluteFrequencyType

typedef SmartPointer< const Self >	ConstPointer

typedef MeasurementVectorTraits::InstanceIdentifier	InstanceIdentifier

typedef MeasurementVectorTraitsTypes < MeasurementVectorType > ::ValueType	MeasurementType

typedef unsigned int	MeasurementVectorSizeType

typedef Array< TMeasurement >	MeasurementVectorType

typedef SmartPointer< Self >	Pointer

typedef Sample	Self

typedef DataObject	Superclass

typedef NumericTraits < AbsoluteFrequencyType > ::AccumulateType	TotalAbsoluteFrequencyType

Public Types inherited from itk::DataObject
typedef SmartPointer< const Self >	ConstPointer

typedef std::string	DataObjectIdentifierType

typedef std::vector< Pointer > ::size_type	DataObjectPointerArraySizeType

typedef SmartPointer< Self >	Pointer

typedef DataObject	Self

typedef Object	Superclass

Public Types inherited from itk::Object
typedef SmartPointer< const Self >	ConstPointer

typedef SmartPointer< Self >	Pointer

typedef Object	Self

typedef LightObject	Superclass

Public Types inherited from itk::LightObject
typedef SmartPointer< const Self >	ConstPointer

typedef SmartPointer< Self >	Pointer

typedef LightObject	Self

Public Member Functions
Iterator	Begin ()

ConstIterator	Begin () const

virtual ::itk::LightObject::Pointer	CreateAnother (void) const

Iterator	End ()

ConstIterator	End () const

const MeasurementType &	GetBinMax (unsigned int dimension, InstanceIdentifier nbin) const

const MeasurementType &	GetBinMaxFromValue (unsigned int dimension, float value) const

const MeasurementType &	GetBinMin (unsigned int dimension, InstanceIdentifier nbin) const

const MeasurementType &	GetBinMinFromValue (unsigned int dimension, float value) const

virtual bool	GetClipBinsAtEnds () const

const BinMaxVectorType &	GetDimensionMaxs (unsigned int dimension) const

const BinMinVectorType &	GetDimensionMins (unsigned int dimension) const

AbsoluteFrequencyType	GetFrequency (InstanceIdentifier id) const

AbsoluteFrequencyType	GetFrequency (const IndexType &index) const

const MeasurementVectorType &	GetHistogramMaxFromIndex (const IndexType &index) const

const MeasurementVectorType &	GetHistogramMinFromIndex (const IndexType &index) const

bool	GetIndex (const MeasurementVectorType &measurement, IndexType &index) const

const IndexType &	GetIndex (InstanceIdentifier id) const

InstanceIdentifier	GetInstanceIdentifier (const IndexType &index) const

const BinMaxContainerType &	GetMaxs () const

const BinMinContainerType &	GetMins () const

virtual const char *	GetNameOfClass () const

const SizeType &	GetSize () const

SizeValueType	GetSize (unsigned int dimension) const

virtual void	Graft (const DataObject *)

bool	IncreaseFrequency (InstanceIdentifier id, AbsoluteFrequencyType value)

bool	IncreaseFrequencyOfIndex (const IndexType &index, AbsoluteFrequencyType value)

void	Initialize (const SizeType &size)

void	Initialize (const SizeType &size, MeasurementVectorType &lowerBound, MeasurementVectorType &upperBound)

bool	IsIndexOutOfBounds (const IndexType &index) const

	itkLegacyMacro (const IndexType &GetIndex(const MeasurementVectorType &measurement) const)

double	Mean (unsigned int dimension) const

void	SetBinMax (unsigned int dimension, InstanceIdentifier nbin, MeasurementType max)

void	SetBinMin (unsigned int dimension, InstanceIdentifier nbin, MeasurementType min)

virtual void	SetClipBinsAtEnds (bool _arg)

void	SetFrequency (AbsoluteFrequencyType value)

bool	SetFrequency (InstanceIdentifier id, AbsoluteFrequencyType value)

bool	SetFrequencyOfIndex (const IndexType &index, AbsoluteFrequencyType value)

bool	SetFrequencyOfMeasurement (const MeasurementVectorType &measurement, AbsoluteFrequencyType value)

void	SetToZero ()

InstanceIdentifier	Size () const


bool	IncreaseFrequencyOfMeasurement (const MeasurementVectorType &measurement, AbsoluteFrequencyType value)

const MeasurementVectorType &	GetMeasurementVector (InstanceIdentifier id) const

const MeasurementVectorType &	GetMeasurementVector (const IndexType &index) const

MeasurementType	GetMeasurement (InstanceIdentifier n, unsigned int dimension) const

TotalAbsoluteFrequencyType	GetTotalFrequency () const

AbsoluteFrequencyType	GetFrequency (InstanceIdentifier n, unsigned int dimension) const

double	Quantile (unsigned int dimension, double p) const

Public Member Functions inherited from itk::Statistics::Sample< Array< TMeasurement > >
virtual AbsoluteFrequencyType	GetFrequency (InstanceIdentifier id) const =0

virtual const MeasurementVectorType &	GetMeasurementVector (InstanceIdentifier id) const =0

virtual MeasurementVectorSizeType	GetMeasurementVectorSize () const

virtual void	SetMeasurementVectorSize (MeasurementVectorSizeType s)

Public Member Functions inherited from itk::DataObject
virtual void	CopyInformation (const DataObject *)

virtual void	DataHasBeenGenerated ()

void	DisconnectPipeline ()

bool	GetDataReleased () const

virtual const bool &	GetReleaseDataFlag ()

SmartPointerForwardReference < ProcessObject >	GetSource () const

DataObjectPointerArraySizeType	GetSourceOutputIndex () const

const DataObjectIdentifierType &	GetSourceOutputName () const

virtual ModifiedTimeType	GetUpdateMTime () const

virtual void	PrepareForNewData ()

virtual void	PropagateRequestedRegion ()

void	ReleaseData ()

virtual void	ReleaseDataFlagOff ()

virtual void	ReleaseDataFlagOn ()

virtual bool	RequestedRegionIsOutsideOfTheBufferedRegion ()

virtual void	ResetPipeline ()

void	SetReleaseDataFlag (bool flag)

virtual void	SetRequestedRegion (const DataObject *)

virtual void	SetRequestedRegionToLargestPossibleRegion ()

bool	ShouldIReleaseData () const

virtual void	Update ()

virtual void	UpdateOutputData ()

virtual void	UpdateOutputInformation ()

virtual bool	VerifyRequestedRegion ()

void	SetPipelineMTime (ModifiedTimeType time)

virtual const ModifiedTimeType &	GetPipelineMTime ()

virtual void	SetRealTimeStamp (RealTimeStamp _arg)

virtual const RealTimeStamp &	GetRealTimeStamp ()

Public Member Functions inherited from itk::Object
unsigned long	AddObserver (const EventObject &event, Command *)

unsigned long	AddObserver (const EventObject &event, Command *) const

virtual void	DebugOff () const

virtual void	DebugOn () const

Command *	GetCommand (unsigned long tag)

bool	GetDebug () const

MetaDataDictionary &	GetMetaDataDictionary (void)

const MetaDataDictionary &	GetMetaDataDictionary (void) const

virtual ModifiedTimeType	GetMTime () const

virtual const TimeStamp &	GetTimeStamp () const

bool	HasObserver (const EventObject &event) const

void	InvokeEvent (const EventObject &)

void	InvokeEvent (const EventObject &) const

virtual void	Modified () const

virtual void	Register () const

void	RemoveAllObservers ()

void	RemoveObserver (unsigned long tag)

void	SetDebug (bool debugFlag) const

void	SetMetaDataDictionary (const MetaDataDictionary &rhs)

virtual void	SetReferenceCount (int)

virtual void	UnRegister () const

Public Member Functions inherited from itk::LightObject
virtual void	Delete ()

virtual int	GetReferenceCount () const

	itkCloneMacro (Self)

void	Print (std::ostream &os, Indent indent=0) const

Static Public Member Functions
static Pointer	New ()

Protected Member Functions
	Histogram ()

void	PrintSelf (std::ostream &os, Indent indent) const

virtual	~Histogram ()

Protected Member Functions inherited from itk::Statistics::Sample< Array< TMeasurement > >
void	PrintSelf (std::ostream &os, Indent indent) const

	Sample ()

virtual	~Sample ()

Protected Member Functions inherited from itk::DataObject
	DataObject ()

virtual void	PropagateResetPipeline ()

	~DataObject ()

Protected Member Functions inherited from itk::Object
	Object ()

bool	PrintObservers (std::ostream &os, Indent indent) const

virtual void	SetTimeStamp (const TimeStamp &time)

virtual	~Object ()

Protected Member Functions inherited from itk::LightObject
virtual LightObject::Pointer	InternalClone () const

	LightObject ()

virtual void	PrintHeader (std::ostream &os, Indent indent) const

virtual void	PrintTrailer (std::ostream &os, Indent indent) const

virtual	~LightObject ()

Protected Attributes
SizeType	m_Size

Private Types
typedef std::vector < InstanceIdentifier >	OffsetTableType

Private Member Functions
	Histogram (const Self &)

virtual void	Initialize ()

void	operator= (const Self &)

Private Attributes
bool	m_ClipBinsAtEnds

FrequencyContainerPointer	m_FrequencyContainer

std::vector< std::vector < MeasurementType > >	m_Max

std::vector< std::vector < MeasurementType > >	m_Min

unsigned int	m_NumberOfInstances

OffsetTableType	m_OffsetTable

IndexType	m_TempIndex

MeasurementVectorType	m_TempMeasurementVector

Additional Inherited Members
Protected Types inherited from itk::LightObject
typedef int	InternalReferenceCountType