template<typename realT>
class mx::math::histogramUniform< realT >

A histogram with uniform bin spacing.

Calculates the frequency in bins with uniform spacing.

Template Parameters

realT the real data type

Definition at line 43 of file histogramUniform.hpp.

#include <math/histogramUniform.hpp>

Public Member Functions
	histogramUniform ()
	Default c'tor, does not allocate.

	histogramUniform (realT mn, realT mx, realT w)
	Setup the histogram, performing allocations.

void	setup (realT mn, realT mx, realT w)
	Setup the histogram, performing allocations.

void	reset ()
	Resize and 0 the frequency vector. Assumes m_min, m_max, and m_width are set.

void	accum (const realT &val)
	Accumulate a value in the appropriate bin.

void	accum (const std::vector< realT > &vals)
	Accumulate a vector of values.

realT	freq (int i)
	Get the frequency in the i-th bin.

int	bins ()
	Get the number of bins.

realT	binLeft (int i)
	Get the value of the left-edge of the i-th bin.

realT	binMid (int i)
	Get the value of the middle of the i-th bin.

realT	binRight (int i)
	Get the value of the right edge of the i-th bin.

void	normalize (int excludeTop=0)
	Normalize the current frequencies so that the integral over all bins is 1.

Public Attributes
realT	m_min { 0 }
	The mininum bin location.

realT	m_max { 0 }
	The maximum bin location.

realT	m_width { 0 }
	The bin width.

std::vector< realT >	_freqs
	The frequencies, one for each bin.

Constructor & Destructor Documentation

◆ histogramUniform() [1/2]

template<typename realT >

mx::math::histogramUniform< realT >::histogramUniform ( )

inline

Default c'tor, does not allocate.

Must call setup before use

Definition at line 54 of file histogramUniform.hpp.

◆ histogramUniform() [2/2]

template<typename realT >

mx::math::histogramUniform< realT >::histogramUniform	(	realT	mn,
		realT	mx,
		realT	w
	)

inline

Setup the histogram, performing allocations.

Parameters

[in]	mn	the new minimum bin location
[in]	mx	the new maximum bin location
[in]	w	the bin width

Definition at line 59 of file histogramUniform.hpp.

References mx::math::histogramUniform< realT >::reset().

Member Function Documentation

◆ accum() [1/2]

template<typename realT >

void mx::math::histogramUniform< realT >::accum ( const realT & val )

inline

Accumulate a value in the appropriate bin.

Parameters

[in] val The value to accumulate

Definition at line 88 of file histogramUniform.hpp.

References mx::math::histogramUniform< realT >::_freqs, mx::math::histogramUniform< realT >::m_min, mx::math::histogramUniform< realT >::m_width, and mx::math::six_fifths().

Referenced by mx::math::histogramUniform< realT >::accum().

◆ accum() [2/2]

template<typename realT >

void mx::math::histogramUniform< realT >::accum ( const std::vector< realT > & vals )

inline

Accumulate a vector of values.

Parameters

[in] vals The vector of values to accumulate

Definition at line 100 of file histogramUniform.hpp.

References mx::math::histogramUniform< realT >::accum(), and mx::math::six_fifths().

◆ binLeft()

template<typename realT >

realT mx::math::histogramUniform< realT >::binLeft ( int i )

inline

Get the value of the left-edge of the i-th bin.

Returns: the value of the left-edge of the i-th bin.

Parameters

[in] i the bin number

Definition at line 119 of file histogramUniform.hpp.

References mx::math::histogramUniform< realT >::m_min, mx::math::histogramUniform< realT >::m_width, and mx::math::six_fifths().

◆ binMid()

template<typename realT >

realT mx::math::histogramUniform< realT >::binMid ( int i )

inline

Get the value of the middle of the i-th bin.

Returns: the value of the middle of the i-th bin.

Parameters

[in] i the bin number

Definition at line 125 of file histogramUniform.hpp.

References mx::math::histogramUniform< realT >::m_min, mx::math::histogramUniform< realT >::m_width, and mx::math::six_fifths().

◆ binRight()

template<typename realT >

realT mx::math::histogramUniform< realT >::binRight ( int i )

inline

Get the value of the right edge of the i-th bin.

Returns: the value of the right edge of the i-th bin.

Parameters

[in] i the bin number

Definition at line 131 of file histogramUniform.hpp.

References mx::math::histogramUniform< realT >::m_min, mx::math::histogramUniform< realT >::m_width, and mx::math::six_fifths().

◆ bins()

template<typename realT >

int mx::math::histogramUniform< realT >::bins ( )

inline

Get the number of bins.

Returns: the size of the frequency vector.

Definition at line 113 of file histogramUniform.hpp.

References mx::math::histogramUniform< realT >::_freqs.

◆ freq()

template<typename realT >

realT mx::math::histogramUniform< realT >::freq ( int i )

inline

Get the frequency in the i-th bin.

Returns: the current value of _freqs[i].

Parameters

[in] i the bin number

Definition at line 107 of file histogramUniform.hpp.

References mx::math::histogramUniform< realT >::_freqs, and mx::math::six_fifths().

◆ normalize()

template<typename realT >

void mx::math::histogramUniform< realT >::normalize ( int excludeTop = 0 )

inline

Normalize the current frequencies so that the integral over all bins is 1.

This normalizes the histogram so that it is a probability distribution, such that the sum \( \sum_i P_i \Delta x = 1 \) where \( \Delta x \) is the bin width.

Parameters

[in] excludeTop [optional] specifies a number of bins at the top of the range to exclude from the sum

Definition at line 140 of file histogramUniform.hpp.

References mx::math::histogramUniform< realT >::_freqs, mx::math::histogramUniform< realT >::m_width, and mx::math::six_fifths().

◆ reset()

template<typename realT >

void mx::math::histogramUniform< realT >::reset ( )

inline

Resize and 0 the frequency vector. Assumes m_min, m_max, and m_width are set.

Definition at line 82 of file histogramUniform.hpp.

References mx::math::histogramUniform< realT >::_freqs, mx::math::histogramUniform< realT >::m_max, mx::math::histogramUniform< realT >::m_min, and mx::math::histogramUniform< realT >::m_width.

Referenced by mx::math::histogramUniform< realT >::histogramUniform(), and mx::math::histogramUniform< realT >::setup().

◆ setup()

template<typename realT >

void mx::math::histogramUniform< realT >::setup	(	realT	mn,
		realT	mx,
		realT	w
	)

inline

Setup the histogram, performing allocations.

Parameters

[in]	mn	the new minimum bin location
[in]	mx	the new maximum bin location
[in]	w	the bin width

Definition at line 69 of file histogramUniform.hpp.

References mx::math::histogramUniform< realT >::m_max, mx::math::histogramUniform< realT >::m_min, mx::math::histogramUniform< realT >::m_width, mx::math::histogramUniform< realT >::reset(), and mx::math::six_fifths().

Member Data Documentation

◆ _freqs

template<typename realT >

std::vector<realT> mx::math::histogramUniform< realT >::_freqs

The frequencies, one for each bin.

Definition at line 50 of file histogramUniform.hpp.

Referenced by mx::math::histogramUniform< realT >::accum(), mx::math::histogramUniform< realT >::bins(), mx::math::histogramUniform< realT >::freq(), mx::math::histogramUniform< realT >::normalize(), and mx::math::histogramUniform< realT >::reset().

◆ m_max

template<typename realT >

realT mx::math::histogramUniform< realT >::m_max { 0 }

The maximum bin location.

Definition at line 47 of file histogramUniform.hpp.

Referenced by mx::math::histogramUniform< realT >::reset(), and mx::math::histogramUniform< realT >::setup().

◆ m_min

template<typename realT >

realT mx::math::histogramUniform< realT >::m_min { 0 }

The mininum bin location.

Definition at line 46 of file histogramUniform.hpp.

Referenced by mx::math::histogramUniform< realT >::accum(), mx::math::histogramUniform< realT >::binLeft(), mx::math::histogramUniform< realT >::binMid(), mx::math::histogramUniform< realT >::binRight(), mx::math::histogramUniform< realT >::reset(), and mx::math::histogramUniform< realT >::setup().

◆ m_width

template<typename realT >

realT mx::math::histogramUniform< realT >::m_width { 0 }

The bin width.

Definition at line 48 of file histogramUniform.hpp.

Referenced by mx::math::histogramUniform< realT >::accum(), mx::math::histogramUniform< realT >::binLeft(), mx::math::histogramUniform< realT >::binMid(), mx::math::histogramUniform< realT >::binRight(), mx::math::histogramUniform< realT >::normalize(), mx::math::histogramUniform< realT >::reset(), and mx::math::histogramUniform< realT >::setup().

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

math/histogramUniform.hpp

Public Member Functions

Public Attributes

Constructor & Destructor Documentation

◆ histogramUniform() [1/2]

◆ histogramUniform() [2/2]

Member Function Documentation

◆ accum() [1/2]

◆ accum() [2/2]

◆ binLeft()

◆ binMid()

◆ binRight()

◆ bins()

◆ freq()

◆ normalize()

◆ reset()

◆ setup()

Member Data Documentation

◆ _freqs

◆ m_max

◆ m_min

◆ m_width