Simple data structure for histogram binning. More...

#include <JAbstractHistogram.hh>

Inheritance diagram for JTOOLS::JAbstractHistogram< JAbscissa_t >:

Public Types
typedef JAbscissa_t	abscissa_type

typedef JRange< abscissa_type >	range_type

typedef JLANG::JClass < JAbscissa_t >::argument_type	argument_type

typedef JKey_t	key_type

typedef JValue_t	mapped_type

Public Member Functions
	JAbstractHistogram ()
	Default constructor. More...

	JAbstractHistogram (const int nx, const abscissa_type xmin, const abscissa_type xmax)
	Constructor. More...

	JAbstractHistogram (const abscissa_type xmin, const abscissa_type xmax)
	Constructor. More...

int	getNumberOfBins () const
	Get number of bins. More...

void	setBinWidth (const abscissa_type dx, int option=0)
	Set bin width. More...

bool	is_valid () const
	Check validity of histogram binning. More...

	operator JGrid< abscissa_type > () const
	Type conversion operator. More...

const range_type &	getRange () const
	Get range. More...

void	setRange (const range_type &range)
	Set range. More...

void	setRange (argument_type x, argument_type y)
	Set lower and uppper limit. More...

void	setRange (iterator_type __begin, iterator_type __end, result_type value_type::*member)
	Set lower and uppper limit. More...

void	setRange (iterator_type __begin, iterator_type __end, result_type(value_type::*function)() const)
	Set lower and uppper limit. More...

JAbscissa_t	getLowerLimit () const
	Get lower limit. More...

JAbscissa_t	getUpperLimit () const
	Get upper limit. More...

void	setLowerLimit (argument_type x)
	Set lower limit. More...

void	setUpperLimit (argument_type y)
	Set upper limit. More...

void	fixLowerLimit (argument_type x)
	Fix lower limit. More...

void	fixUpperLimit (argument_type y)
	Fix upper limit. More...

bool	equals (const range_type &range) const
	Equal method. More...

JAbscissa_t	getLength () const
	Get length (difference between upper and lower limit). More...

bool	operator() (argument_type x) const
	Test whether value is inside range. More...

JAbscissa_t	constrain (argument_type x) const
	Constrain value to range. More...

bool	overlap (const range_type &range) const
	Test overlap with given range. More...

range_type	include (argument_type x)
	Include given value to range. More...

range_type &	join (const range_type &range)
	Join ranges. More...

range_type &	combine (const range_type &range)
	Combine ranges. More...

range_type &	add (argument_type x)
	Add offset. More...

range_type &	add (const range_type &range)
	Add offset. More...

range_type &	sub (argument_type x)
	Subtract offset. More...

range_type &	sub (const range_type &range)
	Subtract offset. More...

range_type &	mul (const double factor)
	Multiply range. More...

JFirst_t &	mul (const JSecond_t &object)
	Multiply with object. More...

range_type &	div (const double factor)
	Divide range. More...

JAbscissa_t	getN (const double R) const
	Get expected number of occurances of given rate within this interval. More...

const key_type &	getKey () const

const mapped_type &	getValue () const

mapped_type &	getValue ()

Static Public Member Functions
static JAbscissa_t	getMinimum ()
	Get minimum possible value. More...

static JAbscissa_t	getMaximum ()
	Get maximum possible value. More...

Public Attributes
std::less< JAbscissa_t >	compare
	Function object. More...

JKey_t	first

JValue_t	second

Static Public Attributes
static const JRange < JAbscissa_t, std::less < JAbscissa_t > >	DEFAULT_RANGE
	Default range. More...

Protected Attributes
int	number_of_bins

Friends
std::istream &	operator>> (std::istream &in, JAbstractHistogram< JAbscissa_t > &histogram)
	Read histogram from input. More...

std::ostream &	operator<< (std::ostream &out, const JAbstractHistogram< JAbscissa_t > &histogram)
	Write histogram to output. More...

Detailed Description

template<class JAbscissa_t>
struct JTOOLS::JAbstractHistogram< JAbscissa_t >

Simple data structure for histogram binning.

Definition at line 24 of file JAbstractHistogram.hh.

Member Typedef Documentation

template<class JAbscissa_t>

typedef JAbscissa_t JTOOLS::JAbstractHistogram< JAbscissa_t >::abscissa_type

Definition at line 28 of file JAbstractHistogram.hh.

template<class JAbscissa_t>

typedef JRange<abscissa_type> JTOOLS::JAbstractHistogram< JAbscissa_t >::range_type

Definition at line 29 of file JAbstractHistogram.hh.

typedef JLANG::JClass<JAbscissa_t >::argument_type JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::argument_type

inherited

Definition at line 41 of file JRange.hh.

template<class JKey_t, class JValue_t>

typedef JKey_t JTOOLS::JPair< JKey_t, JValue_t >::key_type

inherited

Definition at line 32 of file JPair.hh.

template<class JKey_t, class JValue_t>

typedef JValue_t JTOOLS::JPair< JKey_t, JValue_t >::mapped_type

inherited

Definition at line 33 of file JPair.hh.

Constructor & Destructor Documentation

template<class JAbscissa_t>

JTOOLS::JAbstractHistogram< JAbscissa_t >::JAbstractHistogram ( )

inline

Default constructor.

Definition at line 35 of file JAbstractHistogram.hh.

                          :
       JRange<JAbscissa_t>(),
       number_of_bins(0)
     {}

template<class JAbscissa_t>

JTOOLS::JAbstractHistogram< JAbscissa_t >::JAbstractHistogram	(	const int	nx,
		const abscissa_type	xmin,
		const abscissa_type	xmax
	)

inline

Constructor.

Parameters

nx	number of bins
xmin	lower limit
xmax	upper limit

Definition at line 48 of file JAbstractHistogram.hh.

                                                  :
       JRange<JAbscissa_t>(xmin, xmax),
       number_of_bins(nx)
     {}

template<class JAbscissa_t>

JTOOLS::JAbstractHistogram< JAbscissa_t >::JAbstractHistogram	(	const abscissa_type	xmin,
		const abscissa_type	xmax
	)

inline

Constructor.

Parameters

xmin	lower limit
xmax	upper limit

Definition at line 62 of file JAbstractHistogram.hh.

                                                  :
       JRange<JAbscissa_t>(xmin, xmax),
       number_of_bins(0)
     {}

Member Function Documentation

template<class JAbscissa_t>

int JTOOLS::JAbstractHistogram< JAbscissa_t >::getNumberOfBins ( ) const

inline

Get number of bins.

Returns: number of bins

Definition at line 74 of file JAbstractHistogram.hh.

     { 
       return number_of_bins;
     }

template<class JAbscissa_t>

void JTOOLS::JAbstractHistogram< JAbscissa_t >::setBinWidth	(	const abscissa_type	dx,
		int	option = `0`
	)

inline

Set bin width.

If option < 0, adjust lower limit; if option > 0, adjust upper limit; else no adjustments.

Parameters

dx	bin width
option	option

Definition at line 88 of file JAbstractHistogram.hh.

     { 
       number_of_bins = (int) (this->getLength() / dx);
 
       if (option < 0) { this->setLowerLimit(this->getUpperLimit() - number_of_bins + dx); }
       if (option > 0) { this->setUpperLimit(this->getLowerLimit() + number_of_bins + dx); }
     }

template<class JAbscissa_t>

bool JTOOLS::JAbstractHistogram< JAbscissa_t >::is_valid ( ) const

inline

Check validity of histogram binning.

Returns: true if both range and number of bins are valid; else false

Definition at line 102 of file JAbstractHistogram.hh.

     {
       return static_cast<const range_type&>(*this).is_valid() && number_of_bins > 0;
     }

template<class JAbscissa_t>

JTOOLS::JAbstractHistogram< JAbscissa_t >::operator JGrid< abscissa_type > ( ) const

inline

Type conversion operator.

Returns: grid

Definition at line 113 of file JAbstractHistogram.hh.

     {
       return make_grid(this->getNumberOfBins() + 1, this->getLowerLimit(), this->getUpperLimit());
     }

const range_type& JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::getRange ( ) const

inlineinherited

Get range.

Returns: range

Definition at line 109 of file JRange.hh.

     {
       return static_cast<const range_type&>(*this);
     }

void JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::setRange ( const range_type & range )

inlineinherited

Set range.

Parameters

range range

Definition at line 120 of file JRange.hh.

     {
       static_cast<range_type&>(*this) = range;
     }

void JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::setRange	(	argument_type	x,
		argument_type	y
	)

inlineinherited

Set lower and uppper limit.

Parameters

x	lower limit
y	upper limit

Definition at line 132 of file JRange.hh.

     {
       this->first  = x;
       this->second = y;
     }

void JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::setRange	(	iterator_type	__begin,
		iterator_type	__end,
		result_type value_type::*	member
	)

inlineinherited

Set lower and uppper limit.

Parameters

__begin	begin of data
__end	end of data
member	pointer to data member

Definition at line 147 of file JRange.hh.

     {
       setRange(getMaximum(), getMinimum());
 
       for (iterator_type i = __begin; i != __end; ++i) {
         include((*i).*member);
       }
     }

void JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::setRange	(	iterator_type	__begin,
		iterator_type	__end,
		result_type(value_type::*)() const	function
	)

inlineinherited

Set lower and uppper limit.

Parameters

__begin	begin of data
__end	end of data
function	pointer to member method

Definition at line 165 of file JRange.hh.

     {
       setRange(getMaximum(), getMinimum());
 
       for (iterator_type i = __begin; i != __end; ++i) {
         include(((*i).*function)());
       }
     }

JAbscissa_t JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::getLowerLimit ( ) const

inlineinherited

Get lower limit.

Returns: lower limit

Definition at line 180 of file JRange.hh.

     {
       return this->first;
     }

JAbscissa_t JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::getUpperLimit ( ) const

inlineinherited

Get upper limit.

Returns: upper limit

Definition at line 191 of file JRange.hh.

     {
       return this->second;
     }

void JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::setLowerLimit ( argument_type x )

inlineinherited

Set lower limit.

Parameters

x	lower limit

Definition at line 202 of file JRange.hh.

     {
       this->first  = x;
     }

void JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::setUpperLimit ( argument_type y )

inlineinherited

Set upper limit.

Parameters

y	upper limit

Definition at line 213 of file JRange.hh.

     {
       this->second = y;
     }

void JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::fixLowerLimit ( argument_type x )

inlineinherited

Fix lower limit.

The range is shifted to the given lower limit.

Parameters

x	lower limit

Definition at line 226 of file JRange.hh.

     {
       this->second += x - this->first;
       this->first   = x;
     }

void JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::fixUpperLimit ( argument_type y )

inlineinherited

Fix upper limit.

The range is shifted to the given upper limit.

Parameters

y	upper limit

Definition at line 240 of file JRange.hh.

     {
       this->first  += y - this->second;
       this->second  = y;
     }

bool JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::equals ( const range_type & range ) const

inlineinherited

Equal method.

Parameters

range range

Returns: true if this module range equal to given module range; else false

Definition at line 253 of file JRange.hh.

     {
       return (!this->compare(this->getLowerLimit(), range.getLowerLimit()) &&
               !this->compare(range.getLowerLimit(), this->getLowerLimit()) &&
               !this->compare(this->getUpperLimit(), range.getUpperLimit()) &&
               !this->compare(range.getUpperLimit(), this->getUpperLimit()));
     }

JAbscissa_t JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::getLength ( ) const

inlineinherited

Get length (difference between upper and lower limit).

Returns: length

Definition at line 267 of file JRange.hh.

     {
       return getUpperLimit() - getLowerLimit();
     }

bool JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::operator() ( argument_type x ) const

inlineinherited

Test whether value is inside range.

Parameters

x value

Returns: true if lower limit <= value <= upper limit; else false

Definition at line 290 of file JRange.hh.

     {
       return (!compare(x, getLowerLimit()) && 
               !compare(getUpperLimit(), x));
     }

JAbscissa_t JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::constrain ( argument_type x ) const

inlineinherited

Constrain value to range.

This method returns the original value if it is in this range, else lower limit if value < lower limit or upper limit if value > upper limit.

Parameters

x value

Returns: lower limit <= x <= upper limit

Definition at line 305 of file JRange.hh.

     {
       if (compare(x, getLowerLimit())) return getLowerLimit();
       if (compare(getUpperLimit(), x)) return getUpperLimit();
 
       return x;
     }

bool JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::overlap ( const range_type & range ) const

inlineinherited

Test overlap with given range.

The result is equivalent to join(range).is_valid().

Parameters

range range

Returns: true if there is a non-zero overlap; else false

Definition at line 321 of file JRange.hh.

     {  
       return (compare(getLowerLimit(), range.getUpperLimit()) &&
               compare(range.getLowerLimit(), getUpperLimit()));
     }

range_type JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::include ( argument_type x )

inlineinherited

Include given value to range.

The new lower limit is the minimim of the original lower limit and given value and the new upper limit is the maximum of the original upper limit and given value;

Parameters

x value

Returns: range

Definition at line 336 of file JRange.hh.

     {
       if (compare(x, getLowerLimit())) setLowerLimit(x);
       if (compare(getUpperLimit(), x)) setUpperLimit(x);
 
       return *this;
     }

range_type& JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::join ( const range_type & range )

inlineinherited

Join ranges.

The new lower limit is the maximim of the two lower limits and the new upper limit is the minimum of the two upper limits. This operation results in an equal or smaller range and may result in an unphysical range (i.e. lower limit > upper limit).

Parameters

range range

Definition at line 354 of file JRange.hh.

     {  
       if (compare(getLowerLimit(), range.getLowerLimit())) setLowerLimit(range.getLowerLimit());
       if (compare(range.getUpperLimit(), getUpperLimit())) setUpperLimit(range.getUpperLimit());
 
       return *this;      
     }

range_type& JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::combine ( const range_type & range )

inlineinherited

Combine ranges.

The new lower limit is the minimim of the two lower limits and the new upper limit is the maximum of the two upper limits. This operation results in an equal or larger range.

Parameters

range range

Definition at line 371 of file JRange.hh.

     {  
       if (compare(range.getLowerLimit(), getLowerLimit())) setLowerLimit(range.getLowerLimit());
       if (compare(getUpperLimit(), range.getUpperLimit())) setUpperLimit(range.getUpperLimit());
 
       return *this;
     }

range_type& JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::add ( argument_type x )

inlineinherited

Add offset.

Parameters

x offset

Definition at line 385 of file JRange.hh.

     { 
       this->first  += x;
       this->second += x;
 
       return *this;
     }

range_type& JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::add ( const range_type & range )

inlineinherited

Add offset.

The new lower limit is the sum of the two lower limits and the new upper limit is the sum of the two upper limits.

Parameters

range offset

Definition at line 415 of file JRange.hh.

     { 
       this->first  += range.getLowerLimit();
       this->second += range.getUpperLimit();
 
       return *this;
     }

range_type& JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::sub ( argument_type x )

inlineinherited

Subtract offset.

Parameters

x offset

Definition at line 399 of file JRange.hh.

     { 
       this->first  -= x;
       this->second -= x;
 
       return *this;
     }

range_type& JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::sub ( const range_type & range )

inlineinherited

Subtract offset.

The new lower limit is the difference of the two lower limits and the new upper limit is the difference of the two upper limits.

Parameters

range offset

Definition at line 431 of file JRange.hh.

     { 
       this->first  -= range.getLowerLimit();
       this->second -= range.getUpperLimit();
 
       return *this;
     }

range_type& JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::mul ( const double factor )

inlineinherited

Multiply range.

Parameters

factor factor

Definition at line 445 of file JRange.hh.

     { 
       this->first  *= factor;
       this->second *= factor;
 
       return *this;
     }

template<class JFirst_t, class JSecond_t = JNullType>

JFirst_t& JMATH::JMath< JFirst_t, JSecond_t >::mul ( const JSecond_t & object )

inlineinherited

Multiply with object.

Parameters

object object

Returns: result object

Definition at line 273 of file JMath.hh.

     {
       return static_cast<JFirst_t&>(*this) = JCalculator<JFirst_t>::calculator.mul(static_cast<const JFirst_t&>(*this), object);
     }

range_type& JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::div ( const double factor )

inlineinherited

Divide range.

Parameters

factor factor

Definition at line 459 of file JRange.hh.

     { 
       this->first  /= factor;
       this->second /= factor;
 
       return *this;
     }

JAbscissa_t JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::getN ( const double R ) const

inlineinherited

Get expected number of occurances of given rate within this interval.

Parameters

R rate

Returns: expectation value

Definition at line 474 of file JRange.hh.

     {
       return R * (getUpperLimit() - getLowerLimit());
     }

static JAbscissa_t JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::getMinimum ( )

inlinestaticinherited

Get minimum possible value.

Returns: minimum possible value

Definition at line 485 of file JRange.hh.

     { 
       return JMATH::JLimits<T>::min();
     }

static JAbscissa_t JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::getMaximum ( )

inlinestaticinherited

Get maximum possible value.

Returns: maximum possible value

Definition at line 496 of file JRange.hh.

     { 
       return JMATH::JLimits<T>::max();
     }

template<class JKey_t, class JValue_t>

const key_type& JTOOLS::JPair< JKey_t, JValue_t >::getKey ( ) const

inlineinherited

Definition at line 123 of file JPair.hh.

123 { return this->first; }

JTOOLS::JPair::first

JKey_t first

Definition: JPair.hh:128

template<class JKey_t, class JValue_t>

const mapped_type& JTOOLS::JPair< JKey_t, JValue_t >::getValue ( ) const

inlineinherited

Definition at line 124 of file JPair.hh.

124 { return this->second; }

JTOOLS::JPair::second

JValue_t second

Definition: JPair.hh:129

template<class JKey_t, class JValue_t>

mapped_type& JTOOLS::JPair< JKey_t, JValue_t >::getValue ( )

inlineinherited

Definition at line 126 of file JPair.hh.

126 { return this->second; }

JTOOLS::JPair::second

JValue_t second

Definition: JPair.hh:129

Friends And Related Function Documentation

template<class JAbscissa_t>

std::istream& operator>>	(	std::istream &	in,
		JAbstractHistogram< JAbscissa_t > &	histogram
	)

friend

Read histogram from input.

Parameters

in	input stream
histogram	histogram

Returns: input stream

Definition at line 126 of file JAbstractHistogram.hh.

     {
       return in >> histogram.number_of_bins >> static_cast<range_type&>(histogram);
     }

template<class JAbscissa_t>

std::ostream& operator<<	(	std::ostream &	out,
		const JAbstractHistogram< JAbscissa_t > &	histogram
	)

friend

Write histogram to output.

Parameters

out	output stream
histogram	histogram

Returns: output stream

Definition at line 139 of file JAbstractHistogram.hh.

     {
       return out << histogram.number_of_bins << ' ' << static_cast<const range_type&>(histogram);
     }

Member Data Documentation

template<class JAbscissa_t>

int JTOOLS::JAbstractHistogram< JAbscissa_t >::number_of_bins

protected

Definition at line 145 of file JAbstractHistogram.hh.

const JRange<JAbscissa_t , std::less<JAbscissa_t > > JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::DEFAULT_RANGE

staticinherited

Default range.

This range corresponds to an unphysical range.

Definition at line 506 of file JRange.hh.

std::less<JAbscissa_t > JTOOLS::JRange< JAbscissa_t , std::less<JAbscissa_t > >::compare

inherited

Function object.

Parameters

first	first argument
second	second argument

Returns: true if first < second; else false

Definition at line 516 of file JRange.hh.

template<class JKey_t, class JValue_t>

JKey_t JTOOLS::JPair< JKey_t, JValue_t >::first

inherited

Definition at line 128 of file JPair.hh.

template<class JKey_t, class JValue_t>

JValue_t JTOOLS::JPair< JKey_t, JValue_t >::second

inherited

Definition at line 129 of file JPair.hh.

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

JAbstractHistogram.hh

Public Types

Public Member Functions

Static Public Member Functions

Public Attributes

Static Public Attributes

Protected Attributes

Friends

Detailed Description

template<class JAbscissa_t> struct JTOOLS::JAbstractHistogram< JAbscissa_t >

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation

template<class JAbscissa_t>
struct JTOOLS::JAbstractHistogram< JAbscissa_t >