HippoDraw Class Library

If the bins have all the same width, then returns the bin width. If the bin width are determined by some algorithm, then returns a parameter used to calculate the bin widths.

Implements BinsBase.

Definition at line 176 of file Bins2DBase.cxx.

References Bins2DBase::binner_axisX, Bins2DBase::binner_axisY, BinnerAxis::getConstWid(), hippodraw::Axes::X, and hippodraw::Axes::Y.

double binWidthX ( int i ) const [inherited]

Gets the bin width of the X bin for the i bin.

Definition at line 185 of file Bins2DBase.cxx.

References BinnerAxis::axisBinWidth(), and Bins2DBase::binner_axisX.

Referenced by Bins2DProfile::fillDataSource(), Bins2DHist::fillDataSource(), Bins2DHist::getZValue(), and Bins2DHist::setBinContents().

double binWidthY ( int i ) const [inherited]

Gets the bin width of the Y bin for the i bin.

Definition at line 190 of file Bins2DBase.cxx.

References BinnerAxis::axisBinWidth(), and Bins2DBase::binner_axisY.

Referenced by Bins2DProfile::fillDataSource(), Bins2DHist::fillDataSource(), Bins2DHist::getZValue(), and Bins2DHist::setBinContents().

double calcBinWidth	(	hippodraw::Axes::Type	axis,
		int	parm,
		bool	dragging
	)			const `[virtual, inherited]`

Calculates the bin width parameter from dragging slider.

Implements BinsBase.

Definition at line 236 of file Bins2DBase.cxx.

References Bins2DBase::binner_axisX, Bins2DBase::binner_axisY, BinnerAxis::calcBinWidth(), and hippodraw::Axes::X.

double calcOffset	(	const std::string &	axis,
		int	parm,
		bool	dragging
	)			const `[virtual, inherited]`

Calculates and returns a new range from dragging slider.

Implements BinsBase.

Definition at line 251 of file Bins2DBase.cxx.

References Bins2DBase::binner_axisX, Bins2DBase::binner_axisY, and BinnerAxis::calcOffset().

BinsBase * clone ( ) const [virtual]

The clone function returns an object of its own kind which is a copy of this object at this moment.

Implements BinsBase.

Definition at line 62 of file Bins2DProfile.cxx.

References Bins2DProfile::Bins2DProfile().

NTuple * createNTuple ( ) const [virtual]

Creates an NTuple.

Derived classes will return an NTuple appropriate to their binned data. They should at least contain the coordinates, error on the coordinates, the value, and error on the value.

Implements BinsBase.

Definition at line 142 of file Bins2DProfile.cxx.

References Bins2DProfile::fillDataSource(), Bins2DBase::numberOfBins(), Bins2DBase::prepareNTuple(), num_util::size(), hippodraw::Axes::X, and hippodraw::Axes::Y.

void fillDataSource ( DataSource * ntuple ) const [virtual]

Todo:: The error on the value has needs to be tested.
The scaling needs to be tested.

Implements BinsBase.

Definition at line 159 of file Bins2DProfile.cxx.

References Bins2DBase::binWidthX(), Bins2DBase::binWidthY(), Bins2DBase::getLow(), Bins2DBase::m_data, Bins2DProfile::m_sumZ, Bins2DProfile::m_variance, Bins2DBase::numberOfBins(), num_util::shape(), hippodraw::DataPoint3DTuple::SIZE, hippodraw::DataPoint3DTuple::X, hippodraw::Axes::X, hippodraw::DataPoint3DTuple::XERR, hippodraw::DataPoint3DTuple::Y, hippodraw::Axes::Y, hippodraw::DataPoint3DTuple::YERR, hippodraw::DataPoint3DTuple::Z, and hippodraw::DataPoint3DTuple::ZERR.

Referenced by Bins2DProfile::createNTuple().

const BinnerAxis * getBinnerOn ( hippodraw::Axes::Type axis ) const [virtual, inherited]

Returns the BinnerAxis object used by this object.

Implements BinsBase.

Definition at line 84 of file Bins2DBase.cxx.

References Bins2DBase::binner_axisX, Bins2DBase::binner_axisY, hippodraw::Axes::X, and hippodraw::Axes::Y.

double getLow ( hippodraw::Axes::Type axis ) const [protected, virtual, inherited]

Returns the low value of the bins on the specified axis.

Implements BinsBase.

Definition at line 116 of file Bins2DBase.cxx.

References BinnerAxis::axisGetLow(), Bins2DBase::binner_axisX, Bins2DBase::binner_axisY, hippodraw::Axes::X, and hippodraw::Axes::Y.

Referenced by Bins2DProfile::fillDataSource(), and Bins2DHist::fillDataSource().

int getMinEntries ( ) [virtual, inherited]

Get the minimum entries/bin.

Reimplemented in Bins1DHist.

Definition at line 109 of file BinsBase.cxx.

int getNumberOfAxes ( ) const [virtual, inherited]

Returns the number of axes handled by the BinsBase derived class.

Implements BinsBase.

Definition at line 66 of file Bins2DBase.cxx.

int getNumberOfEntries ( ) const [virtual, inherited]

Returns the true number of entries.

Returns the sum of the weight parameter of the accumulate member function.

Implements BinsBase.

Definition at line 341 of file Bins2DBase.cxx.

References Bins2DBase::m_data.

Referenced by Bins2DHist::fillDataSource().

double getOffset ( hippodraw::Axes::Type axis ) const [virtual, inherited]

Returns the offset parameter on specific axis.

Implements BinsBase.

Definition at line 264 of file Bins2DBase.cxx.

References Bins2DBase::binner_axisX, Bins2DBase::binner_axisY, BinnerAxis::getOffset(), hippodraw::Axes::X, and hippodraw::Axes::Y.

int getOverflow ( ) const [virtual, inherited]

Returns the overflow.

Implements BinsBase.

Definition at line 356 of file Bins2DBase.cxx.

const Range & getRange ( hippodraw::Axes::Type axis ) [virtual, inherited]

Returns range from binner axis.

Implements BinsBase.

Definition at line 309 of file Bins2DBase.cxx.

References Bins2DBase::binner_axisX, Bins2DBase::binner_axisY, BinnerAxis::getRange(), hippodraw::Axes::X, and hippodraw::Axes::Y.

int getUnderflow ( ) const [virtual, inherited]

Returns the underflow.

Implements BinsBase.

Definition at line 351 of file Bins2DBase.cxx.

double getZValue	(	double	x,
		double	y
	)			const `[virtual]`

Get the z value at the specified point (x,y).

Reimplemented from BinsBase.

Definition at line 127 of file Bins2DProfile.cxx.

References Bins2DBase::binNumberX(), Bins2DBase::binNumberY(), Bins2DBase::m_data, and Bins2DProfile::m_sumZ.

bool hasEqualWidths ( ) const [virtual, inherited]

Returns true if all bins have the same width.

See also:: BinnerAxis::hasEqualWidths.

Implements BinsBase.

Definition at line 196 of file Bins2DBase.cxx.

References Bins2DBase::binner_axisX, Bins2DBase::binner_axisY, and BinnerAxis::hasEqualWidths().

bool isDirty ( ) [inherited]

Returns true if the re-accumulation is needed.

Definition at line 59 of file BinsBase.cxx.

References BinsBase::m_values_dirty.

bool isEmpty ( ) const [inherited]

Returns true if no accumulation has yet occurred, otherwise returns false.

Definition at line 81 of file BinsBase.cxx.

References BinsBase::m_empty.

const string & name ( ) const [inherited]

Returns the name of the Bins container object.

Definition at line 54 of file BinsBase.cxx.

References BinsBase::m_name.

Referenced by BinsBaseXML::createElement().

int numberOfBins ( ) const [inherited]

Returns the number of bins.

Definition at line 145 of file Bins2DBase.cxx.

References Bins2DBase::m_num_bins.

Referenced by Bins2DProfile::accumulate(), Bins2DHist::accumulate(), Bins2DProfile::createNTuple(), Bins2DHist::createNTuple(), Bins2DProfile::fillDataSource(), Bins2DHist::fillDataSource(), Bins2DBase::resize(), Bins2DHist::setBinContents(), Bins2DProfile::setNumberOfBins(), Bins2DHist::setNumberOfBins(), and Bins2DBase::setNumberOfBins().

int numberOfBins ( hippodraw::Axes::Type axis ) const [virtual, inherited]

Returns the number of bins on specified axis.

If a BinnerAxis object does not exist, returns 0.

Implements BinsBase.

Definition at line 152 of file Bins2DBase.cxx.

References BinnerAxis::axisNumberOfBins(), Bins2DBase::binner_axisX, Bins2DBase::binner_axisY, hippodraw::Axes::X, and hippodraw::Axes::Y.

NTuple * prepareNTuple ( unsigned int rows ) const [protected, virtual, inherited]

Prepares the NTuple.

Creates and returns the NTuple that will be filled from the binner's values. The NTuple will have rows rows and 6 columns.

Implements BinsBase.

Definition at line 364 of file Bins2DBase.cxx.

Referenced by Bins2DProfile::createNTuple(), and Bins2DHist::createNTuple().

void reset ( ) [virtual]

Resets the accumulation to zero.

Implements BinsBase.

Definition at line 97 of file Bins2DProfile.cxx.

References Bins2DBase::m_data, BinsBase::m_empty, Bins2DProfile::m_sumZ, and Bins2DProfile::m_variance.

Referenced by Bins2DProfile::setNumberOfBins().

void resize	(	int	nx,
		int	ny
	)			`[protected, virtual, inherited]`

Resizes the two dimensional arrays.

Todo:: It is possible that this method will get called before both the range and the bin width are final and therefore the number of bins could be excessive. Thus it would be better to postpone the resizing until needed.

Definition at line 330 of file Bins2DBase.cxx.

References BinsBase::m_values_dirty, Bins2DBase::setNumberOfBins(), hippodraw::Axes::X, and hippodraw::Axes::Y.

void resize ( ) [protected, inherited]

Resizes the internal arrays.

Takes the size in each dimension from the BinnerAxis objects. If either size is 0, then does nothing.

Definition at line 71 of file Bins2DBase.cxx.

References Bins2DBase::numberOfBins(), hippodraw::Axes::X, and hippodraw::Axes::Y.

Referenced by Bins2DBase::setBinnerOn(), Bins2DBase::setBinWidth(), and Bins2DBase::setRange().

double scaleFactor ( ) const [virtual, inherited]

Returns the scale factor.

Used to convert the projected value to number of entries in a bin. The default, implemented here, is to return 1.0. Derived class, such as those that do binning, may return a value to reflect their binning algorithm.

Reimplemented from BinsBase.

Definition at line 202 of file Bins2DBase.cxx.

References BinnerAxis::axisBinWidth(), Bins2DBase::binner_axisX, Bins2DBase::binner_axisY, and BinnerAxis::hasEqualWidths().

void scaleNumberOfEntries ( double number ) [virtual, inherited]

Sets a scale factor on the output so that the number of entries appears to be number.

This feature might be used, for example, to compare two histograms that have different number of entires by normalizing one to the other.

Definition at line 88 of file BinsBase.cxx.

References BinsBase::m_scale_factor.

void setBinContents ( const DataSource * ntuple ) [virtual]

Todo:: Needs implementation when static projector is implemented.

Implements BinsBase.

Definition at line 217 of file Bins2DProfile.cxx.

void setBinnerOn	(	BinnerAxis *	binner,
		hippodraw::Axes::Type	axis
	)			`[virtual, inherited]`

Sets a new BinnerAxis on the axis axis for the binner to use.

The old one, if any, will be destroyed. Raises an assertion if axis is not X or Y.

Implements BinsBase.

Definition at line 97 of file Bins2DBase.cxx.

References Bins2DBase::binner_axisX, Bins2DBase::binner_axisY, BinsBase::m_values_dirty, Bins2DBase::resize(), hippodraw::Axes::X, and hippodraw::Axes::Y.

const Range & setBinWidth	(	hippodraw::Axes::Type	axis,
		double	value
	)			`[virtual, inherited]`

Sets the bin width parameter on the specified axis.

Implements BinsBase.

Definition at line 217 of file Bins2DBase.cxx.

References Bins2DBase::binner_axisX, Bins2DBase::binner_axisY, BinsBase::m_values_dirty, Bins2DBase::resize(), BinnerAxis::setBinWidth(), hippodraw::Axes::X, and hippodraw::Axes::Y.

void setDirty ( ) [inherited]

Sets a flag to indicate that re-binning needs to be done.

Definition at line 64 of file BinsBase.cxx.

References BinsBase::m_values_dirty.

Referenced by ProfileProjector::changedNTuple(), Profile2DProjector::changedNTuple(), DyHist2DProjector::changedNTuple(), and DyHist1DProjector::changedNTuple().

void setEntriesScaling ( bool on ) [virtual, inherited]

Sets the scaling number of entries on if on is true, otherwise turns if off.

Definition at line 95 of file BinsBase.cxx.

References BinsBase::m_is_scaling.

void setMinEntries ( int entries ) [virtual, inherited]

Set the minimum entries/bin.

Reimplemented in Bins1DHist.

Definition at line 103 of file BinsBase.cxx.

void setNumberOfBins	(	hippodraw::Axes::Type	axis,
		int	number
	)			`[virtual]`

Sets the number of bins on the the specified axis.

Reimplemented from Bins2DBase.

Definition at line 69 of file Bins2DProfile.cxx.

References Bins2DBase::m_data, Bins2DBase::m_num_bins, Bins2DProfile::m_sumZ, Bins2DProfile::m_variance, Bins2DBase::numberOfBins(), Bins2DProfile::reset(), Bins2DBase::setNumberOfBins(), hippodraw::Axes::X, and hippodraw::Axes::Y.

void setOffset	(	hippodraw::Axes::Type	axis,
		double	value
	)			`[virtual, inherited]`

Sets the offset parameter on the specified axis.

Implements BinsBase.

Definition at line 275 of file Bins2DBase.cxx.

References Bins2DBase::binner_axisX, Bins2DBase::binner_axisY, BinsBase::m_values_dirty, BinnerAxis::setOffset(), hippodraw::Axes::X, and hippodraw::Axes::Y.

const Range & setRange	(	hippodraw::Axes::Type	axis,
		const Range &	,
		bool	hold_width = `true`
	)			`[virtual, inherited]`

Sets the Range on the specified axis.

If hold_width is true, the bin width parameter will be held constant, otherwise it is adjusted to keep the same number of bins for the new range.

Implements BinsBase.

Definition at line 290 of file Bins2DBase.cxx.

References Bins2DBase::binner_axisX, Bins2DBase::binner_axisY, Bins2DBase::resize(), BinnerAxis::setRange(), hippodraw::Axes::X, and hippodraw::Axes::Y.

std::vector<std::vector<double> > m_data [protected, inherited]

The accumulated sum of weights.

If all calls to accumulate have weight of 1.0, the default, then will be number of entries. For each vector, index 0 is the underflow, while the last element is the overflow.

Definition at line 48 of file Bins2DBase.h.

Referenced by Bins2DProfile::accumulate(), Bins2DHist::accumulate(), Bins2DProfile::fillDataSource(), Bins2DHist::fillDataSource(), Bins2DBase::getNumberOfEntries(), Bins2DProfile::getZValue(), Bins2DHist::getZValue(), Bins2DProfile::reset(), Bins2DHist::reset(), Bins2DHist::setBinContents(), Bins2DProfile::setNumberOfBins(), and Bins2DHist::setNumberOfBins().

bool m_empty [protected, inherited]

A flag set to true, when no accumulation has yet occurred, otherwise is set false.

Definition at line 58 of file BinsBase.h.

Referenced by Bins2DProfile::accumulate(), Bins2DHist::accumulate(), Bins1DProfile::accumulate(), Bins1DHist::accumulate(), BinsBase::isEmpty(), Bins2DProfile::reset(), Bins2DHist::reset(), Bins1DProfile::reset(), and Bins1DHist::reset().

bool m_is_scaling [protected, inherited]

A flag which is set true to enable scaling the output.

Definition at line 50 of file BinsBase.h.

Referenced by Bins2DHist::fillDataSource(), Bins1DHist::fillDataSource(), and BinsBase::setEntriesScaling().

int m_num_bins [protected, inherited]

Total number of bins not including overflow and underflow.

Todo:: Do we need this?.

Definition at line 57 of file Bins2DBase.h.

Referenced by Bins2DHist::Bins2DHist(), Bins2DProfile::Bins2DProfile(), Bins2DBase::numberOfBins(), Bins2DProfile::setNumberOfBins(), and Bins2DBase::setNumberOfBins().

double m_scale_factor [protected, inherited]

The scale factor.

This data member is used to scale the output so that the total number of entries has this value.

Definition at line 46 of file BinsBase.h.

Referenced by Bins2DHist::fillDataSource(), Bins1DHist::fillDataSource(), and BinsBase::scaleNumberOfEntries().

std::vector<std::vector<double> > m_sumZ [protected]

The accumulated sum of the z variable in each bin.

The matrix structure is identical to m_data.

Definition at line 37 of file Bins2DProfile.h.

Referenced by Bins2DProfile::accumulate(), Bins2DProfile::fillDataSource(), Bins2DProfile::getZValue(), Bins2DProfile::reset(), and Bins2DProfile::setNumberOfBins().

bool m_values_dirty [mutable, protected, inherited]

A flag to indicate that the objects in m_values are not correct.

Definition at line 53 of file BinsBase.h.

Referenced by Bins1DBase::Bins1DBase(), Bins2DBase::Bins2DBase(), BinsBase::isDirty(), Bins1DHist::reset(), Bins2DBase::resize(), Bins1DProfile::resize(), Bins1DHist::resize(), Bins2DBase::setBinnerOn(), Bins1DBase::setBinnerOn(), Bins2DBase::setBinWidth(), BinsBase::setDirty(), and Bins2DBase::setOffset().

std::vector<std::vector<double> > m_variance [protected]

The accumulated square of the weights.

Use [X][Y].

Definition at line 40 of file Bins2DProfile.h.

Referenced by Bins2DProfile::accumulate(), Bins2DProfile::fillDataSource(), Bins2DProfile::reset(), and Bins2DProfile::setNumberOfBins().

Range m_z_range [protected]

The range of the z axis.

Note that the z axis does not need a binner axis object because it is not binned.

Definition at line 44 of file Bins2DProfile.h.

Bins2DProfile Class Reference

Detailed Description

Public Member Functions

Protected Member Functions

Protected Attributes

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation


Public Member Functions
virtual void	accumulate (double x, double y, double z, double w=1.0)
	Accumulates the data point (x,y, z) with weight w.
	Bins2DProfile (const Bins2DProfile &binner)
	The copy constructor.
	Bins2DProfile ()
	The default constructor.
virtual double	binWidth (hippodraw::Axes::Type axis) const
	Returns the bin width parameter on the specified axis.
double	binWidthX (int i) const
	Gets the bin width of the X bin for the i bin.
double	binWidthY (int i) const
	Gets the bin width of the Y bin for the i bin.
double	calcBinWidth (hippodraw::Axes::Type axis, int parm, bool dragging) const
	Calculates the bin width parameter from dragging slider.
virtual double	calcOffset (const std::string &, int parm, bool dragging) const
	Calculates and returns a new range from dragging slider.
BinsBase *	clone () const
	The clone function returns an object of its own kind which is a copy of this object at this moment.
virtual NTuple *	createNTuple () const
	Creates an NTuple.
virtual void	fillDataSource (DataSource *ntuple) const
virtual const BinnerAxis *	getBinnerOn (hippodraw::Axes::Type axis) const
	Returns the BinnerAxis object used by this object.
virtual int	getMinEntries ()
	Get the minimum entries/bin.
virtual int	getNumberOfAxes () const
	Returns the number of axes handled by the BinsBase derived class.
virtual int	getNumberOfEntries () const
	Returns the true number of entries.
virtual double	getOffset (hippodraw::Axes::Type axis) const
	Returns the offset parameter on specific axis.
virtual int	getOverflow () const
	Returns the overflow.
virtual const Range &	getRange (hippodraw::Axes::Type axis)
	Returns range from binner axis.
virtual int	getUnderflow () const
	Returns the underflow.
virtual double	getZValue (double x, double y) const
	Get the z value at the specified point (x,y).
virtual bool	hasEqualWidths () const
	Returns `true` if all bins have the same width.
bool	isDirty ()
	Returns `true` if the re-accumulation is needed.
bool	isEmpty () const
	Returns `true` if no accumulation has yet occurred, otherwise returns `false`.
const std::string &	name () const
	Returns the name of the Bins container object.
int	numberOfBins () const
	Returns the number of bins.
virtual int	numberOfBins (hippodraw::Axes::Type axis) const
	Returns the number of bins on specified axis.
virtual void	reset ()
	Resets the accumulation to zero.
virtual double	scaleFactor () const
	Returns the scale factor.
virtual void	scaleNumberOfEntries (double number)
	Sets a scale factor on the output so that the number of entries appears to be number.
virtual void	setBinContents (const DataSource *ntuple)
void	setBinnerOn (BinnerAxis *, hippodraw::Axes::Type axis)
	Sets a new BinnerAxis on the axis axis for the binner to use.
virtual const Range &	setBinWidth (hippodraw::Axes::Type axis, double value)
	Sets the bin width parameter on the specified axis.
void	setDirty ()
	Sets a flag to indicate that re-binning needs to be done.
virtual void	setEntriesScaling (bool on)
	Sets the scaling number of entries on if on is `true`, otherwise turns if off.
virtual void	setMinEntries (int entries)
	Set the minimum entries/bin.
virtual void	setNumberOfBins (hippodraw::Axes::Type axis, int nb)
	Sets the number of bins on the the specified axis.
virtual void	setOffset (hippodraw::Axes::Type axis, double value)
	Sets the offset parameter on the specified axis.
virtual const Range &	setRange (hippodraw::Axes::Type axis, const Range &, bool hold_width=true)
	Sets the Range on the specified axis.
virtual	~Bins2DProfile ()
	The destructor.
Protected Member Functions
int	binNumberX (double x) const
	Returns the number of the bin in which the x value is situated.
int	binNumberY (double y) const
	Returns the number of the bin in which the y value is situated.
virtual double	getLow (hippodraw::Axes::Type axis) const
	Returns the low value of the bins on the specified axis.
virtual NTuple *	prepareNTuple (unsigned int rows) const
	Prepares the NTuple.
virtual void	resize (int nx, int ny)
	Resizes the two dimensional arrays.
void	resize ()
	Resizes the internal arrays.
Protected Attributes
std::vector < std::vector < double > >	m_data
	The accumulated sum of weights.
bool	m_empty
	A flag set to `true`, when no accumulation has yet occurred, otherwise is set `false`.
bool	m_is_scaling
	A flag which is set `true` to enable scaling the output.
int	m_num_bins
	Total number of bins not including overflow and underflow.
double	m_scale_factor
	The scale factor.
std::vector < std::vector < double > >	m_sumZ
	The accumulated sum of the z variable in each bin.
bool	m_values_dirty
	A flag to indicate that the objects in m_values are not correct.
std::vector < std::vector < double > >	m_variance
	The accumulated square of the weights.
Range	m_z_range
	The range of the z axis.