TestAnalysis Class Reference

#include <TestAnalysis.hh>

Inheritance diagram for TestAnalysis:

[legend]Collaboration diagram for TestAnalysis:

[legend]List of all members.

Detailed Description

This class just measures the charged multiplicity.

Definition at line 14 of file TestAnalysis.hh.


Public Member Functions
	TestAnalysis ()
	Default constructor.
string	getName () const
	Get the name of this analysis.
void	init ()
void	analyze (const Event &event)
void	finalize ()
virtual const Cuts	getCuts () const
virtual const BeamPair &	getBeams () const
	Return the pair of incoming beams required by this analysis.
virtual const bool	isCompatible (const string &quantity, const double value) const
	Is this analysis compatible with the named quantity set at the supplied value?
virtual const bool	isCompatible (const ParticleName &beam1, const ParticleName &beam2) const
	Is this analysis able to run on the supplied pair of beams?
virtual const bool	isCompatible (const BeamPair &beams) const
	Is this analysis able to run on the BeamPair beams ?
AnalysisHandler &	getHandler () const
	Access the controlling AnalysisHandler object.
Static Public Member Functions
Analysis *	create ()
	Factory method.
Protected Member Functions
Log &	getLog ()
	Get a Log object based on the getName() property of the calling analysis object.
virtual const bool	checkConsistency () const
	Is this analysis able to run on the BeamPair beams ?
set< Projection * >	getProjections () const
Analysis &	setBeams (const ParticleName &beam1, const ParticleName &beam2)
	Set the colliding beam pair.
Analysis &	addCut (const string &quantity, const Comparison &comparison, const double value)
	Add a cut.
Analysis &	addProjection (Projection &proj)
	Add a projection dependency to the projection list.
AIDA analysis infrastructure.
AIDA::IAnalysisFactory &	analysisFactory ()
	Access the AIDA analysis factory of the controlling AnalysisHandler object.
AIDA::ITree &	tree ()
	Access the AIDA tree of the controlling AnalysisHandler object.
AIDA::IHistogramFactory &	histogramFactory ()
	Access the AIDA histogram factory of the controlling AnalysisHandler object.
AIDA::IDataPointSetFactory &	datapointsetFactory ()
	Access the AIDA histogram factory of the controlling AnalysisHandler object.
const string	getHistoDir () const
	Get the canonical AIDA histogram path for this analysis.
Internal histogram and data point set booking (for use by Analysis sub-classes).
AIDA::IHistogram1D *	bookHistogram1D (const string &name, const string &title, const size_t nbins, const double lower, const double upper)
AIDA::IHistogram1D *	bookHistogram1D (const string &name, const string &title, const vector< double > &binedges)
AIDA::IHistogram1D *	bookHistogram1D (const size_t datasetId, const size_t xAxisId, const size_t yAxisId, const string &title)
AIDA::IDataPointSet *	bookDataPointSet (const string &name, const string &title)
AIDA::IDataPointSet *	bookDataPointSet (const string &name, const string &title, const size_t npts, const double lower, const double upper)
AIDA::IDataPointSet *	bookDataPointSet (const size_t datasetId, const size_t xAxisId, const size_t yAxisId, const string &title)
AIDA analysis infrastructure.
AIDA::IAnalysisFactory &	analysisFactory ()
	Access the AIDA analysis factory of the controlling AnalysisHandler object.
AIDA::ITree &	tree ()
	Access the AIDA tree of the controlling AnalysisHandler object.
AIDA::IHistogramFactory &	histogramFactory ()
	Access the AIDA histogram factory of the controlling AnalysisHandler object.
AIDA::IDataPointSetFactory &	datapointsetFactory ()
	Access the AIDA histogram factory of the controlling AnalysisHandler object.
const string	getHistoDir () const
	Get the canonical AIDA histogram path for this analysis.
Internal histogram and data point set booking (for use by Analysis sub-classes).
AIDA::IHistogram1D *	bookHistogram1D (const string &name, const string &title, const size_t nbins, const double lower, const double upper)
AIDA::IHistogram1D *	bookHistogram1D (const string &name, const string &title, const vector< double > &binedges)
AIDA::IHistogram1D *	bookHistogram1D (const size_t datasetId, const size_t xAxisId, const size_t yAxisId, const string &title)
AIDA::IDataPointSet *	bookDataPointSet (const string &name, const string &title)
AIDA::IDataPointSet *	bookDataPointSet (const string &name, const string &title, const size_t npts, const double lower, const double upper)
AIDA::IDataPointSet *	bookDataPointSet (const size_t datasetId, const size_t xAxisId, const size_t yAxisId, const string &title)
Protected Attributes
set< Projection * >	_projections
	Collection of pointers to projections, for automatically combining constraints.

Constructor & Destructor Documentation

TestAnalysis ( ) [inline]

Default constructor.

Definition at line 19 of file TestAnalysis.hh.

Member Function Documentation

Analysis& addCut	(	const string &	quantity,
		const Comparison &	comparison,
		const double	value
	)	`[inline, protected, inherited]`

Add a cut.

Definition at line 230 of file Analysis.hh.

Analysis& addProjection ( Projection & proj ) [inline, protected, inherited]

Add a projection dependency to the projection list.

Definition at line 236 of file Analysis.hh.

IAnalysisFactory & analysisFactory ( ) [protected, inherited]

Access the AIDA analysis factory of the controlling AnalysisHandler object.

Definition at line 13 of file Analysis.cc.

References AnalysisHandler::analysisFactory(), and Analysis::getHandler().

void analyze ( const Event & event ) [virtual]

Analyze one event. A concrete class should here apply the necessary projections on the event and fill the relevant histograms. An overridden function must make sure it first calls the base class function.

Implements Analysis.

Definition at line 26 of file TestAnalysis.cc.

References Event::applyProjection(), IHistogram1D::fill(), Analysis::getLog(), Multiplicity::hadronChargedMultiplicity(), Multiplicity::hadronMultiplicity(), Multiplicity::hadronUnchargedMultiplicity(), Thrust::thrust(), Multiplicity::totalChargedMultiplicity(), Multiplicity::totalMultiplicity(), Multiplicity::totalUnchargedMultiplicity(), and Event::weight().

IDataPointSet * bookDataPointSet	(	const size_t	datasetId,
		const size_t	xAxisId,
		const size_t	yAxisId,
		const string &	title
	)	`[protected, inherited]`

Book a 2-dimensional data point set based on the paper, dataset and x/y-axis IDs in the corresponding HepData record. The binnings (x-errors) will be obtained by reading the bundled AIDA data record file of the same filename as the analysis' getName() property.

Todo:: Implement this?

Definition at line 89 of file Analysis.cc.

IDataPointSet * bookDataPointSet	(	const string &	name,
		const string &	title,
		const size_t	npts,
		const double	lower,
		const double	upper
	)	`[protected, inherited]`

Book a 2-dimensional data point set with equally spaced points in a range. (NB. this returns a pointer rather than a reference since it will have to be stored in the analysis class - there's no point in forcing users to explicitly get the pointer from a reference before they can use it!)

Definition at line 73 of file Analysis.cc.

References Analysis::bookDataPointSet().

IDataPointSet * bookDataPointSet	(	const string &	name,
		const string &	title
	)	`[protected, inherited]`

Book a 2-dimensional data point set. (NB. this returns a pointer rather than a reference since it will have to be stored in the analysis class - there's no point in forcing users to explicitly get the pointer from a reference before they can use it!)

Definition at line 66 of file Analysis.cc.

References Analysis::datapointsetFactory(), and Analysis::getHistoDir().

Referenced by Analysis::bookDataPointSet(), and PRD65092002::init().

IHistogram1D * bookHistogram1D	(	const size_t	datasetId,
		const size_t	xAxisId,
		const size_t	yAxisId,
		const string &	title
	)	`[protected, inherited]`

Book a 1D histogram based on the paper, dataset and x/y-axis IDs in the corresponding HepData record. The binnings will be obtained by reading the bundled AIDA data record file of the same filename as the analysis' getName() property.

Definition at line 39 of file Analysis.cc.

References IHistogramFactory::createHistogram1D(), Rivet::getBinEdges(), Analysis::getHistoDir(), Analysis::getName(), and Analysis::histogramFactory().

IHistogram1D * bookHistogram1D	(	const string &	name,
		const string &	title,
		const vector< double > &	binedges
	)	`[protected, inherited]`

Book a 1D histogram with non-uniform bins defined by the vector of bin edges binedges . (NB. this returns a pointer rather than a reference since it will have to be stored in the analysis class - there's no point in forcing users to explicitly get the pointer from a reference before they can use it!)

Definition at line 58 of file Analysis.cc.

References IHistogramFactory::createHistogram1D(), Analysis::getHistoDir(), and Analysis::histogramFactory().

IHistogram1D * bookHistogram1D	(	const string &	name,
		const string &	title,
		const size_t	nbins,
		const double	lower,
		const double	upper
	)	`[protected, inherited]`

Book a 1D histogram with nbins uniformly distributed across the range lower - upper . (NB. this returns a pointer rather than a reference since it will have to be stored in the analysis class - there's no point in forcing users to explicitly get the pointer from a reference before they can use it!)

Definition at line 50 of file Analysis.cc.

References IHistogramFactory::createHistogram1D(), Analysis::getHistoDir(), and Analysis::histogramFactory().

Referenced by ZPhys73C11::init(), TestAnalysis::init(), HepEx9506012::init(), HepEx0409040::init(), HepEx0112029::init(), and PL273B181::init().

const bool checkConsistency ( ) const [protected, virtual, inherited]

Is this analysis able to run on the BeamPair beams ?

Definition at line 113 of file Analysis.cc.

References Analysis::_projections, Cuts::checkConsistency(), Rivet::compatible(), Cuts::end(), Analysis::getBeams(), Analysis::getCuts(), and Analysis::getName().

Analysis* create ( ) [inline, static]

Factory method.

Definition at line 28 of file TestAnalysis.hh.

IDataPointSetFactory & datapointsetFactory ( ) [protected, inherited]

Access the AIDA histogram factory of the controlling AnalysisHandler object.

Definition at line 28 of file Analysis.cc.

References AnalysisHandler::datapointsetFactory(), and Analysis::getHandler().

Referenced by Analysis::bookDataPointSet().

void finalize ( ) [virtual]

Finalize this analysis object. A concrete class should here make all necessary operations on the histograms. Writing the histograms to a file is, however, done by the Rivet class. An overridden function must make sure it first calls the base class function.

Implements Analysis.

Definition at line 59 of file TestAnalysis.cc.

References Rivet::normalize().

virtual const BeamPair& getBeams ( ) const [inline, virtual, inherited]

Return the pair of incoming beams required by this analysis.

Definition at line 95 of file Analysis.hh.

References Rivet::BeamPair.

Referenced by Analysis::checkConsistency(), and main().

const Cuts getCuts ( ) const [virtual, inherited]

Return the Cuts object of this analysis object. Derived classes should re-implement this function to return the combined RivetInfo object of this object and of any Projection objects upon which this depends.

Definition at line 104 of file Analysis.cc.

References Analysis::_projections, and Cuts::addCuts().

Referenced by Analysis::checkConsistency(), and main().

AnalysisHandler& getHandler ( ) const [inline, inherited]

Access the controlling AnalysisHandler object.

Definition at line 124 of file Analysis.hh.

Referenced by Analysis::analysisFactory(), Analysis::datapointsetFactory(), Analysis::histogramFactory(), and Analysis::tree().

const string getHistoDir ( ) const [inline, protected, inherited]

Get the canonical AIDA histogram path for this analysis.

Definition at line 161 of file Analysis.hh.

Referenced by Analysis::bookDataPointSet(), and Analysis::bookHistogram1D().

Log & getLog ( ) [protected, inherited]

Get a Log object based on the getName() property of the calling analysis object.

Definition at line 33 of file Analysis.cc.

References Analysis::getName().

Referenced by ZPhys73C11::analyze(), TestAnalysis::analyze(), PRD65092002::analyze(), HepEx0409040::analyze(), HepEx0112029::analyze(), ExampleTree::analyze(), PL273B181::analyze(), HepEx0409040::finalize(), and ExampleTree::init().

string getName ( ) const [inline, virtual]

Get the name of this analysis.

Reimplemented from Analysis.

Definition at line 33 of file TestAnalysis.hh.

set< Projection * > getProjections ( ) const [protected, inherited]

Get all the projections used by this analysis, including recursion. WARNING: No caching or loop-avoidance is implemented at the moment.

Definition at line 127 of file Analysis.cc.

References Analysis::_projections, and Cuts::end().

IHistogramFactory & histogramFactory ( ) [protected, inherited]

Access the AIDA histogram factory of the controlling AnalysisHandler object.

Definition at line 23 of file Analysis.cc.

References Analysis::getHandler(), and AnalysisHandler::histogramFactory().

Referenced by Analysis::bookHistogram1D(), and HepEx9506012::finalize().

void init ( ) [virtual]

Initialize this analysis object. A concrete class should here book all necessary histograms. An overridden function must make sure it first calls the base class function.

Implements Analysis.

Definition at line 10 of file TestAnalysis.cc.

References Analysis::bookHistogram1D().

virtual const bool isCompatible ( const BeamPair & beams ) const [inline, virtual, inherited]

Is this analysis able to run on the BeamPair beams ?

Todo:: Need to also check internal consistency of the analysis' beam requirements with those of the projections it uses.

Definition at line 117 of file Analysis.hh.

References Rivet::BeamPair, and Rivet::compatible().

virtual const bool isCompatible	(	const ParticleName &	beam1,
		const ParticleName &	beam2
	)	const `[inline, virtual, inherited]`

Is this analysis able to run on the supplied pair of beams?

Todo:: Need to also check internal consistency of the analysis' beam requirements with those of the projections it uses.

Definition at line 109 of file Analysis.hh.

References Rivet::BeamPair, and Rivet::compatible().

virtual const bool isCompatible	(	const string &	quantity,
		const double	value
	)	const `[inline, virtual, inherited]`

Is this analysis compatible with the named quantity set at the supplied value?

Definition at line 100 of file Analysis.hh.

Referenced by main().

Analysis& setBeams	(	const ParticleName &	beam1,
		const ParticleName &	beam2
	)	`[inline, protected, inherited]`

Set the colliding beam pair.

Definition at line 223 of file Analysis.hh.

ITree & tree ( ) [protected, inherited]

Access the AIDA tree of the controlling AnalysisHandler object.

Definition at line 18 of file Analysis.cc.

References Analysis::getHandler(), and AnalysisHandler::tree().

Member Data Documentation

set<Projection*> _projections [protected, inherited]

Collection of pointers to projections, for automatically combining constraints.

Definition at line 242 of file Analysis.hh.

Referenced by Analysis::checkConsistency(), Analysis::getCuts(), and Analysis::getProjections().

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

TestAnalysis Class Reference

Detailed Description

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation