GaudiHistos< PBASE > Class Template Reference

#include <GaudiAlg/GaudiHistos.h>

Collaboration diagram for GaudiHistos< PBASE >:

[legend]

List of all members.

---

Detailed Description

template<class PBASE>
class GaudiHistos< PBASE >

Templated base class providing common histogramming methods for GaudiAlgorithm and GaudiTool like classes.

Author:

Chris Jones Christopher.Rob.Jones@cern.ch

Vanya BELYAEV Ivan.Belyaev@itep.ru

Date:

2005-08-08

Definition at line 51 of file GaudiHistos.h.

Public Types
typedef GaudiAlg::HistoID	HistoID
	the actual type for histogram identifier
typedef GaudiAlg::Histo1DMapNumericID	Histo1DMapNumID
	the actual type for (Numeric ID)->(1D histogram) mapping
typedef GaudiAlg::Histo1DMapLiteralID	Histo1DMapLitID
	the actual type for (Literal ID)->(1D histogram) mapping
typedef GaudiAlg::Histo1DMapTitle	Histo1DMapTitle
	the actual type for title->(1D histogram) mapping
typedef GaudiAlg::Histo2DMapNumericID	Histo2DMapNumID
	the actual type for (Numeric ID)->(2D histogram) mapping
typedef GaudiAlg::Histo2DMapLiteralID	Histo2DMapLitID
	the actual type for (Literal ID)->(2D histogram) mapping
typedef GaudiAlg::Histo2DMapTitle	Histo2DMapTitle
	the actual type for title->(2D histogram) mapping
typedef GaudiAlg::Histo3DMapNumericID	Histo3DMapNumID
	the actual type for (Numeric ID)->(3D histogram) mapping
typedef GaudiAlg::Histo3DMapLiteralID	Histo3DMapLitID
	the actual type for (Literal ID)->(3D histogram) mapping
typedef GaudiAlg::Histo3DMapTitle	Histo3DMapTitle
	the actual type for title->(3D histogram) mapping
typedef GaudiAlg::Profile1DMapNumericID	Profile1DMapNumID
	the actual type for (Numeric ID)->(1D profile histogram) mapping
typedef GaudiAlg::Profile1DMapLiteralID	Profile1DMapLitID
	the actual type for (Literal ID)->(1D profile histogram) mapping
typedef GaudiAlg::Profile1DMapTitle	Profile1DMapTitle
	the actual type for title->(1D profile histogram) mapping
typedef GaudiAlg::Profile2DMapNumericID	Profile2DMapNumID
	the actual type for (Numeric ID)->(2D profile histogram) mapping
typedef GaudiAlg::Profile2DMapLiteralID	Profile2DMapLitID
	the actual type for (Literal ID)->(2D profile histogram) mapping
typedef GaudiAlg::Profile2DMapTitle	Profile2DMapTitle
	the actual type for title->(2D profile histogram) mapping
typedef GaudiAlg::HistoBinEdges	HistoBinEdges
	Edges for variable binning.
Public Member Functions
AIDA::IHistogram1D *	plot1D (const double value, const std::string &title, const double low, const double high, const unsigned long bins=100, const double weight=1.0) const
	fill the 1D histogram (book on demand)
AIDA::IHistogram1D *	plot (const double value, const std::string &title, const double low, const double high, const unsigned long bins=100, const double weight=1.0) const
	fill the 1D histogram (book on demand)
AIDA::IHistogram1D *	plot1D (const double value, const Gaudi::Histo1DDef &hdef, const double weight=1.0) const
	fill the 1D histogram (book on demand)
AIDA::IHistogram1D *	plot (const double value, const Gaudi::Histo1DDef &hdef, const double weight=1.0) const
	fill the 1D histogram (book on demand)
AIDA::IHistogram1D *	plot1D (const double value, const HistoID &ID, const std::string &title, const double low, const double high, const unsigned long bins=100, const double weight=1.0) const
	fill the 1D histogram with forced ID assignment (book on demand)
AIDA::IHistogram1D *	plot (const double value, const HistoID &ID, const std::string &title, const double low, const double high, const unsigned long bins=100, const double weight=1.0) const
	fill the 1D histogram with forced ID assignment (book on demand)
AIDA::IHistogram1D *	plot1D (const double value, const HistoID &ID, const Gaudi::Histo1DDef &hdef, const double weight=1.0) const
	fill the 1D histogram with forced ID assignment (book on demand)
AIDA::IHistogram1D *	plot (const double value, const HistoID &ID, const Gaudi::Histo1DDef &hdef, const double weight=1.0) const
	fill the 1D histogram (book on demand)
template<class FUNCTION, class OBJECT>
AIDA::IHistogram1D *	plot (const FUNCTION &func, OBJECT first, OBJECT last, const std::string &title, const double low, const double high, const unsigned long bins=100) const
	fill the 1D histogram with information from [first,last) sequence
template<class FUNCTION, class OBJECT>
AIDA::IHistogram1D *	plot (const FUNCTION &func, OBJECT first, OBJECT last, const HistoID &ID, const std::string &title, const double low, const double high, const unsigned long bins=100) const
	fill the 1D histogram with forced ID and information from [first,last) sequence
template<class FUNCTION, class OBJECT, class WEIGHT>
AIDA::IHistogram1D *	plot (const FUNCTION &func, OBJECT first, OBJECT last, const std::string &title, const double low, const double high, const unsigned long bins, const WEIGHT &weight) const
	book and fill the 1D histogram with information from [first,last) sequence with given weight
template<class FUNCTION, class OBJECT, class WEIGHT>
AIDA::IHistogram1D *	plot (const FUNCTION &func, OBJECT first, OBJECT last, const HistoID &ID, const std::string &title, const double low, const double high, const unsigned long bins, const WEIGHT &weight) const
	book and fill the 1D histogram with forced ID and information from [first,last) sequence with given weight
AIDA::IHistogram1D *	plot1D (const double value, const std::string &title, const HistoBinEdges &edges, const double weight=1.0) const
	Fill the 1D variable binning histogram (book on demand).
AIDA::IHistogram1D *	plot1D (const double value, const HistoID &ID, const std::string &title, const HistoBinEdges &edges, const double weight=1.0) const
	fill the 1D variable binning histogram with forced ID assignment (book on demand)
AIDA::IHistogram2D *	plot2D (const double valueX, const double valueY, const std::string &title, const double lowX, const double highX, const double lowY, const double highY, const unsigned long binsX=50, const unsigned long binsY=50, const double weight=1.0) const
	fill the 2D histogram (book on demand)
AIDA::IHistogram2D *	plot2D (const double valueX, const double valueY, const HistoID &ID, const std::string &title, const double lowX, const double highX, const double lowY, const double highY, const unsigned long binsX=50, const unsigned long binsY=50, const double weight=1.0) const
	fill the 2D histogram with forced ID assignment (book on demand)
AIDA::IHistogram2D *	plot2D (const double valueX, const double valueY, const std::string &title, const HistoBinEdges &edgesX, const HistoBinEdges &edgesY, const double weight=1.0) const
	Fill the 2D variable binning histogram (book on demand).
AIDA::IHistogram2D *	plot2D (const double valueX, const double valueY, const HistoID &ID, const std::string &title, const HistoBinEdges &edgesX, const HistoBinEdges &edgesY, const double weight=1.0) const
	fill the 2D variable histogram with forced ID assignment (book on demand)
AIDA::IHistogram3D *	plot3D (const double valueX, const double valueY, const double valueZ, const std::string &title, const double lowX, const double highX, const double lowY, const double highY, const double lowZ, const double highZ, const unsigned long binsX=10, const unsigned long binsY=10, const unsigned long binsZ=10, const double weight=1.0) const
	fill the 3D histogram (book on demand)
AIDA::IHistogram3D *	plot3D (const double valueX, const double valueY, const double valueZ, const HistoID &ID, const std::string &title, const double lowX, const double highX, const double lowY, const double highY, const double lowZ, const double highZ, const unsigned long binsX=10, const unsigned long binsY=10, const unsigned long binsZ=10, const double weight=1.0) const
	fill the 3D histogram with forced ID assignment (book on demand)
AIDA::IHistogram3D *	plot3D (const double valueX, const double valueY, const double valueZ, const std::string &title, const HistoBinEdges &edgesX, const HistoBinEdges &edgesY, const HistoBinEdges &edgesZ, const double weight=1.0) const
	Fill the 3D variable binning histogram (book on demand).
AIDA::IHistogram3D *	plot3D (const double valueX, const double valueY, const double valueZ, const HistoID &ID, const std::string &title, const HistoBinEdges &edgesX, const HistoBinEdges &edgesY, const HistoBinEdges &edgesZ, const double weight=1.0) const
	fill the 3D histogram with forced ID assignment (book on demand)
AIDA::IProfile1D *	profile1D (const double valueX, const double valueY, const std::string &title, const double lowX, const double highX, const unsigned long binsX=100, const std::string &opt="", const double lowY=-std::numeric_limits< double >::max(), const double highY=std::numeric_limits< double >::max(), const double weight=1.0) const
	fill the 1D profile histogram (book on demand)
AIDA::IProfile1D *	profile1D (const double valueX, const double valueY, const HistoID &ID, const std::string &title, const double lowX, const double highX, const unsigned long binsX=100, const std::string &opt="", const double lowY=-std::numeric_limits< double >::max(), const double highY=std::numeric_limits< double >::max(), const double weight=1.0) const
	fill the 1D profile histogram with forced ID assignment (book on demand)
AIDA::IProfile1D *	profile1D (const double valueX, const double valueY, const std::string &title, const HistoBinEdges &edges, const double weight=1.0) const
	fill the 1D variable binning profile histogram (book on demand)
AIDA::IProfile1D *	profile1D (const double valueX, const double valueY, const HistoID &ID, const std::string &title, const HistoBinEdges &edges, const double weight=1.0) const
	fill the 1D variable binning profile histogram with forced ID assignment (book on demand)
AIDA::IProfile2D *	profile2D (const double valueX, const double valueY, const double valueZ, const std::string &title, const double lowX, const double highX, const double lowY, const double highY, const unsigned long binsX=50, const unsigned long binsY=50, const double weight=1.0) const
	fill the 2D profile histogram (book on demand)
AIDA::IProfile2D *	profile2D (const double valueX, const double valueY, const double valueZ, const HistoID &ID, const std::string &title, const double lowX, const double highX, const double lowY, const double highY, const unsigned long binsX=50, const unsigned long binsY=50, const double weight=1.0) const
	fill the 2D profile histogram with forced ID assignment (book on demand)
AIDA::IProfile2D *	profile2D (const double valueX, const double valueY, const double valueZ, const std::string &title, const HistoBinEdges &edgesX, const HistoBinEdges &edgesY, const double weight=1.0) const
	fill the 2D variable binning profile histogram (book on demand)
AIDA::IProfile2D *	profile2D (const double valueX, const double valueY, const double valueZ, const HistoID &ID, const std::string &title, const HistoBinEdges &edgesX, const HistoBinEdges &edgesY, const double weight=1.0) const
	fill the 2D variable binning profile histogram with forced ID assignment (book on demand)
AIDA::IHistogram1D *	book1D (const std::string &title, const double low=0, const double high=100, const unsigned long bins=100) const
	book the 1D histogram
AIDA::IHistogram1D *	book (const std::string &title, const double low=0, const double high=100, const unsigned long bins=100) const
	book the 1D histogram
AIDA::IHistogram1D *	book (const Gaudi::Histo1DDef &hdef) const
	book the 1D histogram
AIDA::IHistogram1D *	book1D (const HistoID &ID, const std::string &title, const double low=0, const double high=100, const unsigned long bins=100) const
	book the 1D histogram with forced ID
AIDA::IHistogram1D *	book (const HistoID &ID, const std::string &title, const double low=0, const double high=100, const unsigned long bins=100) const
	book the 1D histogram with forced ID
AIDA::IHistogram1D *	book (const HistoID &ID, const Gaudi::Histo1DDef &hdef) const
	book the 1D histogram with forced ID
AIDA::IHistogram1D *	book1D (const std::string &title, const HistoBinEdges &edges) const
	book the 1D variable binning histogram
AIDA::IHistogram1D *	book1D (const HistoID &ID, const std::string &title, const HistoBinEdges &edges) const
	book the 1D variable binning histogram with given ID
AIDA::IHistogram2D *	book2D (const std::string &title, const double lowX=0, const double highX=100, const unsigned long binsX=50, const double lowY=0, const double highY=100, const unsigned long binsY=50) const
	book the 2D histogram
AIDA::IHistogram2D *	book2D (const HistoID &ID, const std::string &title, const double lowX=0, const double highX=100, const unsigned long binsX=50, const double lowY=0, const double highY=100, const unsigned long binsY=50) const
	book the 2D histogram with forced ID
AIDA::IHistogram2D *	book2D (const std::string &title, const HistoBinEdges &edgesX, const HistoBinEdges &edgesY) const
	book the 2D variable binning histogram
AIDA::IHistogram2D *	book2D (const HistoID &ID, const std::string &title, const HistoBinEdges &edgesX, const HistoBinEdges &edgesY) const
	book the 2D variable binning histogram with given ID
AIDA::IHistogram3D *	book3D (const std::string &title, const double lowX=0, const double highX=100, const unsigned long binsX=10, const double lowY=0, const double highY=100, const unsigned long binsY=10, const double lowZ=0, const double highZ=100, const unsigned long binsZ=10) const
	book the 3D histogram
AIDA::IHistogram3D *	book3D (const HistoID &ID, const std::string &title, const double lowX=0, const double highX=100, const unsigned long binsX=10, const double lowY=0, const double highY=100, const unsigned long binsY=10, const double lowZ=0, const double highZ=100, const unsigned long binsZ=10) const
	book the 3D histogram with forced ID
AIDA::IHistogram3D *	book3D (const std::string &title, const HistoBinEdges &edgesX, const HistoBinEdges &edgesY, const HistoBinEdges &edgesZ) const
	book the 3D variable binning histogram
AIDA::IHistogram3D *	book3D (const HistoID &ID, const std::string &title, const HistoBinEdges &edgesX, const HistoBinEdges &edgesY, const HistoBinEdges &edgesZ) const
	book the 3D variable binning histogram with given ID
AIDA::IProfile1D *	bookProfile1D (const std::string &title, const double low=0, const double high=100, const unsigned long bins=100, const std::string &opt="", const double lowY=-std::numeric_limits< double >::max(), const double highY=std::numeric_limits< double >::max()) const
	book the 1D profile histogram
AIDA::IProfile1D *	bookProfile1D (const HistoID &ID, const std::string &title, const double low=0, const double high=100, const unsigned long bins=100, const std::string &opt="", const double lowY=-std::numeric_limits< double >::max(), const double highY=std::numeric_limits< double >::max()) const
	book the 1D profile histogram
AIDA::IProfile1D *	bookProfile1D (const std::string &title, const HistoBinEdges &edges) const
	book the 1D profile histogram
AIDA::IProfile1D *	bookProfile1D (const HistoID &ID, const std::string &title, const HistoBinEdges &edges) const
	book the 1D profile histogram
AIDA::IProfile2D *	bookProfile2D (const std::string &title, const double lowX=0, const double highX=100, const unsigned long binsX=50, const double lowY=0, const double highY=100, const unsigned long binsY=50) const
	book the 2D profile histogram
AIDA::IProfile2D *	bookProfile2D (const HistoID &ID, const std::string &title, const double lowX=0, const double highX=100, const unsigned long binsX=50, const double lowY=0, const double highY=100, const unsigned long binsY=50) const
	book the 2D profile histogram with forced ID
AIDA::IProfile2D *	bookProfile2D (const std::string &title, const HistoBinEdges &edgesX, const HistoBinEdges &edgesY) const
	book the 2D profile histogram
AIDA::IProfile2D *	bookProfile2D (const HistoID &ID, const std::string &title, const HistoBinEdges &edgesX, const HistoBinEdges &edgesY) const
	book the 2D profile histogram with forced ID
AIDA::IHistogram1D *	fill (AIDA::IHistogram1D *histo, const double value, const double weight, const std::string &title="") const
	fill the 1D histogram with the value and weight
AIDA::IHistogram2D *	fill (AIDA::IHistogram2D *histo, const double valueX, const double valueY, const double weight, const std::string &title="") const
	fill the 2D histogram with the value and weight
AIDA::IHistogram3D *	fill (AIDA::IHistogram3D *histo, const double valueX, const double valueY, const double valueZ, const double weight, const std::string &title="") const
	fill the 3D histogram with the value and weight
AIDA::IProfile1D *	fill (AIDA::IProfile1D *histo, const double valueX, const double valueY, const double weight, const std::string &title="") const
	fill the 1D profile histogram with the values and weight
AIDA::IProfile2D *	fill (AIDA::IProfile2D *histo, const double valueX, const double valueY, const double valueZ, const double weight, const std::string &title="") const
	fill the 2D profile histogram with the values and weight
AIDA::IHistogram1D *	histo1D (const std::string &title) const
	access the EXISTING 1D histogram by title return the pointer to existing 1D histogram or NULL
AIDA::IHistogram1D *	histo (const std::string &title) const
	access the EXISTING 1D histogram by title
AIDA::IHistogram2D *	histo2D (const std::string &title) const
	access the EXISTING 2D histogram by title return the pointer to existing 2D histogram or NULL
AIDA::IHistogram3D *	histo3D (const std::string &title) const
	access the EXISTING 3D histogram by title return the pointer to existing 3D histogram or NULL
AIDA::IProfile1D *	profile1D (const std::string &title) const
	access the EXISTING 1D profile histogram by title return the pointer to existing 1D profile histogram or NULL
AIDA::IProfile2D *	profile2D (const std::string &title) const
	access the EXISTING 2D profile histogram by title return the pointer to existing 2D profile histogram or NULL
AIDA::IHistogram1D *	histo1D (const HistoID &ID) const
	access the EXISTING 1D histogram by ID return the pointer to existing 1D histogram or NULL
AIDA::IHistogram1D *	histo (const HistoID &ID) const
	access the EXISTING 1D histogram by ID
AIDA::IHistogram2D *	histo2D (const HistoID &ID) const
	access the EXISTING 2D histogram by ID return the pointer to existing 2D histogram or NULL
AIDA::IHistogram3D *	histo3D (const HistoID &ID) const
	access the EXISTING 3D histogram by ID return the pointer to existing 3D histogram or NULL
AIDA::IProfile1D *	profile1D (const HistoID &ID) const
	access the EXISTING 1D profile histogram by ID return the pointer to existing 1D profile histogram or NULL
AIDA::IProfile2D *	profile2D (const HistoID &ID) const
	access the EXISTING 2D profile histogram by ID return the pointer to existing 2D profile histogram or NULL
bool	histoExists (const std::string &title) const
	check the existence AND validity of the histogram with given title
bool	histoExists (const HistoID &ID) const
	check the existence AND validity of the histogram with given title
unsigned int	totalNumberOfHistos () const
	Returns the total number of histograms (of all types) currently booked.
bool	produceHistos () const
	get the flag for histogram production (property "HistoProduce")
bool	fullDetail () const
	get flag to control output level of histograms
bool	checkForNaN () const
	get the flag for NaN checks (property "HistoCheckForNan")
bool	splitHistoDir () const
	get the flag for histogram path split (property "HistoSplitDir")
HistoID::NumericID	histoOffSet () const
	get the value for histogram offset (property "HistoOffSet")
const std::string &	histoTopDir () const
	get top-level histogram directory (property "HistoTopDir")
const std::string &	histoDir () const
	get histogram directory (property "HistoDir")
std::string	histoPath () const
	get the constructed histogram path
bool	histosPrint () const
	print histograms at finalization ?
bool	useNumericAutoIDs () const
	Use old style sequencial numerical automatically assigned IDs ?
int	printHistos (const MSG::Level level=MSG::ALWAYS) const
	perform the actual printout of histograms
const Histo1DMapTitle &	histo1DMapTitle () const
	get access to the map of all 1D histograms indexed via their title
const Histo1DMapNumID &	histo1DMapNumID () const
	get access to the map of 1D histograms index via a numeric ID
const Histo1DMapLitID &	histo1DMapLitID () const
	get access to the map of all 1D histograms index via a literal (string) ID
const Histo2DMapTitle &	histo2DMapTitle () const
	get access to the map of all 2D histograms indexed via their title
const Histo2DMapNumID &	histo2DMapNumID () const
	get access to the map of 2D histograms index via a numeric ID
const Histo2DMapLitID &	histo2DMapLitID () const
	get access to the map of all 2D histograms index via a literal (string) ID
const Histo3DMapTitle &	histo3DMapTitle () const
	get access to the map of all 3D histograms indexed via their title
const Histo3DMapNumID &	histo3DMapNumID () const
	get access to the map of 3D histograms index via a numeric ID
const Histo3DMapLitID &	histo3DMapLitID () const
	get access to the map of all 3D histograms index via a literal (string) ID
const Profile1DMapTitle &	profile1DMapTitle () const
	get access to the map of all 1D profile histograms indexed via their title
const Profile1DMapNumID &	profile1DMapNumID () const
	get access to the map of 1D profile histograms index via a numeric ID
const Profile1DMapLitID &	profile1DMapLitID () const
	get access to the map of 1D profile histograms index via a literal ID
const Profile2DMapTitle &	profile2DMapTitle () const
	get access to the map of all 2D profile histograms indexed via their title
const Profile2DMapNumID &	profile2DMapNumID () const
	get access to the map of 2D profile histograms index via a numeric ID
const Profile2DMapLitID &	profile2DMapLitID () const
	get access to the map of 2D profile histograms index via a literal ID
void	setProduceHistos (const bool val)
	set the flag for histogram production (property "HistoProduce")
void	setFullDetail (const bool val)
	set flag to control output level of histograms
void	setCheckForNaN (const bool val)
	set the flag for NaN checks (property "HistoCheckForNan")
void	setSplitHistoDir (const bool val)
	set the flag for histogram path split (property "HistoSplitDir")
void	setHistoOffSet (const HistoID::NumericID val)
	set a value for histogram offset (property "HistoOffSet"
void	setHistoTopDir (const std::string &val)
	set top-level histogram directory (property "HistoTopDir")
void	setHistoDir (const std::string &val)
	set histogram directory (property "HistoDir")
	GaudiHistos (const std::string &name, ISvcLocator *pSvcLocator)
	Algorithm constructor.
	GaudiHistos (const std::string &type, const std::string &name, const IInterface *parent)
	Tool constructor.
virtual	~GaudiHistos ()
	Destructor.
Protected Member Functions
virtual StatusCode	initialize ()
	standard initialization method
virtual StatusCode	finalize ()
	standard finalization method
std::string	convertTitleToID (const std::string &title) const
	Create an ID string from a title string.
Private Member Functions
bool	noHistos () const
	Check if all histogram maps are empty.
void	initGaudiHistosConstructor ()
	Constructor initialisation and job options.
void	monitorHisto (const AIDA::IBaseHistogram *hist, const HistoID &ID) const
	Declare a histogram to the monitor service.
void	newHistoID (const std::string &title, HistoID &ID) const
	Create a new histogram ID using the given title.
void	stringSearchReplace (std::string &title, const std::string &A, const std::string &B) const
	Searches 'title' for all instancies of 'A' and replaces them with 'B'.
void	printHistoHandler (Property &)
	the handler for "HistoPrint" property
Private Attributes
bool	m_produceHistos
	flag to SWITCH ON/SWITCH OFF the histogrm fillling and booking
bool	m_fullDetail
	flag to control output level of histograms
bool	m_checkForNaN
	flag to control check for Nan/Finite while filling the histogram
bool	m_splitHistoDir
	split histogram directory name (very useful for Hbook)
HistoID::NumericID	m_histoOffSet
	general histogram ID offset (only works for automatically assigned numeric IDs)
std::string	m_histoTopDir
	histogram top level directory
std::string	m_histoDir
	histogram directory
bool	m_histosPrint
	print histograms at finalization
bool	m_declareMoniHists
	Flag to turn on/off the registration of histograms to the Monitoring Service.
Histo1DMapTitle	m_histo1DMapTitle
	the actual storage/access of 1D histograms by unique title
Histo1DMapNumID	m_histo1DMapNumID
	the actual storage/access of 1D histograms by unique numeric ID
Histo1DMapLitID	m_histo1DMapLitID
	the actual storage/access of 1D histograms by unique literal ID
Histo2DMapTitle	m_histo2DMapTitle
	the actual storage/access of 2D histograms by unique title
Histo2DMapNumID	m_histo2DMapNumID
	the actual storage/access of 2D histograms by unique numeric ID
Histo2DMapLitID	m_histo2DMapLitID
	the actual storage/access of 2D histograms by unique literal ID
Histo3DMapTitle	m_histo3DMapTitle
	the actual storage/access of 3D histograms by unique title
Histo3DMapNumID	m_histo3DMapNumID
	the actual storage/access of 3D histograms by unique numeric ID
Histo3DMapLitID	m_histo3DMapLitID
	the actual storage/access of 3D histograms by unique literal ID
Profile1DMapTitle	m_profile1DMapTitle
	the actual storage/access of 1D profile histograms by unique title
Profile1DMapNumID	m_profile1DMapNumID
	the actual storage/access of 1D profile histograms by unique numeric ID
Profile1DMapLitID	m_profile1DMapLitID
	the actual storage/access of 1D profile histograms by unique literal ID
Profile2DMapTitle	m_profile2DMapTitle
	the actual storage/access of 2D profile histograms by unique title
Profile2DMapNumID	m_profile2DMapNumID
	the actual storage/access of 2D profile histograms by unique numeric ID
Profile2DMapLitID	m_profile2DMapLitID
	the actual storage/access of 2D profile histograms by unique literal ID
std::string	m_histo1DTableFormat
	format for printout of 1D-histograms as a table
std::string	m_histo1DTableFormatShort
	format for printout of 1D-histograms as a table
std::string	m_histo1DTableHeader
	the header for the table of 1-D historgrams
bool	m_useNumericAutoIDs
	Flag to switch back to the old style sequencial numerical automatic IDs.
std::map< std::string, std::string >	m_idReplaceInfo
	Map of strings to search and replace when using the title as the basis of automatically generated literal IDs.

---

Member Typedef Documentation

template<class PBASE>

typedef GaudiAlg::HistoID GaudiHistos< PBASE >::HistoID

the actual type for histogram identifier

Reimplemented in HistoTool, GaudiTuples< GaudiHistoTool >, and GaudiTuples< GaudiHistoAlg >.

Definition at line 56 of file GaudiHistos.h.

template<class PBASE>

typedef GaudiAlg::Histo1DMapNumericID GaudiHistos< PBASE >::Histo1DMapNumID

the actual type for (Numeric ID)->(1D histogram) mapping

Definition at line 59 of file GaudiHistos.h.

template<class PBASE>

typedef GaudiAlg::Histo1DMapLiteralID GaudiHistos< PBASE >::Histo1DMapLitID

the actual type for (Literal ID)->(1D histogram) mapping

Definition at line 61 of file GaudiHistos.h.

template<class PBASE>

typedef GaudiAlg::Histo1DMapTitle GaudiHistos< PBASE >::Histo1DMapTitle

the actual type for title->(1D histogram) mapping

Definition at line 63 of file GaudiHistos.h.

template<class PBASE>

typedef GaudiAlg::Histo2DMapNumericID GaudiHistos< PBASE >::Histo2DMapNumID

the actual type for (Numeric ID)->(2D histogram) mapping

Definition at line 66 of file GaudiHistos.h.

template<class PBASE>

typedef GaudiAlg::Histo2DMapLiteralID GaudiHistos< PBASE >::Histo2DMapLitID

the actual type for (Literal ID)->(2D histogram) mapping

Definition at line 68 of file GaudiHistos.h.

template<class PBASE>

typedef GaudiAlg::Histo2DMapTitle GaudiHistos< PBASE >::Histo2DMapTitle

the actual type for title->(2D histogram) mapping

Definition at line 70 of file GaudiHistos.h.

template<class PBASE>

typedef GaudiAlg::Histo3DMapNumericID GaudiHistos< PBASE >::Histo3DMapNumID

the actual type for (Numeric ID)->(3D histogram) mapping

Definition at line 73 of file GaudiHistos.h.

template<class PBASE>

typedef GaudiAlg::Histo3DMapLiteralID GaudiHistos< PBASE >::Histo3DMapLitID

the actual type for (Literal ID)->(3D histogram) mapping

Definition at line 75 of file GaudiHistos.h.

template<class PBASE>

typedef GaudiAlg::Histo3DMapTitle GaudiHistos< PBASE >::Histo3DMapTitle

the actual type for title->(3D histogram) mapping

Definition at line 77 of file GaudiHistos.h.

template<class PBASE>

typedef GaudiAlg::Profile1DMapNumericID GaudiHistos< PBASE >::Profile1DMapNumID

the actual type for (Numeric ID)->(1D profile histogram) mapping

Definition at line 80 of file GaudiHistos.h.

template<class PBASE>

typedef GaudiAlg::Profile1DMapLiteralID GaudiHistos< PBASE >::Profile1DMapLitID

the actual type for (Literal ID)->(1D profile histogram) mapping

Definition at line 82 of file GaudiHistos.h.

template<class PBASE>

typedef GaudiAlg::Profile1DMapTitle GaudiHistos< PBASE >::Profile1DMapTitle

the actual type for title->(1D profile histogram) mapping

Definition at line 84 of file GaudiHistos.h.

template<class PBASE>

typedef GaudiAlg::Profile2DMapNumericID GaudiHistos< PBASE >::Profile2DMapNumID

the actual type for (Numeric ID)->(2D profile histogram) mapping

Definition at line 87 of file GaudiHistos.h.

template<class PBASE>

typedef GaudiAlg::Profile2DMapLiteralID GaudiHistos< PBASE >::Profile2DMapLitID

the actual type for (Literal ID)->(2D profile histogram) mapping

Definition at line 89 of file GaudiHistos.h.

template<class PBASE>

typedef GaudiAlg::Profile2DMapTitle GaudiHistos< PBASE >::Profile2DMapTitle

the actual type for title->(2D profile histogram) mapping

Definition at line 91 of file GaudiHistos.h.

template<class PBASE>

typedef GaudiAlg::HistoBinEdges GaudiHistos< PBASE >::HistoBinEdges

Edges for variable binning.

Definition at line 94 of file GaudiHistos.h.

---

Constructor & Destructor Documentation

template<class PBASE>

GaudiHistos< PBASE >::GaudiHistos	(	const std::string &	name,
		ISvcLocator *	pSvcLocator
	)

Algorithm constructor.

template<class PBASE>

GaudiHistos< PBASE >::GaudiHistos	(	const std::string &	type,
		const std::string &	name,
		const IInterface *	parent
	)

Tool constructor.

template<class PBASE>

GaudiHistos< PBASE >::~GaudiHistos

(

)

[inline, virtual]

Destructor.

Definition at line 55 of file GaudiHistos.icpp.

{}

---

Member Function Documentation

template<class PBASE>

AIDA::IHistogram1D * GaudiHistos< PBASE >::plot1D	(	const double	value,
		const std::string &	title,
		const double	low,
		const double	high,
		const unsigned long	bins = 100,
		const double	weight = 1.0
	)			const [inline]

fill the 1D histogram (book on demand)

     const double mass = ... ;
     plot1D( mass , "Invariant Mass" , 2.5 , 3.5 , 100 )

This example illustrates the filling of the histogram titled "InvariantMass" with value mass .

If the histogram with given title does not exist yet it will be automatically booked with parameters low equal to 2.5, parameters high equal to 3.5 and bins equal to 100.

Attention:

The histogram will get a unique identifier automatically assigned which by default will be equal to the histogram title. An option exists to instead use numerical IDs. In this case the first histogram booked will be ID=1 the next ID=2 and so on. Note though this scheme is not recommended as it does NOT guarantee predictability of the ID a given histogram will be given when filled under conditional statements, since in these circumstances the order in which the histograms are first filled, and thus booked, will depend on the nature of the first few events read. This is particularly problematic when users submit many parallel 'sub-jobs' and then attempt to merge the final output ROOT (or HBOOK) files, since a given histogram could have different IDs in each of the sub-jobs. Consequently it is strongly recommended that users do not use numerical automatic IDs unless they are sure they understand what they are doing.

See also:

AIDA::IHistogram1D

Parameters:

	value	value to be filled
	title	histogram title (must be unique within the algorithm)
	low	low limit for histogram
	high	high limit for histogram
	bins	number of bins
	weight	weight

Returns:

pointer to AIDA 1D histogram

Reimplemented in HistoTool.

Definition at line 134 of file GaudiHistos_1DFixedBinning.icpp.

{
  AIDA::IHistogram1D * h(NULL);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = histo1D ( title ) ;
    if ( NULL == h ) { h = book1D  ( title , low , high , bins ) ; }
    // fill the histogram
    h = fill ( h , value , weight , title );
  }
  return h;
}

template<class PBASE>

AIDA::IHistogram1D* GaudiHistos< PBASE >::plot	(	const double	value,
		const std::string &	title,
		const double	low,
		const double	high,
		const unsigned long	bins = 100,
		const double	weight = 1.0
	)			const [inline]

fill the 1D histogram (book on demand)

Wrapper method for the equivalent plot1D method. Retained for backwards compatibility, please use plot1D instead.

Parameters:

	value	value to be filled
	title	histogram title (must be unique within the algorithm)
	low	low limit for histogram
	high	high limit for histogram
	bins	number of bins
	weight	weight

Returns:

pointer to AIDA 1D histogram

Definition at line 165 of file GaudiHistos.h.

  {
    return plot1D ( value, title, low, high, bins, weight );
  }

template<class PBASE>

AIDA::IHistogram1D * GaudiHistos< PBASE >::plot1D	(	const double	value,
		const Gaudi::Histo1DDef &	hdef,
		const double	weight = 1.0
	)			const [inline]

fill the 1D histogram (book on demand)

     const Gaudi::Histo1DDef& hdef = ... ;

     const double mass = ... ;
     plot1D ( mass , hdef ) ;

The histogram will get a unique identifier automatically assigned which by default will be equal to the histogram title.

The histogram descriptor comes e.g. from the component properties.

See also:

AIDA::IHistogram1D

Parameters:

	value	value to be filled
	hdef	histogram descriptor
	weight	weight

Returns:

pointer to AIDA 1D histogram

Definition at line 211 of file GaudiHistos_1DFixedBinning.icpp.

{
  return plot1D
    ( value  ,
      hdef.title() , hdef.lowEdge() , hdef.highEdge() , hdef.bins() ,
      weight ) ;
}

template<class PBASE>

AIDA::IHistogram1D* GaudiHistos< PBASE >::plot	(	const double	value,
		const Gaudi::Histo1DDef &	hdef,
		const double	weight = 1.0
	)			const [inline]

fill the 1D histogram (book on demand)

Wrapper method for the equivalent plot1D method. Retained for backwards compatibility, please use plot1D instead.

Parameters:

	value	value to be filled
	hdef	histogram descriptor
	weight	weight

Returns:

pointer to AIDA 1D histogram

Definition at line 215 of file GaudiHistos.h.

  {
    return plot1D ( value, hdef, weight );
  }

template<class PBASE>

AIDA::IHistogram1D * GaudiHistos< PBASE >::plot1D	(	const double	value,
		const HistoID &	ID,
		const std::string &	title,
		const double	low,
		const double	high,
		const unsigned long	bins = 100,
		const double	weight = 1.0
	)			const [inline]

fill the 1D histogram with forced ID assignment (book on demand)

     const double mass = ... ;
     plot1D( mass , 15 , "Invariant Mass" , 2.5 , 3.5 , 100 )

This example illustrates the filling of the 1D histogram ID=15 titled "Invariant Mass" with value mass .

If the histogram with given ID does not exist yet it will be automatically booked with parameters low equal to 2.5, parameters high equal to 3.5 and bins equal to 100.

It is also possible to use literal IDs. For example :-

     const double mass = ... ;
     plot1D( mass , "mass" , "Invariant Mass" , 2.5 , 3.5 , 100 )

Will book the same histogram, using the id "mass".

It is also possible using literal IDs, to place histograms in sub-directories from the main histogram directory, using for example :-

     const double mass = ... ;
     plot1D( mass , "subdir/mass" , "Invariant Mass" , 2.5 , 3.5 , 100 )

Which will create the histogram "mass" in the sub-directory "subdir". Histograms can also be created in sub-directories with numeric IDs if IDs such as "subdir/1" are used.

Attention:

If the histogram with given ID is already booked through automatic assignment of histogram ID, the error will not be detected. Therefore it is recommended to use non-trivial histogram ID offset (property "HistoOffSet") if one need to combine these techniques together. It is still desirable to use the unique histogram title to avoid a bad interference.

See also:

AIDA::IHistogram1D

Parameters:

	value	value to be filled
	ID	histogram identifier
	title	histogram title (must be unique within the algorithm)
	low	low limit for histogram
	high	high limit for histogram
	bins	number of bins
	weight	weight

Returns:

pointer to AIDA 1D histogram

Reimplemented in HistoTool.

Definition at line 158 of file GaudiHistos_1DFixedBinning.icpp.

{
  AIDA::IHistogram1D* h(NULL);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = histo1D ( ID ) ;
    if ( NULL == h ) {  h = book1D ( ID , title , low , high , bins ) ; }
    // fill
    h = fill ( h , value , weight , title ) ;
  }
  return h;
}

template<class PBASE>

AIDA::IHistogram1D* GaudiHistos< PBASE >::plot	(	const double	value,
		const HistoID &	ID,
		const std::string &	title,
		const double	low,
		const double	high,
		const unsigned long	bins = 100,
		const double	weight = 1.0
	)			const [inline]

fill the 1D histogram with forced ID assignment (book on demand)

Wrapper method for the equivalent plot1D method. Retained for backwards compatibility, please use plot1D instead.

Parameters:

	value	value to be filled
	ID	histogram identifier
	title	histogram title (must be unique within the algorithm)
	low	low limit for histogram
	high	high limit for histogram
	bins	number of bins
	weight	weight

Returns:

pointer to AIDA 1D histogram

Definition at line 311 of file GaudiHistos.h.

  {
    return plot1D ( value, ID, title, low, high, bins, weight );
  }

template<class PBASE>

AIDA::IHistogram1D * GaudiHistos< PBASE >::plot1D	(	const double	value,
		const HistoID &	ID,
		const Gaudi::Histo1DDef &	hdef,
		const double	weight = 1.0
	)			const [inline]

fill the 1D histogram with forced ID assignment (book on demand)

     // get the histogram descriptor
     const Gaudi::Histo1DDef& hdef = ... ;

     // get the histogram ID
     const HistoID ID = ... ;

     const double mass = ... ;
     plot1D ( mass , ID , hdef  )

See also:

AIDA::IHistogram1D

The histogram descriptor comes e.g. from component properties

Parameters:

	value	value to be filled
	ID	histogram identifier
	hdef	histogram descriptor
	weight	weight

Returns:

pointer to AIDA 1D histogram

Definition at line 226 of file GaudiHistos_1DFixedBinning.icpp.

{
  return plot1D
    ( value  , ID ,
      hdef.title() , hdef.lowEdge() , hdef.highEdge() , hdef.bins() ,
      weight ) ;
}

template<class PBASE>

AIDA::IHistogram1D* GaudiHistos< PBASE >::plot	(	const double	value,
		const HistoID &	ID,
		const Gaudi::Histo1DDef &	hdef,
		const double	weight = 1.0
	)			const [inline]

fill the 1D histogram (book on demand)

Wrapper method for the equivalent plot1D method. Retained for backwards compatibility, please use plot1D instead.

Parameters:

	value	value to be filled
	ID	histogram identifier
	hdef	histogram descriptor
	weight	weight

Returns:

pointer to AIDA 1D histogram

Definition at line 365 of file GaudiHistos.h.

  {
    return plot1D ( value, ID, hdef, weight );
  }

template<class PBASE>

template<class FUNCTION, class OBJECT>

AIDA::IHistogram1D* GaudiHistos< PBASE >::plot	(	const FUNCTION &	func,
		OBJECT	first,
		OBJECT	last,
		const std::string &	title,
		const double	low,
		const double	high,
		const unsigned long	bins = 100
	)			const [inline]

fill the 1D histogram with information from [first,last) sequence

  std::vector<double> v = ... ;

  plot( sin                 , // function
        v.begin() , v.end() , // sequence
        " bla-bla "         , // title
        -1. , 1.0           , // low and high limits
        100                 ) // number of bins

Attention:

The histogram will get a unique identifier automatically assigned which by default will be equal to the histogram title. An option exists to instead use numerical IDs. In this case the first histogram booked will be ID=1 the next ID=2 and so on. Note though this scheme is not recommended as it does NOT guarantee predictability of the ID a given histogram will be given when filled under conditional statements, since in these circumstances the order in which the histograms are first filled, and thus booked, will depend on the nature of the first few events read. This is particularly problematic when users submit many parallel 'sub-jobs' and then attempt to merge the final output ROOT (or HBOOK) files, since a given histogram could have different IDs in each of the sub-jobs. Consequently it is strongly recommended that users do not use numerical automatic IDs unless they are sure they understand what they are doing.

Sequence, objects and function can be non-trivial:

  Particles* p = ... ;

  plot( PT                  , // function
        p->begin()  , p->end() , // sequence
        " bla-bla "         , // title
        -1. , 1.0           , // low and high limits
        100                 ) ; // number of bins

where PT can be any function or function object for which the expression PT(p) , with p of type Particle* have some sense and can be evaluated to the values, which is convertible to double

Attention:

These plot methods using iterator ranges are more efficient than the simplier "value" only methods, since the associated histogram only requires locating from internal storage once per loop, as opposed to once per fill for the simplier functions. It is recommended to use these whenever possible.

See also:

AIDA::IHistogram1D

Parameters:

	func	function to be plotted
	first	begin of the sequence
	last	end of the sequence
	title	histogram title
	low	low limit for histogram
	high	high limit for histogram
	bins	number of bins for histogram

Definition at line 437 of file GaudiHistos.h.

  {
    AIDA::IHistogram1D* h(0);
    if ( produceHistos() )
    {
      // retrieve or book the histogram
      h = histo1D ( title ) ;
      if ( 0 == h )     { h = book1D  ( title , low , high , bins ); }
      // fill histogram
      while( first != last && 0 != h  )
      { h = fill ( h , func( *first ) , 1.0 , title  ) ; ++first ; }
    }
    return h ;
  }

template<class PBASE>

template<class FUNCTION, class OBJECT>

AIDA::IHistogram1D* GaudiHistos< PBASE >::plot	(	const FUNCTION &	func,
		OBJECT	first,
		OBJECT	last,
		const HistoID &	ID,
		const std::string &	title,
		const double	low,
		const double	high,
		const unsigned long	bins = 100
	)			const [inline]

fill the 1D histogram with forced ID and information from [first,last) sequence

  std::vector<double> v = ... ;

  // Example with numeric ID
  plot( sin                 ,   // function
        v.begin() , v.end() ,   // sequence
        100 , " bla-bla "   ,   // ID and title
        -1. , 1.0           ,   // low and high limits
        100                 );  // number of bins

  // Example with literal ID
  plot( sin                 ,   // function
        v.begin() , v.end() ,   // sequence
        "sin" , " bla-bla " ,   // ID and title
        -1. , 1.0           ,   // low and high limits
        100                 );  // number of bins

Sequence, objects and function can be non-trivial:

  Particles* p = ... ;

  plot( PT                  ,   // function
        p->begin()   , p->end() , // sequence
        100 , " bla-bla "   ,   // ID and title
        -1. , 1.0           ,   // low and high limits
        100                 ) ; // number of bins

Attention:

These plot methods using iterator ranges are more efficient than the simplier "value" only methods, since the associated histogram only requires locating from internal storage once per loop, as opposed to once per fill for the simplier functions. It is recommended to use these whenever possible.

See also:

AIDA::IHistogram1D

Parameters:

	func	function to be plotted
	first	begin of the sequence
	last	end of the sequence
	ID	histogram identifier
	title	histogram title
	low	low limit for histogram
	high	high limit for histogram
	bins	number of bins for histogram

Definition at line 515 of file GaudiHistos.h.

  {
    AIDA::IHistogram1D* h(0);
    if ( produceHistos() )
    {
      // retrieve or book the histogram
      h = histo1D ( ID ) ;
      if ( 0 == h )     { h = book1D  ( ID , title , low , high , bins ); }
      // fill histogram
      while( first != last && 0 != h )
      { h = fill( h , func( *first ) , 1.0 , title  ) ; ++first ; }
    }
    return h;
  }

template<class PBASE>

template<class FUNCTION, class OBJECT, class WEIGHT>

AIDA::IHistogram1D* GaudiHistos< PBASE >::plot	(	const FUNCTION &	func,
		OBJECT	first,
		OBJECT	last,
		const std::string &	title,
		const double	low,
		const double	high,
		const unsigned long	bins,
		const WEIGHT &	weight
	)			const [inline]

book and fill the 1D histogram with information from [first,last) sequence with given weight

  std::vector<double> v = ... ;

  plot( sin                 ,   // function
        v.begin() , v.end() ,   // sequence
        " bla-bla "         ,   // title
        -1. , 1.0           ,   // low and high limits
        100                 ,   // number of bins
        tanh                );  // weight function

Attention:

The histogram will get a unique identifier automatically assigned which by default will be equal to the histogram title. An option exists to instead use numerical IDs. In this case the first histogram booked will be ID=1 the next ID=2 and so on. Note though this scheme is not recommended as it does NOT guarantee predictability of the ID a given histogram will be given when filled under conditional statements, since in these circumstances the order in which the histograms are first filled, and thus booked, will depend on the nature of the first few events read. This is particularly problematic when users submit many parallel 'sub-jobs' and then attempt to merge the final output ROOT (or HBOOK) files, since a given histogram could have different IDs in each of the sub-jobs. Consequently it is strongly recommended that users do not use numerical automatic IDs unless they are sure they understand what they are doing.

Sequence, objects and function can be non-trivial:

  Particles* p = ... ;

  plot( PT                  ,  // function
        p->begin()  , p->end() , // sequence
        " bla-bla "         ,   // title
        -1. , 1.0           ,   // low and high limits
        100                 ,   // number of bins
        MASS                ) ; // weight function

where PT and MASS can be any function or function object for which the expressions PT(p) and MASS with p of type Particle* have some sense and can be evaluated to the values, which is convertible to double

Attention:

These plot methods using iterator ranges are more efficient than the simplier "value" only methods, since the associated histogram only requires locating from internal storage once per loop, as opposed to once per fill for the simplier functions. It is recommended to use these whenever possible.

See also:

AIDA::IHistogram1D

Parameters:

	first	begin of the sequence
	last	end of the sequence
	title	histogram title
	func	function to be plotted
	low	low limit for histogram
	high	high limit for histogram
	bins	number of bins for histogram
	weight	weight function

Definition at line 607 of file GaudiHistos.h.

  {
    AIDA::IHistogram1D* h(0);
    if ( produceHistos() )
    {
      // retrieve or book the histogram
      h = histo1D ( title ) ;
      if ( 0 == h ) { h = book1D  ( title , low , high , bins ); }
      // fill histogram
      while ( first != last && 0 != h )
      { h = fill ( h                 ,
                   func   ( *first ) ,
                   weight ( *first ) , title  ) ; ++first ; }
    }
    return h;
  }

template<class PBASE>

template<class FUNCTION, class OBJECT, class WEIGHT>

AIDA::IHistogram1D* GaudiHistos< PBASE >::plot	(	const FUNCTION &	func,
		OBJECT	first,
		OBJECT	last,
		const HistoID &	ID,
		const std::string &	title,
		const double	low,
		const double	high,
		const unsigned long	bins,
		const WEIGHT &	weight
	)			const [inline]

book and fill the 1D histogram with forced ID and information from [first,last) sequence with given weight

  std::vector<double> v = ... ;

  // example with numerical ID
  plot( sin                 ,   // function
        v.begin() , v.end() ,   // sequence
        100 , " bla-bla "   ,   // ID and title
        -1. , 1.0           ,   // low and high limits
        100                 ,   // number of bins
        sinh                );  // weight function

  // example with literal ID
  plot( sin                 ,   // function
        v.begin() , v.end() ,   // sequence
        "sin" , " bla-bla "   ,   // ID and title
        -1. , 1.0           ,   // low and high limits
        100                 ,   // number of bins
        sinh                );  // weight function

Attention:

no checks for NaN or Finite are performed!

Sequence, objects and function can be non-trivial:

  Particles* p = ... ;

  plot( PT                  ,   // function
        p->begin()   , p->end() , // sequence
        100 , " bla-bla "   ,   // ID and title
        -1. , 1.0           ,   // low and high limits
        100                 ,   // number of bins
        MASS                ) ; // weight function

where PT and MASS can be any function or function object for which the expressions PT(p) and MASS with p of type Particle* have some sense and can be evaluated to the values, which is convertible to double

Attention:

These plot methods using iterator ranges are more efficient than the simplier "value" only methods, since the associated histogram only requires locating from internal storage once per loop, as opposed to once per fill for the simplier functions. It is recommended to use these whenever possible.

See also:

AIDA::IHistogram1D

Parameters:

	first	begin of the sequence
	last	end of the sequence
	ID	histogram identifier
	title	histogram title
	func	function to be plotted
	low	low limit for histogram
	high	high limit for histogram
	bins	number of bins for histogram
	weight	weight function

Definition at line 699 of file GaudiHistos.h.

  {
    AIDA::IHistogram1D* h(0);
    if ( produceHistos() )
    {
      // retrieve or book the histogram
      h = histo1D ( ID ) ;
      if ( 0 == h ) { h = book1D  ( ID , title , low , high , bins ); }
      // fill histogram
      while( first != last && 0 != h )
      { h  = fill ( h                 ,
                    func   ( *first ) ,
                    weight ( *first ) , title  ) ; ++first ; }
    }
    return h ;
  }

template<class PBASE>

AIDA::IHistogram1D * GaudiHistos< PBASE >::plot1D	(	const double	value,
		const std::string &	title,
		const HistoBinEdges &	edges,
		const double	weight = 1.0
	)			const [inline]

Fill the 1D variable binning histogram (book on demand).

     const GaudiAlg::HistoBinEdges edges = ...;
     const double mass = ... ;
     plot1D( mass , "Invariant Mass" , edges )

This example illustrates the filling of the histogram titled "InvariantMass" with value mass.

If the histogram with given title does not exist yet it will be automatically booked with the given histogram bin edges.

Attention:

The histogram will get a unique identifier automatically assigned which by default will be equal to the histogram title. An option exists to instead use numerical IDs. In this case the first histogram booked will be ID=1 the next ID=2 and so on. Note though this scheme is not recommended as it does NOT guarantee predictability of the ID a given histogram will be given when filled under conditional statements, since in these circumstances the order in which the histograms are first filled, and thus booked, will depend on the nature of the first few events read. This is particularly problematic when users submit many parallel 'sub-jobs' and then attempt to merge the final output ROOT (or HBOOK) files, since a given histogram could have different IDs in each of the sub-jobs. Consequently it is strongly recommended that users do not use numerical automatic IDs unless they are sure they understand what they are doing.

See also:

AIDA::IHistogram1D

Parameters:

	value	value to be filled
	title	histogram title (must be unique within the algorithm)
	edges	The histogram bin edges
	weight	weight

Returns:

pointer to AIDA 1D histogram

Definition at line 94 of file GaudiHistos_1DVariableBinning.icpp.

{
  AIDA::IHistogram1D * h(NULL);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = histo1D ( title ) ;
    if ( NULL == h ) { h = book1D ( title , edges ) ; }
    // fill the histogram
    h = fill ( h , value , weight , title );
  }
  return h;
}

template<class PBASE>

AIDA::IHistogram1D * GaudiHistos< PBASE >::plot1D	(	const double	value,
		const HistoID &	ID,
		const std::string &	title,
		const HistoBinEdges &	edges,
		const double	weight = 1.0
	)			const [inline]

fill the 1D variable binning histogram with forced ID assignment (book on demand)

     const GaudiAlg::HistoBinEdges edges = ...;
     const double mass = ... ;
     plot1D( mass , 15 , "Invariant Mass" , edges )

This example illustrates the filling of the 1D histogram ID=15 titled "Invariant Mass" with value mass.

If the histogram with given ID does not exist yet it will be automatically booked with the given histogram bin edges.

It is also possible to use literal IDs. For example :-

     const GaudiAlg::HistoBinEdges edges = ...;
     const double mass = ... ;
     plot1D( mass , "mass" , "Invariant Mass" , edges )

Will book the same histogram, using the id "mass".

It is also possible using literal IDs, to place histograms in sub-directories from the main histogram directory, using for example :-

     const GaudiAlg::HistoBinEdges edges = ...;
     const double mass = ... ;
     plot1D( mass , "subdir/mass" , "Invariant Mass" , edges )

Which will create the histogram "mass" in the sub-directory "subdir". Histograms can also be created in sub-directories with numeric IDs if IDs such as "subdir/1" are used.

Attention:

If the histogram with given ID is already booked through automatic assignment of histogram ID, the error will not be detected. Therefore it is recommended to use non-trivial histogram ID offset (property "HistoOffSet") if one need to combine these techniques together. It is still desirable to use the unique histogram title to avoid a bad interference.

See also:

AIDA::IHistogram1D

Parameters:

	value	value to be filled
	ID	histogram identifier
	title	histogram title (must be unique within the algorithm)
	edges	The histogram bin edges
	weight	weight

Returns:

pointer to AIDA 1D histogram

Definition at line 116 of file GaudiHistos_1DVariableBinning.icpp.

{
  AIDA::IHistogram1D* h(NULL);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = histo1D ( ID ) ;
    if ( NULL == h ) {  h = book1D ( ID , title , edges ) ; }
    // fill
    h = fill ( h , value , weight , title ) ;
  }
  return h;
}

template<class PBASE>

AIDA::IHistogram2D * GaudiHistos< PBASE >::plot2D	(	const double	valueX,
		const double	valueY,
		const std::string &	title,
		const double	lowX,
		const double	highX,
		const double	lowY,
		const double	highY,
		const unsigned long	binsX = 50,
		const unsigned long	binsY = 50,
		const double	weight = 1.0
	)			const [inline]

fill the 2D histogram (book on demand)

     const double mass1 = ... ;
     const double mass2 = ... ;
     plot2D( mass1, mass2,
            "Invariant Mass2 versus Mass1" ,2.5 ,3.5, 4.5, 5.5, 100, 200 );

This example illustrates the filling of the 2D histogram titled "Invariant Mass2 versus Mass1" with values mass1 and mass2 .

If the histogram with given title does not exist yet it will be automatically booked with parameters lowX equal to 2.5, highX equal to 3.5, lowY equal to 4.5, highY equal to 5.5, binsX equal to 100 and binsY equal to 200.

Attention:

The histogram will get a unique identifier automatically assigned which by default will be equal to the histogram title. An option exists to instead use numerical IDs. In this case the first histogram booked will be ID=1 the next ID=2 and so on. Note though this scheme is not recommended as it does NOT guarantee predictability of the ID a given histogram will be given when filled under conditional statements, since in these circumstances the order in which the histograms are first filled, and thus booked, will depend on the nature of the first few events read. This is particularly problematic when users submit many parallel 'sub-jobs' and then attempt to merge the final output ROOT (or HBOOK) files, since a given histogram could have different IDs in each of the sub-jobs. Consequently it is strongly recommended that users do not use numerical automatic IDs unless they are sure they understand what they are doing.

See also:

AIDA::IHistogram2D

Parameters:

	valueX	x value to be filled
	valueY	y value to be filled
	title	histogram title (must be unique within the algorithm)
	lowX	low x limit for histogram
	highX	high x limit for histogram
	lowY	low y limit for histogram
	highY	high y limit for histogram
	binsX	number of bins in x
	binsY	number of bins in y
	weight	weight

Returns:

pointer to AIDA 2D histogram

Reimplemented in HistoTool.

Definition at line 147 of file GaudiHistos_2DFixedBinning.icpp.

{
  AIDA::IHistogram2D * h(NULL);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = histo2D ( title ) ;
    if ( NULL == h )
    { h = book2D ( title , lowX , highX , binsX , lowY , highY , binsY ) ; }
    // fill the histogram
    h = fill ( h , valueX , valueY , weight , title ) ;
  }
  return h;
}

template<class PBASE>

AIDA::IHistogram2D * GaudiHistos< PBASE >::plot2D	(	const double	valueX,
		const double	valueY,
		const HistoID &	ID,
		const std::string &	title,
		const double	lowX,
		const double	highX,
		const double	lowY,
		const double	highY,
		const unsigned long	binsX = 50,
		const unsigned long	binsY = 50,
		const double	weight = 1.0
	)			const [inline]

fill the 2D histogram with forced ID assignment (book on demand)

     const double mass1 = ... ;
     const double mass2 = ... ;
     plot2D( mass1, mass2, 15,
             "Invariant Mass2 versus Mass1" ,2.5 ,3.5, 4.5, 5.5, 100, 200 );

This example illustrates the filling of the 2D histogram ID=15 titled "Invariant Mass2 versus Mass1" with values mass1 and mass2 .

If the histogram with given title does not exist yet it will be automatically booked with parameters lowX equal to 2.5, highX equal to 3.5, lowY equal to 4.5, highY equal to 5.5, binsX equal to 100 and binsY equal to 200.

It is also possible to use literal IDs. For example :-

     const double mass1 = ... ;
     const double mass2 = ... ;
     plot2D( mass1, mass2, "mass",
             "Invariant Mass2 versus Mass1" ,2.5 ,3.5, 4.5, 5.5, 100, 200 );

Will book the same histogram, using the id "mass".

It is also possible using literal IDs, to place histograms in sub-directories from the main histogram directory, using for example :-

     const double mass1 = ... ;
     const double mass2 = ... ;
     plot2D( mass1, mass2, "subdir/mass",
             "Invariant Mass2 versus Mass1" ,2.5 ,3.5, 4.5, 5.5, 100, 200 );

Which will create the histogram "mass" in the sub-directory "subdir". Histograms can also be created in sub-directories with numeric IDs if IDs such as "subdir/1" are used.

Attention:

If the histogram with given ID is already booked through automatic assignment of histogram ID, the error will not be detected. Therefore it is recommended to use non-trivial histogram ID offset (property "HistoOffSet") if one need to combine these techniques together It is still desirable to use the unique histogram title to avoid a bad interference

See also:

AIDA::IHistogram2D

Parameters:

	valueX	x value to be filled
	valueY	y value to be filled
	ID	Histogram ID to use
	title	histogram title (must be unique within the algorithm)
	lowX	low x limit for histogram
	highX	high x limit for histogram
	lowY	low y limit for histogram
	highY	high y limit for histogram
	binsX	number of bins in x
	binsY	number of bins in y
	weight	weight

Returns:

pointer to AIDA 2D histogram

Reimplemented in HistoTool.

Definition at line 175 of file GaudiHistos_2DFixedBinning.icpp.

{
  AIDA::IHistogram2D * h(NULL);
  // produce histograms ?
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = histo2D ( ID ) ;
    if ( NULL == h ) { h = book2D ( ID   , title ,
                                 lowX , highX , binsX ,
                                 lowY , highY , binsY ) ; }
    // fill the histogram
    h = fill ( h , valueX , valueY , weight , title ) ;
  }
  return h;
}

template<class PBASE>

AIDA::IHistogram2D * GaudiHistos< PBASE >::plot2D	(	const double	valueX,
		const double	valueY,
		const std::string &	title,
		const HistoBinEdges &	edgesX,
		const HistoBinEdges &	edgesY,
		const double	weight = 1.0
	)			const [inline]

Fill the 2D variable binning histogram (book on demand).

     const GaudiAlg::HistoBinEdges edgesX = ...;
     const GaudiAlg::HistoBinEdges edgesY = ...;
     const double mass1 = ... ;
     const double mass2 = ... ;
     plot2D( mass1, mass2,
            "Invariant Mass2 versus Mass1" , edgesX, edgesY );

This example illustrates the filling of the 2D histogram titled "Invariant Mass2 versus Mass1" with values mass1 and mass2 .

If the histogram with given title does not exist yet it will be automatically booked with the given histogram bin edges.

Attention:

The histogram will get a unique identifier automatically assigned which by default will be equal to the histogram title. An option exists to instead use numerical IDs. In this case the first histogram booked will be ID=1 the next ID=2 and so on. Note though this scheme is not recommended as it does NOT guarantee predictability of the ID a given histogram will be given when filled under conditional statements, since in these circumstances the order in which the histograms are first filled, and thus booked, will depend on the nature of the first few events read. This is particularly problematic when users submit many parallel 'sub-jobs' and then attempt to merge the final output ROOT (or HBOOK) files, since a given histogram could have different IDs in each of the sub-jobs. Consequently it is strongly recommended that users do not use numerical automatic IDs unless they are sure they understand what they are doing.

See also:

AIDA::IHistogram2D

Parameters:

	valueX	x value to be filled
	valueY	y value to be filled
	title	histogram title (must be unique within the algorithm)
	edgesX	The histogram x bin edges
	edgesY	The histogram y bin edges
	weight	weight

Returns:

pointer to AIDA 2D histogram

Definition at line 98 of file GaudiHistos_2DVariableBinning.icpp.

{
  AIDA::IHistogram2D * h(NULL);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = histo2D ( title ) ;
    if ( NULL == h ) { h = book2D ( title , edgesX , edgesY ) ; }
    // fill the histogram
    h = fill ( h , valueX , valueY , weight , title );
  }
  return h;
}

template<class PBASE>

AIDA::IHistogram2D * GaudiHistos< PBASE >::plot2D	(	const double	valueX,
		const double	valueY,
		const HistoID &	ID,
		const std::string &	title,
		const HistoBinEdges &	edgesX,
		const HistoBinEdges &	edgesY,
		const double	weight = 1.0
	)			const [inline]

fill the 2D variable histogram with forced ID assignment (book on demand)

     const GaudiAlg::HistoBinEdges edgesX = ...;
     const GaudiAlg::HistoBinEdges edgesY = ...;
     const double mass1 = ... ;
     const double mass2 = ... ;
     plot2D( mass1, mass2, 15,
             "Invariant Mass2 versus Mass1", edgesX, edgesY );

This example illustrates the filling of the 2D histogram ID=15 titled "Invariant Mass2 versus Mass1" with values mass1 and mass2 .

If the histogram with given title does not exist yet it will be automatically booked with the given histogram bin edges.

It is also possible to use literal IDs. For example :-

     const GaudiAlg::HistoBinEdges edgesX = ...;
     const GaudiAlg::HistoBinEdges edgesY = ...;
     const double mass1 = ... ;
     const double mass2 = ... ;
     plot2D( mass1, mass2, "mass",
             "Invariant Mass2 versus Mass1", edgesX, edgesY );

Will book the same histogram, using the id "mass".

It is also possible using literal IDs, to place histograms in sub-directories from the main histogram directory, using for example :-

     const GaudiAlg::HistoBinEdges edgesX = ...;
     const GaudiAlg::HistoBinEdges edgesY = ...;
     const double mass1 = ... ;
     const double mass2 = ... ;
     plot2D( mass1, mass2, "subdir/mass",
             "Invariant Mass2 versus Mass1", edgesX, edgesY );

Which will create the histogram "mass" in the sub-directory "subdir". Histograms can also be created in sub-directories with numeric IDs if IDs such as "subdir/1" are used.

Attention:

If the histogram with given ID is already booked through automatic assignment of histogram ID, the error will not be detected. Therefore it is recommended to use non-trivial histogram ID offset (property "HistoOffSet") if one need to combine these techniques together It is still desirable to use the unique histogram title to avoid a bad interference

See also:

AIDA::IHistogram2D

Parameters:

	valueX	x value to be filled
	valueY	y value to be filled
	ID	Histogram ID to use
	title	histogram title (must be unique within the algorithm)
	edgesX	The histogram x bin edges
	edgesY	The histogram y bin edges
	weight	weight

Returns:

pointer to AIDA 2D histogram

Definition at line 122 of file GaudiHistos_2DVariableBinning.icpp.

{
  AIDA::IHistogram2D * h(NULL);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = histo2D ( ID ) ;
    if ( NULL == h ) {  h = book2D ( ID , title , edgesX , edgesY ) ; }
    // fill
    h = fill ( h , valueX , valueY , weight , title ) ;
  }
  return h;
}

template<class PBASE>

AIDA::IHistogram3D * GaudiHistos< PBASE >::plot3D	(	const double	valueX,
		const double	valueY,
		const double	valueZ,
		const std::string &	title,
		const double	lowX,
		const double	highX,
		const double	lowY,
		const double	highY,
		const double	lowZ,
		const double	highZ,
		const unsigned long	binsX = 10,
		const unsigned long	binsY = 10,
		const unsigned long	binsZ = 10,
		const double	weight = 1.0
	)			const [inline]

fill the 3D histogram (book on demand)

     const double X = ... ;
     const double Y = ... ;
     const double Z = ... ;
     plot3D( X, Y, Z, "Space Points" ,
            2.5 , 3.5 ,
            4.5 , 5.5 ,
            6.5 , 7.5 ,
            10, 20, 30 );

This example illustrates the filling of the 3D histogram titled "Space Points" with values X, Y and Z.

If the histogram with given title does not exist yet it will be automatically booked with parameters lowX equal to 2.5, highX equal to 3.5, lowY equal to 4.5, highY equal to 5.5, lowZ equal to 6.5, highZ equal to 7.5, binsX equal to 10, binsY equal to 20 and binsZ equal to 30.

Attention:

The histogram will get a unique identifier automatically assigned which by default will be equal to the histogram title. An option exists to instead use numerical IDs. In this case the first histogram booked will be ID=1 the next ID=2 and so on. Note though this scheme is not recommended as it does NOT guarantee predictability of the ID a given histogram will be given when filled under conditional statements, since in these circumstances the order in which the histograms are first filled, and thus booked, will depend on the nature of the first few events read. This is particularly problematic when users submit many parallel 'sub-jobs' and then attempt to merge the final output ROOT (or HBOOK) files, since a given histogram could have different IDs in each of the sub-jobs. Consequently it is strongly recommended that users do not use numerical automatic IDs unless they are sure they understand what they are doing.

See also:

AIDA::IHistogram3D

Parameters:

	valueX	x value to be filled
	valueY	y value to be filled
	valueZ	z value to be filled
	title	histogram title (must be unique within the algorithm)
	lowX	low x limit for histogram
	highX	high x limit for histogram
	lowY	low y limit for histogram
	highY	high y limit for histogram
	lowZ	low z limit for histogram
	highZ	high z limit for histogram
	binsX	number of bins in x
	binsY	number of bins in y
	binsZ	number of bins in z
	weight	weight

Returns:

pointer to AIDA 3D histogram

Reimplemented in HistoTool.

Definition at line 164 of file GaudiHistos_3DFixedBinning.icpp.

{
  AIDA::IHistogram3D * h(0);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = histo3D ( title ) ;
    if ( 0 == h ) { h = book3D ( title ,
                                 lowX , highX , binsX ,
                                 lowY , highY , binsY ,
                                 lowZ , highZ , binsZ ) ; }
    // fill the histogram
    h = fill ( h , valueX , valueY , valueZ , weight , title ) ;
  }
  return h;
}

template<class PBASE>

AIDA::IHistogram3D * GaudiHistos< PBASE >::plot3D	(	const double	valueX,
		const double	valueY,
		const double	valueZ,
		const HistoID &	ID,
		const std::string &	title,
		const double	lowX,
		const double	highX,
		const double	lowY,
		const double	highY,
		const double	lowZ,
		const double	highZ,
		const unsigned long	binsX = 10,
		const unsigned long	binsY = 10,
		const unsigned long	binsZ = 10,
		const double	weight = 1.0
	)			const [inline]

fill the 3D histogram with forced ID assignment (book on demand)

     const double X = ... ;
     const double Y = ... ;
     const double Z = ... ;
     plot3D( X, Y, Z,
            15 , "Space Points" ,
             2.5 ,3.5, 4.5, 5.5, 6.5, 7.5, 10, 20, 30 );

This example illustrates the filling of the 3D histogram ID=15 titled "Space Points" with values X, Y and Z.

If the histogram with given title does not exist yet it will be automatically booked with parameters lowX equal to 2.5, highX equal to 3.5, lowY equal to 4.5, highY equal to 5.5, lowZ equal to 6.5, highZ equal to 7.5, binsX equal to 10, binsY equal to 20 and binsZ equal to 30.

It is also possible to use literal IDs. For example :-

     const double X = ... ;
     const double Y = ... ;
     const double Z = ... ;
     plot3D( X, Y, Z,
            "space", "Space Points" ,
              2.5 ,3.5, 4.5, 5.5, 6.5, 7.5, 10, 20, 30 );

Will book the same histogram, using the id "space".

It is also possible using literal IDs, to place histograms in sub-directories from the main histogram directory, using for example :-

     const double X = ... ;
     const double Y = ... ;
     const double Z = ... ;
     plot3D( X, Y, Z,
             "subdir/space", "Space Points" ,
             2.5 ,3.5, 4.5, 5.5, 6.5, 7.5, 10, 20, 30 );

Which will create the histogram "space" in the sub-directory "subdir". Histograms can also be created in sub-directories with numeric IDs if IDs such as "subdir/1" are used.

Attention:

If the histogram with given ID is already booked through automatic assignment of histogram ID, the error will not be detected. Therefore it is recommended to use non-trivial histogram ID offset (property "HistoOffSet") if one need to combine these techniques together It is still desirable to use the unique histogram title to avoid a bad interference

See also:

AIDA::IHistogram3D

Parameters:

	valueX	x value to be filled
	valueY	y value to be filled
	valueZ	z value to be filled
	ID	Histogram ID to use
	title	histogram title (must be unique within the algorithm)
	lowX	low x limit for histogram
	highX	high x limit for histogram
	lowY	low y limit for histogram
	highY	high y limit for histogram
	lowZ	low z limit for histogram
	highZ	high z limit for histogram
	binsX	number of bins in x
	binsY	number of bins in y
	binsZ	number of bins in z
	weight	weight

Returns:

pointer to AIDA 3D histogram

Reimplemented in HistoTool.

Definition at line 198 of file GaudiHistos_3DFixedBinning.icpp.

{
  AIDA::IHistogram3D * h(0);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = histo3D ( ID ) ;
    if ( 0 == h ) { h = book3D ( ID , title ,
                                 lowX , highX , binsX ,
                                 lowY , highY , binsY ,
                                 lowZ , highZ , binsZ ) ; }
    // fill the histogram
    h = fill ( h , valueX , valueY , valueZ , weight , title ) ;
  }
  return h;
}

template<class PBASE>

AIDA::IHistogram3D * GaudiHistos< PBASE >::plot3D	(	const double	valueX,
		const double	valueY,
		const double	valueZ,
		const std::string &	title,
		const HistoBinEdges &	edgesX,
		const HistoBinEdges &	edgesY,
		const HistoBinEdges &	edgesZ,
		const double	weight = 1.0
	)			const [inline]

Fill the 3D variable binning histogram (book on demand).

     const GaudiAlg::HistoBinEdges edgesX = ...;
     const GaudiAlg::HistoBinEdges edgesY = ...;
     const GaudiAlg::HistoBinEdges edgesZ = ...;
     const double X = ... ;
     const double Y = ... ;
     const double Z = ... ;
     plot3D( X, Y, Z, "Space Points", edgesX, edgesY, edgesZ );

This example illustrates the filling of the 3D histogram titled "Space Points" with values X, Y and Z.

If the histogram with given title does not exist yet it will be automatically booked with the given histogram bin edges.

Attention:

The histogram will get a unique identifier automatically assigned which by default will be equal to the histogram title. An option exists to instead use numerical IDs. In this case the first histogram booked will be ID=1 the next ID=2 and so on. Note though this scheme is not recommended as it does NOT guarantee predictability of the ID a given histogram will be given when filled under conditional statements, since in these circumstances the order in which the histograms are first filled, and thus booked, will depend on the nature of the first few events read. This is particularly problematic when users submit many parallel 'sub-jobs' and then attempt to merge the final output ROOT (or HBOOK) files, since a given histogram could have different IDs in each of the sub-jobs. Consequently it is strongly recommended that users do not use numerical automatic IDs unless they are sure they understand what they are doing.

See also:

AIDA::IHistogram3D

Parameters:

	valueX	x value to be filled
	valueY	y value to be filled
	valueZ	z value to be filled
	title	histogram title (must be unique within the algorithm)
	edgesX	The histogram x bin edges
	edgesY	The histogram y bin edges
	edgesZ	The histogram z bin edges
	weight	weight

Returns:

pointer to AIDA 3D histogram

Definition at line 102 of file GaudiHistos_3DVariableBinning.icpp.

{
  AIDA::IHistogram3D * h(NULL);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = histo3D ( title ) ;
    if ( NULL == h ) { h = book3D ( title , edgesX , edgesY , edgesZ ) ; }
    // fill the histogram
    h = fill ( h , valueX , valueY , valueZ , weight , title );
  }
  return h;
}

template<class PBASE>

AIDA::IHistogram3D * GaudiHistos< PBASE >::plot3D	(	const double	valueX,
		const double	valueY,
		const double	valueZ,
		const HistoID &	ID,
		const std::string &	title,
		const HistoBinEdges &	edgesX,
		const HistoBinEdges &	edgesY,
		const HistoBinEdges &	edgesZ,
		const double	weight = 1.0
	)			const [inline]

fill the 3D histogram with forced ID assignment (book on demand)

     const GaudiAlg::HistoBinEdges edgesX = ...;
     const GaudiAlg::HistoBinEdges edgesY = ...;
     const GaudiAlg::HistoBinEdges edgesZ = ...;
     const double X = ... ;
     const double Y = ... ;
     const double Z = ... ;
     plot3D( X, Y, Z, "Space Points", edgesX, edgesY, edgesZ );

This example illustrates the filling of the 3D histogram ID=15 titled "Space Points" with values X, Y and Z.

If the histogram with given title does not exist yet it will be automatically booked with the given histogram bin edges and histogram ID.

It is also possible to use literal IDs. For example :-

     const GaudiAlg::HistoBinEdges edgesX = ...;
     const GaudiAlg::HistoBinEdges edgesY = ...;
     const GaudiAlg::HistoBinEdges edgesZ = ...;
     const double X = ... ;
     const double Y = ... ;
     const double Z = ... ;
     plot3D( X, Y, Z,
             "space", "Space Points" ,
             edgesX, edgesY, edgesZ );

Will book the same histogram, using the id "space".

It is also possible using literal IDs, to place histograms in sub-directories from the main histogram directory, using for example :-

     const GaudiAlg::HistoBinEdges edgesX = ...;
     const GaudiAlg::HistoBinEdges edgesY = ...;
     const GaudiAlg::HistoBinEdges edgesZ = ...;
     const double X = ... ;
     const double Y = ... ;
     const double Z = ... ;
     plot3D( X, Y, Z,
             "subdir/space", "Space Points" ,
             edgesX, edgesY, edgesZ );

Which will create the histogram "space" in the sub-directory "subdir". Histograms can also be created in sub-directories with numeric IDs if IDs such as "subdir/1" are used.

Attention:

If the histogram with given ID is already booked through automatic assignment of histogram ID, the error will not be detected. Therefore it is recommended to use non-trivial histogram ID offset (property "HistoOffSet") if one need to combine these techniques together It is still desirable to use the unique histogram title to avoid a bad interference

See also:

AIDA::IHistogram3D

Parameters:

	valueX	x value to be filled
	valueY	y value to be filled
	valueZ	z value to be filled
	ID	Histogram ID to use
	title	histogram title (must be unique within the algorithm)
	edgesX	The histogram x bin edges
	edgesY	The histogram y bin edges
	edgesZ	The histogram z bin edges
	weight	weight

Returns:

pointer to AIDA 3D histogram

Definition at line 128 of file GaudiHistos_3DVariableBinning.icpp.

{
  AIDA::IHistogram3D * h(NULL);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = histo3D ( ID ) ;
    if ( NULL == h ) {  h = book3D ( ID , title , edgesX , edgesY , edgesZ ) ; }
    // fill
    h = fill ( h , valueX , valueY , valueZ , weight , title ) ;
  }
  return h;
}

template<class PBASE>

AIDA::IProfile1D * GaudiHistos< PBASE >::profile1D	(	const double	valueX,
		const double	valueY,
		const std::string &	title,
		const double	lowX,
		const double	highX,
		const unsigned long	binsX = 100,
		const std::string &	opt = "",
		const double	lowY = -std::numeric_limits<double>::max(),
		const double	highY = std::numeric_limits<double>::max(),
		const double	weight = 1.0
	)			const [inline]

fill the 1D profile histogram (book on demand)

     const double mass1 = ... ;
     const double mass2 = ... ;
     profile1D( mass1, mass2, "Invariant Mass2 versus Mass1" ,2.5 ,3.5, 100 );

This example illustrates the filling of the 1D profile histogram titled "Invariant Mass2 versus Mass1" with values mass1 and mass2 .

If the histogram with given title does not exist yet it will be automatically booked with parameters lowX equal to 2.5, highX equal to 3.5, binsX equal to 100

Attention:

The histogram will get a unique identifier automatically assigned which by default will be equal to the histogram title. An option exists to instead use numerical IDs. In this case the first histogram booked will be ID=1 the next ID=2 and so on. Note though this scheme is not recommended as it does NOT guarantee predictability of the ID a given histogram will be given when filled under conditional statements, since in these circumstances the order in which the histograms are first filled, and thus booked, will depend on the nature of the first few events read. This is particularly problematic when users submit many parallel 'sub-jobs' and then attempt to merge the final output ROOT (or HBOOK) files, since a given histogram could have different IDs in each of the sub-jobs. Consequently it is strongly recommended that users do not use numerical automatic IDs unless they are sure they understand what they are doing.

See also:

AIDA::IProfile1D

Parameters:

	valueX	x value to be filled
	valueY	y value to be filled
	title	histogram title (must be unique within the algorithm)
	lowX	low x limit for histogram
	highX	high x limit for histogram
	binsX	number of bins in x
	opt	the options, used for evaluation of errors
	lowY	the min cut-off for y-values
	highY	the max cut-off for y-values
	weight	weight

Returns:

pointer to AIDA 1D profile histogram

Definition at line 145 of file GaudiHistos_1DProfFixedBinning.icpp.

{
  AIDA::IProfile1D * h(NULL);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = profile1D ( title ) ;
    if ( NULL == h )
    { h = bookProfile1D ( title , lowX , highX , binsX , opt , lowY , highY ) ; }
    // fill the histogram
    h = fill ( h , valueX , valueY , weight , title ) ;
  }
  return h;
}

template<class PBASE>

AIDA::IProfile1D * GaudiHistos< PBASE >::profile1D	(	const double	valueX,
		const double	valueY,
		const HistoID &	ID,
		const std::string &	title,
		const double	lowX,
		const double	highX,
		const unsigned long	binsX = 100,
		const std::string &	opt = "",
		const double	lowY = -std::numeric_limits<double>::max(),
		const double	highY = std::numeric_limits<double>::max(),
		const double	weight = 1.0
	)			const [inline]

fill the 1D profile histogram with forced ID assignment (book on demand)

     const double mass1 = ... ;
     const double mass2 = ... ;
     profile1D( mass1, mass2,
             15, "Invariant Mass2 versus Mass1" ,2.5 ,3.5, 100 );

This example illustrates the filling of the 1D profile histogram with ID=15 titled "Invariant Mass2 versus Mass1" with values mass1 and mass2 .

If the histogram with given title does not exist yet it will be automatically booked with parameters lowX equal to 2.5, highX equal to 3.5, binsX equal to 100

It is also possible to use literal IDs. For example :-

     const double mass1 = ... ;
     const double mass2 = ... ;
     profile1D( mass1, mass2,
             "mass", "Invariant Mass2 versus Mass1" ,2.5 ,3.5, 100 );

Will book the same histogram, using the id "mass".

It is also possible using literal IDs, to place histograms in sub-directories from the main histogram directory, using for example :-

     const double mass1 = ... ;
     const double mass2 = ... ;
     profile1D( mass1, mass2,
        "subdir/mass", "Invariant Mass2 versus Mass1" ,2.5 ,3.5, 100 );

Which will create the histogram "mass" in the sub-directory "subdir". Histograms can also be created in sub-directories with numeric IDs if IDs such as "subdir/1" are used.

See also:

AIDA::IProfile1D

Parameters:

	valueX	x value to be filled
	valueY	y value to be filled
	ID	histogram identifier
	title	histogram title (must be unique within the algorithm)
	lowX	low x limit for histogram
	highX	high x limit for histogram
	binsX	number of bins in x
	opt	the options, used for evaluation of errors
	lowY	the min cut-off for y-values
	highY	the max cut-off for y-values
	weight	weight

Returns:

pointer to AIDA 1D profile histogram

Definition at line 173 of file GaudiHistos_1DProfFixedBinning.icpp.

{
  AIDA::IProfile1D * h(NULL);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = profile1D ( ID ) ;
    if ( NULL == h )
    { h = bookProfile1D ( ID , title , lowX , highX , binsX , opt , lowY , highY ) ; }
    // fill the histogram
    h = fill ( h , valueX , valueY , weight , title ) ;
  }
  return h;
}

template<class PBASE>

AIDA::IProfile1D * GaudiHistos< PBASE >::profile1D	(	const double	valueX,
		const double	valueY,
		const std::string &	title,
		const HistoBinEdges &	edges,
		const double	weight = 1.0
	)			const [inline]

fill the 1D variable binning profile histogram (book on demand)

     const GaudiAlg::HistoBinEdges edges = ...;
     const double mass1 = ... ;
     const double mass2 = ... ;
     profile1D( mass1, mass2, "Invariant Mass2 versus Mass1", edges );

This example illustrates the filling of the 1D profile histogram titled "Invariant Mass2 versus Mass1" with values mass1 and mass2 .

If the histogram with given title does not exist yet it will be automatically booked with the given histogram bin edges.

Attention:

The histogram will get a unique identifier automatically assigned which by default will be equal to the histogram title. An option exists to instead use numerical IDs. In this case the first histogram booked will be ID=1 the next ID=2 and so on. Note though this scheme is not recommended as it does NOT guarantee predictability of the ID a given histogram will be given when filled under conditional statements, since in these circumstances the order in which the histograms are first filled, and thus booked, will depend on the nature of the first few events read. This is particularly problematic when users submit many parallel 'sub-jobs' and then attempt to merge the final output ROOT (or HBOOK) files, since a given histogram could have different IDs in each of the sub-jobs. Consequently it is strongly recommended that users do not use numerical automatic IDs unless they are sure they understand what they are doing.

See also:

AIDA::IProfile1D

Parameters:

	valueX	x value to be filled
	valueY	y value to be filled
	title	histogram title (must be unique within the algorithm)
	edges	The histogram bin edges
	weight	weight

Returns:

pointer to AIDA 1D profile histogram

Definition at line 92 of file GaudiHistos_1DProfVariableBinning.icpp.

{
  AIDA::IProfile1D * h(NULL);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = profile1D ( title ) ;
    if ( NULL == h )
    { h = bookProfile1D ( title , edges ) ; }
    // fill the histogram
    h = fill ( h , valueX , valueY , weight , title ) ;
  }
  return h;
}

template<class PBASE>

AIDA::IProfile1D * GaudiHistos< PBASE >::profile1D	(	const double	valueX,
		const double	valueY,
		const HistoID &	ID,
		const std::string &	title,
		const HistoBinEdges &	edges,
		const double	weight = 1.0
	)			const [inline]

fill the 1D variable binning profile histogram with forced ID assignment (book on demand)

     const GaudiAlg::HistoBinEdges edges = ...;
     const double mass1 = ... ;
     const double mass2 = ... ;
     profile1D( mass1, mass2,
             15, "Invariant Mass2 versus Mass1", edges );

This example illustrates the filling of the 1D profile histogram with ID=15 titled "Invariant Mass2 versus Mass1" with values mass1 and mass2 .

If the histogram with given ID does not exist yet it will be automatically booked with the given histogram bin edges.

It is also possible to use literal IDs. For example :-

     const GaudiAlg::HistoBinEdges edges = ...;
     const double mass1 = ... ;
     const double mass2 = ... ;
     profile1D( mass1, mass2,
             "mass", "Invariant Mass2 versus Mass1", edges );

Will book the same histogram, using the id "mass".

It is also possible using literal IDs, to place histograms in sub-directories from the main histogram directory, using for example :-

     const GaudiAlg::HistoBinEdges edges = ...;
     const double mass1 = ... ;
     const double mass2 = ... ;
     profile1D( mass1, mass2,
        "subdir/mass", "Invariant Mass2 versus Mass1", edges );

Which will create the histogram "mass" in the sub-directory "subdir". Histograms can also be created in sub-directories with numeric IDs if IDs such as "subdir/1" are used.

See also:

AIDA::IProfile1D

Parameters:

	valueX	x value to be filled
	valueY	y value to be filled
	ID	histogram identifier
	title	histogram title (must be unique within the algorithm)
	edges	The histogram bin edges
	weight	weight

Returns:

pointer to AIDA 1D profile histogram

Definition at line 115 of file GaudiHistos_1DProfVariableBinning.icpp.

{
  AIDA::IProfile1D * h(NULL);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = profile1D ( ID ) ;
    if ( NULL == h )
    { h = bookProfile1D ( ID , title , edges ) ; }
    // fill the histogram
    h = fill ( h , valueX , valueY , weight , title ) ;
  }
  return h;
}

template<class PBASE>

AIDA::IProfile2D * GaudiHistos< PBASE >::profile2D	(	const double	valueX,
		const double	valueY,
		const double	valueZ,
		const std::string &	title,
		const double	lowX,
		const double	highX,
		const double	lowY,
		const double	highY,
		const unsigned long	binsX = 50,
		const unsigned long	binsY = 50,
		const double	weight = 1.0
	)			const [inline]

fill the 2D profile histogram (book on demand)

     const double X = ... ;
     const double Y = ... ;
     const double Z = ... ;
     profile2( X, Y, Z, "Space Points" ,2.5 ,3.5, 4.5, 5.5, 10, 20 );

This example illustrates the filling of the 2D profile histogram titled "Space Points" with values X, Y and Z.

If the histogram with given title does not exist yet it will be automatically booked with parameters lowX equal to 2.5, highX equal to 3.5, lowY equal to 4.5, highY equal to 5.5, binsX equal to 10, binsY equal to 20.

Attention:

The histogram will get a unique identifier automatically assigned which by default will be equal to the histogram title. An option exists to instead use numerical IDs. In this case the first histogram booked will be ID=1 the next ID=2 and so on. Note though this scheme is not recommended as it does NOT guarantee predictability of the ID a given histogram will be given when filled under conditional statements, since in these circumstances the order in which the histograms are first filled, and thus booked, will depend on the nature of the first few events read. This is particularly problematic when users submit many parallel 'sub-jobs' and then attempt to merge the final output ROOT (or HBOOK) files, since a given histogram could have different IDs in each of the sub-jobs. Consequently it is strongly recommended that users do not use numerical automatic IDs unless they are sure they understand what they are doing.

See also:

AIDA::IProfile2D

Parameters:

	valueX	x value to be filled
	valueY	y value to be filled
	valueZ	z value to be filled
	title	histogram title (must be unique within the algorithm)
	lowX	low x limit for histogram
	highX	high x limit for histogram
	lowY	low y limit for histogram
	highY	high y limit for histogram
	binsX	number of bins in x
	binsY	number of bins in y
	weight	weight

Returns:

pointer to AIDA 2D profile histogram

Definition at line 148 of file GaudiHistos_2DProfFixedBinning.icpp.

{
  AIDA::IProfile2D * h(0);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = profile2D ( title ) ;
    if ( 0 == h ) { h = bookProfile2D ( title ,
                                        lowX , highX , binsX ,
                                        lowY , highY , binsY ) ; }
    // fill the histogram
    h = fill ( h , valueX , valueY , valueZ , weight , title ) ;
  }
  return h;
}

template<class PBASE>

AIDA::IProfile2D * GaudiHistos< PBASE >::profile2D	(	const double	valueX,
		const double	valueY,
		const double	valueZ,
		const HistoID &	ID,
		const std::string &	title,
		const double	lowX,
		const double	highX,
		const double	lowY,
		const double	highY,
		const unsigned long	binsX = 50,
		const unsigned long	binsY = 50,
		const double	weight = 1.0
	)			const [inline]

fill the 2D profile histogram with forced ID assignment (book on demand)

     const double X = ... ;
     const double Y = ... ;
     const double Z = ... ;
     profile2D( X, Y, Z, 15, "Space Points" ,2.5 ,3.5, 4.5, 5.5, 10, 20 );

This example illustrates the filling of the 2D profile histogram with ID=15 titled "Space Points" with values X, Y and Z.

If the histogram with given title does not exist yet it will be automatically booked with parameters lowX equal to 2.5, highX equal to 3.5, lowY equal to 4.5, highY equal to 5.5, binsX equal to 10, binsY equal to 20.

It is also possible to use literal IDs. For example :-

     const double X = ... ;
     const double Y = ... ;
     const double Z = ... ;
     profile2D( X, Y, Z, "space", "Space Points" ,2.5 ,3.5, 4.5, 5.5, 10, 20 );

Will book the same histogram, using the id "space".

It is also possible using literal IDs, to place histograms in sub-directories from the main histogram directory, using for example :-

     const double X = ... ;
     const double Y = ... ;
     const double Z = ... ;
     profile2D( X, Y, Z,
                "subdir/space", "Space Points" ,2.5 ,3.5, 4.5, 5.5, 10, 20 );

Which will create the histogram "space" in the sub-directory "subdir". Histograms can also be created in sub-directories with numeric IDs if IDs such as "subdir/1" are used.

See also:

AIDA::IProfile2D

Parameters:

	valueX	x value to be filled
	valueY	y value to be filled
	valueZ	z value to be filled
	ID	histogram identifier
	title	histogram title (must be unique within the algorithm)
	lowX	low x limit for histogram
	highX	high x limit for histogram
	lowY	low y limit for histogram
	highY	high y limit for histogram
	binsX	number of bins in x
	binsY	number of bins in y
	weight	weight

Returns:

pointer to AIDA 2D profile histogram

Definition at line 178 of file GaudiHistos_2DProfFixedBinning.icpp.

{
  AIDA::IProfile2D * h(0);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = profile2D ( ID ) ;
    if ( 0 == h ) { h = bookProfile2D ( ID , title ,
                                        lowX , highX , binsX ,
                                        lowY , highY , binsY ) ; }
    // fill the histogram
    h = fill ( h , valueX , valueY , valueZ , weight , title ) ;
  }
  return h;
}

template<class PBASE>

AIDA::IProfile2D * GaudiHistos< PBASE >::profile2D	(	const double	valueX,
		const double	valueY,
		const double	valueZ,
		const std::string &	title,
		const HistoBinEdges &	edgesX,
		const HistoBinEdges &	edgesY,
		const double	weight = 1.0
	)			const [inline]

fill the 2D variable binning profile histogram (book on demand)

     const GaudiAlg::HistoBinEdges edgesX = ...;
     const GaudiAlg::HistoBinEdges edgesY = ...;
     const double X = ... ;
     const double Y = ... ;
     const double Z = ... ;
     profile2D( X, Y, Z, "Space Points", edgesX, edgesY );

This example illustrates the filling of the 2D profile histogram titled "Space Points" with values X, Y and Z.

If the histogram with given title does not exist yet it will be automatically booked with the given histogram bin edges.

Attention:

The histogram will get a unique identifier automatically assigned which by default will be equal to the histogram title. An option exists to instead use numerical IDs. In this case the first histogram booked will be ID=1 the next ID=2 and so on. Note though this scheme is not recommended as it does NOT guarantee predictability of the ID a given histogram will be given when filled under conditional statements, since in these circumstances the order in which the histograms are first filled, and thus booked, will depend on the nature of the first few events read. This is particularly problematic when users submit many parallel 'sub-jobs' and then attempt to merge the final output ROOT (or HBOOK) files, since a given histogram could have different IDs in each of the sub-jobs. Consequently it is strongly recommended that users do not use numerical automatic IDs unless they are sure they understand what they are doing.

See also:

AIDA::IProfile2D

Parameters:

	valueX	x value to be filled
	valueY	y value to be filled
	valueZ	z value to be filled
	title	histogram title (must be unique within the algorithm)
	edgesX	The histogram x bin edges
	edgesY	The histogram x bin edges
	weight	weight

Returns:

pointer to AIDA 1D profile histogram

Definition at line 96 of file GaudiHistos_2DProfVariableBinning.icpp.

{
  AIDA::IProfile2D * h(NULL);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = profile2D ( title ) ;
    if ( NULL == h ) { h = bookProfile2D ( title, edgesX, edgesY ) ; }
    // fill the histogram
    h = fill ( h , valueX , valueY , valueZ , weight , title ) ;
  }
  return h;
}

template<class PBASE>

AIDA::IProfile2D * GaudiHistos< PBASE >::profile2D	(	const double	valueX,
		const double	valueY,
		const double	valueZ,
		const HistoID &	ID,
		const std::string &	title,
		const HistoBinEdges &	edgesX,
		const HistoBinEdges &	edgesY,
		const double	weight = 1.0
	)			const [inline]

fill the 2D variable binning profile histogram with forced ID assignment (book on demand)

     const GaudiAlg::HistoBinEdges edgesX = ...;
     const GaudiAlg::HistoBinEdges edgesY = ...;
     const double X = ... ;
     const double Y = ... ;
     const double Z = ... ;
     profile2( X, Y, Z, "Space Points", edgesX, edgesY );

This example illustrates the filling of the 2D profile histogram titled "Space Points" with values X, Y and Z.

If the histogram with given ID does not exist yet it will be automatically booked with the given histogram bin edges.

It is also possible to use literal IDs. For example :-

     const double X = ... ;
     const double Y = ... ;
     const double Z = ... ;
     profile2D( X, Y, Z, "space", "Space Points", edgesX, edgesY );

Will book the same histogram, using the id "mass".

It is also possible using literal IDs, to place histograms in sub-directories from the main histogram directory, using for example :-

     const double X = ... ;
     const double Y = ... ;
     const double Z = ... ;
     profile2D( X, Y, Z,
                "subdir/space", "Space Points", edgesX, edgesY );

Which will create the histogram "mass" in the sub-directory "subdir". Histograms can also be created in sub-directories with numeric IDs if IDs such as "subdir/1" are used.

See also:

AIDA::IProfile2D

Parameters:

	valueX	x value to be filled
	valueY	y value to be filled
	valueZ	z value to be filled
	ID	histogram identifier
	title	histogram title (must be unique within the algorithm)
	edgesX	The histogram x bin edges
	edgesY	The histogram y bin edges
	weight	weight

Returns:

pointer to AIDA 1D profile histogram

Definition at line 120 of file GaudiHistos_2DProfVariableBinning.icpp.

{
  AIDA::IProfile2D * h(NULL);
  if ( produceHistos() )
  {
    // retrieve or book the histogram
    h = profile2D ( ID ) ;
    if ( NULL == h ) { h = bookProfile2D ( ID , title , edgesX , edgesY ) ; }
                                        
    // fill the histogram
    h = fill ( h , valueX , valueY , valueZ , weight , title ) ;
  }
  return h;
}

template<class PBASE>

AIDA::IHistogram1D * GaudiHistos< PBASE >::book1D	(	const std::string &	title,
		const double	low = 0,
		const double	high = 100,
		const unsigned long	bins = 100
	)			const [inline]

book the 1D histogram

The histogram will be assigned a unique identifier

See also:

AIDA::IHistogram1D

Parameters:

	title	histogram title (must be unique within the algorithm)
	low	low limit for histogram
	high	high limit for histogram
	bins	number of bins

Returns:

pointer to AIDA 1D histogram

Reimplemented in HistoTool.

Definition at line 8 of file GaudiHistos_1DFixedBinning.icpp.

{
  // exist?
  AIDA::IHistogram1D* hist = histo1D ( title ) ;
  // histogram is already booked
  if( NULL != hist      )                    { return hist ; } // RETURN !!

  // propose the histogram ID
  HistoID ID;
  newHistoID( title, ID );

  // Create a new histogram and return
  return this -> book1D ( ID, title, low, high, bins );
}

template<class PBASE>

AIDA::IHistogram1D* GaudiHistos< PBASE >::book	(	const std::string &	title,
		const double	low = 0,
		const double	high = 100,
		const unsigned long	bins = 100
	)			const [inline]

book the 1D histogram

Wrapper method for the equivalent book1D method. Retained for backwards compatibility, please use book1D instead.

See also:

IHistogram1D

Parameters:

	title	histogram title (must be unique within the algorithm)
	low	low limit for histogram
	high	high limit for histogram
	bins	number of bins

Returns:

pointer to AIDA 1D histogram

Definition at line 2042 of file GaudiHistos.h.

  {
    return book1D( title, low, high, bins );
  }

template<class PBASE>

AIDA::IHistogram1D * GaudiHistos< PBASE >::book

(

const Gaudi::Histo1DDef &

hdef

)

const [inline]

book the 1D histogram

The histogram will be assigned a unique identifier

See also:

AIDA::IHistogram1D

Parameters:

hdef

histogram description/definition

Returns:

pointer to AIDA 1D histogram

Definition at line 183 of file GaudiHistos_1DFixedBinning.icpp.

{
  return book1D ( hdef.title    () ,
                  hdef.lowEdge  () ,
                  hdef.highEdge () ,
                  hdef.bins     () ) ;
}

template<class PBASE>

AIDA::IHistogram1D * GaudiHistos< PBASE >::book1D	(	const HistoID &	ID,
		const std::string &	title,
		const double	low = 0,
		const double	high = 100,
		const unsigned long	bins = 100
	)			const [inline]

book the 1D histogram with forced ID

See also:

IHistogram1D

Parameters:

	ID	unique histogram ID
	title	histogram title (must be unique within the algorithm)
	low	low limit for histogram
	high	high limit for histogram
	bins	number of bins

Returns:

pointer to AIDA histogram

Reimplemented in HistoTool.

Definition at line 30 of file GaudiHistos_1DFixedBinning.icpp.

{
  // Check ID
  if (ID.undefined())
  {
    this->Error("Undefined Histogram ID : Title='"+title+"'");
    return NULL;
  }

  // exist?
  AIDA::IHistogram1D* hist = histo1D ( ID ) ;
  // histogram is already booked
  if ( NULL != hist       )                  { return hist ; } // RETURN !!

  // Histogram title
  const std::string & htitle =
    ( title.empty() ? "Unnamed 1D Histogram ID="+ID.idAsString() : title ) ;

  // book the histogram
  if ( ID.numeric() )
  {
    hist = this->histoSvc() -> book ( histoPath()  ,
                                      ID.numericID() ,
                                      htitle       ,
                                      bins         ,
                                      low          ,
                                      high         ) ;
  }
  else if ( ID.literal() )
  {
    hist = this->histoSvc() -> book ( histoPath()+"/"+
                                      ID.literalID() ,
                                      htitle         ,
                                      bins           ,
                                      low            ,
                                      high         ) ;
  }

  // check OK
  if( NULL == hist )
  { this->Error( "IHistogram1D* points to NULL! ID='" + ID.idAsString() +
                 "' title='"+htitle+"'" ) ; return NULL; } // RETURN !!

  // add histogram into histogram storages
  if      ( ID.numeric() )
  { m_histo1DMapNumID [ ID.numericID() ] = hist ; }
  else if ( ID.literal() )
  { m_histo1DMapLitID [ ID.literalID() ] = hist ; }
  m_histo1DMapTitle [ title ] = hist ;

  // Declare to monitoring service
  monitorHisto( Gaudi::Utils::Histos::toBase ( hist ) , ID );

  // Printout and return
  if ( this->msgLevel(MSG::DEBUG) )
  { this->debug() << "Booked 1D Histogram : ID='" << ID
                  << "' Path=" << histoPath()
                  << " Title='"
                  << Gaudi::Utils::Histos::htitle ( hist )
                  << "'" << endmsg; }
  return hist ;
}

template<class PBASE>

AIDA::IHistogram1D* GaudiHistos< PBASE >::book	(	const HistoID &	ID,
		const std::string &	title,
		const double	low = 0,
		const double	high = 100,
		const unsigned long	bins = 100
	)			const [inline]

book the 1D histogram with forced ID

Wrapper method for the equivalent book1D method. Retained for backwards compatibility, please use book1D instead.

See also:

IHistogram1D

Parameters:

	ID	unique histogram ID
	title	histogram title (must be unique within the algorithm)
	low	low limit for histogram
	high	high limit for histogram
	bins	number of bins

Returns:

pointer to AIDA histogram

Definition at line 2092 of file GaudiHistos.h.

  {
    return book1D( ID, title, low, high, bins );
  }

template<class PBASE>

AIDA::IHistogram1D * GaudiHistos< PBASE >::book	(	const HistoID &	ID,
		const Gaudi::Histo1DDef &	hdef
	)			const [inline]

book the 1D histogram with forced ID

See also:

IHistogram1D

Parameters:

	ID	unique histogram ID
	hdef	histogram descriptor

Returns:

pointer to AIDA histogram

Definition at line 196 of file GaudiHistos_1DFixedBinning.icpp.

{
  return book1D ( ID               ,
                  hdef.title    () ,
                  hdef.lowEdge  () ,
                  hdef.highEdge () ,
                  hdef.bins     () ) ;
}

template<class PBASE>

AIDA::IHistogram1D * GaudiHistos< PBASE >::book1D	(	const std::string &	title,
		const HistoBinEdges &	edges
	)			const [inline]

book the 1D variable binning histogram

The histogram will be assigned a unique identifier

See also:

AIDA::IHistogram1D

Parameters:

	title	histogram title (must be unique within the algorithm)
	edges	The histogram bin edges

Returns:

pointer to AIDA 1D histogram

Definition at line 8 of file GaudiHistos_1DVariableBinning.icpp.

{
  // exist?
  AIDA::IHistogram1D* hist = histo1D ( title ) ;
  // histogram is already booked
  if( NULL != hist      )                      { return hist ; } // RETURN !!

  // propose the histogram ID
  HistoID ID;
  newHistoID( title, ID );

  // Create a new histogram and return
  return this -> book1D ( ID, title, edges );
}

template<class PBASE>

AIDA::IHistogram1D * GaudiHistos< PBASE >::book1D	(	const HistoID &	ID,
		const std::string &	title,
		const HistoBinEdges &	edges
	)			const [inline]

book the 1D variable binning histogram with given ID

See also:

AIDA::IHistogram1D

Parameters:

	ID	unique histogram ID
	title	histogram title (must be unique within the algorithm)
	edges	The histogram bin edges

Returns:

pointer to AIDA 1D histogram

Definition at line 28 of file GaudiHistos_1DVariableBinning.icpp.

{
  // Check ID
  if (ID.undefined())
  {
    this->Error("Undefined Histogram ID : Title='"+title+"'");
    return NULL;
  }

  // exist?
  AIDA::IHistogram1D* hist = histo1D ( ID ) ;
  // histogram is already booked
  if ( NULL != hist       )                    { return hist ; } // RETURN !!

  // Histogram title
  const std::string & htitle =
    ( title.empty() ? "Unnamed 1D Histogram ID="+ID.idAsString() : title ) ;

  // book the histogram
  if ( ID.numeric() )
  {
    hist = this->histoSvc() -> book ( histoPath()  ,
                                      ID.numericID() ,
                                      htitle       ,
                                      edges     ) ;
  }
  else if ( ID.literal() )
  {
    hist = this->histoSvc() -> book ( histoPath()+"/"+
                                      ID.literalID() ,
                                      htitle         ,
                                      edges        ) ;
  }

  // check OK
  if( NULL == hist )
  { this->Error( "IHistogram1D* points to NULL! ID='" + ID.idAsString() +
                 "' title='"+htitle+"'" ) ; return NULL; } // RETURN !!

  // add histogram into histogram storages
  if      ( ID.numeric() )
  { m_histo1DMapNumID [ ID.numericID() ] = hist ; }
  else if ( ID.literal() )
  { m_histo1DMapLitID [ ID.literalID() ] = hist ; }
  m_histo1DMapTitle [ title ] = hist ;

  // Declare to monitoring service
  monitorHisto( Gaudi::Utils::Histos::toBase ( hist ) , ID );

  // Printout and return
  if ( this->msgLevel(MSG::DEBUG) )
  { this->debug() << "Booked 1D Histogram : ID='" << ID
                  << "' Path=" << histoPath()
                  << " Title='"
                  << Gaudi::Utils::Histos::htitle ( hist )
                  << "'" << endmsg; }
  return hist ;
}

template<class PBASE>

AIDA::IHistogram2D * GaudiHistos< PBASE >::book2D	(	const std::string &	title,
		const double	lowX = 0,
		const double	highX = 100,
		const unsigned long	binsX = 50,
		const double	lowY = 0,
		const double	highY = 100,
		const unsigned long	binsY = 50
	)			const [inline]

book the 2D histogram

The histogram will be assigned a unique identifier

See also:

IHistogram2D

Parameters:

	title	histogram title (must be unique within the algorithm)
	lowX	low x limit for histogram
	highX	high x limit for histogram
	binsX	number of bins in x
	lowY	low y limit for histogram
	highY	high y limit for histogram
	binsY	number of bins in y

Returns:

pointer to AIDA 2D histogram

Reimplemented in HistoTool.

Definition at line 8 of file GaudiHistos_2DFixedBinning.icpp.

{
  // exist?
  AIDA::IHistogram2D* hist = histo2D ( title ) ;
  // histogram is already booked
  if( NULL != hist      )                { return hist ; } // RETURN !!

  // propose the histogram ID
  HistoID ID;
  newHistoID( title, ID );

  // Create a new histogram and return
  return this -> book2D ( ID, title, lowX, highX, binsX, lowY, highY, binsY );
}

template<class PBASE>

AIDA::IHistogram2D * GaudiHistos< PBASE >::book2D	(	const HistoID &	ID,
		const std::string &	title,
		const double	lowX = 0,
		const double	highX = 100,
		const unsigned long	binsX = 50,
		const double	lowY = 0,
		const double	highY = 100,
		const unsigned long	binsY = 50
	)			const [inline]

book the 2D histogram with forced ID

See also:

IHistogram2D

Parameters:

	ID	unique histogram ID
	title	histogram title (must be unique within the algorithm)
	low	low limit for histogram
	high	high limit for histogram
	bins	number of bins

Returns:

pointer to AIDA histogram

Reimplemented in HistoTool.

Definition at line 33 of file GaudiHistos_2DFixedBinning.icpp.

{
  // Check ID
  if (ID.undefined())
  {
    this->Error("Undefined Histogram ID : Title='"+title+"'");
    return NULL;
  }

  // exist?
  AIDA::IHistogram2D* hist = histo2D( ID ) ;
  // histogram is already booked
  if( NULL != hist       )                  { return hist ; } // RETURN !!

  // Histogram title
  const std::string & htitle =
    ( title.empty() ? "Unnamed 2D Histogram ID="+ID.idAsString() : title ) ;

  // book the histogram
  if ( ID.numeric() )
  {
    hist = this->histoSvc() -> book ( histoPath()  ,
                                      ID.numericID() ,
                                      htitle       ,
                                      binsX        ,
                                      lowX         ,
                                      highX        ,
                                      binsY        ,
                                      lowY         ,
                                      highY        ) ;
  }
  else if ( ID.literal() )
  {
    hist = this->histoSvc() -> book ( histoPath()+"/"+
                                      ID.literalID() ,
                                      htitle       ,
                                      binsX        ,
                                      lowX         ,
                                      highX        ,
                                      binsY        ,
                                      lowY         ,
                                      highY        ) ;
  }

  // Check OK
  if( NULL == hist )
  { this->Error( "IHistogram2D* points to NULL! ID='" + ID.idAsString() +
                 "' title='"+htitle+"'" ) ; return NULL; } // RETURN !!

  // add histogram into histogram storages
  if      ( ID.numeric() )
  { m_histo2DMapNumID [ ID.numericID() ] = hist ; }
  else if ( ID.literal() )
  { m_histo2DMapLitID [ ID.literalID() ] = hist ; }
  m_histo2DMapTitle [ title ] = hist ;

  // Declare to monitoring service
  monitorHisto( Gaudi::Utils::Histos::toBase ( hist) , ID );

  // Printout and return
  if ( this->msgLevel(MSG::DEBUG) )
  { this->debug() << "Booked 2D Histogram : ID='"
                  << ID << "' Path=" << histoPath()
                  << " Title='"
                  << Gaudi::Utils::Histos::htitle ( hist )
                  << "'" << endmsg; }
  // return
  return hist ;
}

template<class PBASE>

AIDA::IHistogram2D * GaudiHistos< PBASE >::book2D	(	const std::string &	title,
		const HistoBinEdges &	edgesX,
		const HistoBinEdges &	edgesY
	)			const [inline]

book the 2D variable binning histogram

The histogram will be assigned a unique identifier

See also:

AIDA::IHistogram2D

Parameters:

	title	histogram title (must be unique within the algorithm)
	edgesX	The histogram x bin edges
	edgesY	The histogram y bin edges

Returns:

pointer to AIDA 2D histogram

Definition at line 8 of file GaudiHistos_2DVariableBinning.icpp.

{
  // exist?
  AIDA::IHistogram2D * hist = histo2D ( title ) ;
  // histogram is already booked
  if ( NULL != hist      )                  { return hist ; } // RETURN !!

  // propose the histogram ID
  HistoID ID;
  newHistoID( title, ID );

  // Create a new histogram and return
  return this -> book2D ( ID, title, edgesX, edgesY );
}

template<class PBASE>

AIDA::IHistogram2D * GaudiHistos< PBASE >::book2D	(	const HistoID &	ID,
		const std::string &	title,
		const HistoBinEdges &	edgesX,
		const HistoBinEdges &	edgesY
	)			const [inline]

book the 2D variable binning histogram with given ID

See also:

AIDA::IHistogram2D

Parameters:

	ID	unique histogram ID
	title	histogram title (must be unique within the algorithm)
	edgesX	The histogram x bin edges
	edgesY	The histogram y bin edges

Returns:

pointer to AIDA 2D histogram

Definition at line 29 of file GaudiHistos_2DVariableBinning.icpp.

{
  // Check ID
  if (ID.undefined())
  {
    this->Error("Undefined Histogram ID : Title='"+title+"'");
    return NULL;
  }

  // exist?
  AIDA::IHistogram2D * hist = histo2D ( ID ) ;
  // histogram is already booked
  if ( NULL != hist       )                 { return hist ; } // RETURN !!

  // Histogram title
  const std::string & htitle =
    ( title.empty() ? "Unnamed 2D Histogram ID="+ID.idAsString() : title ) ;

  // book the histogram
  if ( ID.numeric() )
  {
    hist = this->histoSvc() -> book ( histoPath()  ,
                                      ID.numericID() ,
                                      htitle       ,
                                      edgesX       , 
                                      edgesY       ) ;
  }
  else if ( ID.literal() )
  {
    hist = this->histoSvc() -> book ( histoPath()+"/"+
                                      ID.literalID() ,
                                      htitle         ,
                                      edgesX         ,
                                      edgesY         ) ;
  }

  // check OK
  if( NULL == hist )
  { this->Error( "IHistogram2D* points to NULL! ID='" + ID.idAsString() +
                 "' title='"+htitle+"'" ) ; return NULL; } // RETURN !!

  // add histogram into histogram storages
  if      ( ID.numeric() )
  { m_histo2DMapNumID [ ID.numericID() ] = hist ; }
  else if ( ID.literal() )
  { m_histo2DMapLitID [ ID.literalID() ] = hist ; }
  m_histo2DMapTitle [ title ] = hist ;

  // Declare to monitoring service
  monitorHisto( Gaudi::Utils::Histos::toBase ( hist ) , ID );

  // Printout and return
  if ( this->msgLevel(MSG::DEBUG) )
  { this->debug() << "Booked 2D Histogram : ID='" << ID
                  << "' Path=" << histoPath()
                  << " Title='"
                  << Gaudi::Utils::Histos::htitle ( hist )
                  << "'" << endmsg; }
  return hist ;
}

template<class PBASE>

AIDA::IHistogram3D * GaudiHistos< PBASE >::book3D	(	const std::string &	title,
		const double	lowX = 0,
		const double	highX = 100,
		const unsigned long	binsX = 10,
		const double	lowY = 0,
		const double	highY = 100,
		const unsigned long	binsY = 10,
		const double	lowZ = 0,
		const double	highZ = 100,
		const unsigned long	binsZ = 10
	)			const [inline]

book the 3D histogram

The histogram will be assigned a unique identifier

See also:

IHistogram3D

Parameters:

	title	histogram title (must be unique within the algorithm)
	lowX	low x limit for histogram
	highX	high x limit for histogram
	binsX	number of bins in x
	lowY	low y limit for histogram
	highY	high y limit for histogram
	binsY	number of bins in y
	lowZ	low y limit for histogram
	highZ	high y limit for histogram
	binsZ	number of bins in y

Returns:

pointer to AIDA 3D histogram

Reimplemented in HistoTool.

Definition at line 8 of file GaudiHistos_3DFixedBinning.icpp.

{
  // exist?
  AIDA::IHistogram3D* hist = histo3D ( title ) ;
  // histogram is already booked
  if( 0 != hist      )                           { return hist ; } // RETURN !!

  // propose the histogram ID
  HistoID ID;
  newHistoID( title, ID );

  // Create a new histogram and return
  return this -> book3D ( ID, title,
                          lowX, highX, binsX,
                          lowY, highY, binsY,
                          lowZ, highZ, binsZ );
}

template<class PBASE>

AIDA::IHistogram3D * GaudiHistos< PBASE >::book3D	(	const HistoID &	ID,
		const std::string &	title,
		const double	lowX = 0,
		const double	highX = 100,
		const unsigned long	binsX = 10,
		const double	lowY = 0,
		const double	highY = 100,
		const unsigned long	binsY = 10,
		const double	lowZ = 0,
		const double	highZ = 100,
		const unsigned long	binsZ = 10
	)			const [inline]

book the 3D histogram with forced ID

See also:

IHistogram3D

Parameters:

	ID	unique histogram ID
	title	histogram title (must be unique within the algorithm)
	lowX	low x limit for histogram
	highX	high x limit for histogram
	binsX	number of bins in x
	lowY	low y limit for histogram
	highY	high y limit for histogram
	binsY	number of bins in y
	lowZ	low y limit for histogram
	highZ	high y limit for histogram
	binsZ	number of bins in y

Returns:

pointer to AIDA 3D histogram

Reimplemented in HistoTool.

Definition at line 39 of file GaudiHistos_3DFixedBinning.icpp.

{
  // Check ID
  if (ID.undefined())
  {
    this->Error("Undefined Histogram ID : Title='"+title+"'");
    return NULL;
  }

  // exist?
  AIDA::IHistogram3D* hist = histo3D( ID ) ;
  // histogram is already booked
  if( 0 != hist       )                        { return hist ; } // RETURN !!

  // Histogram title
  const std::string & htitle =
    ( title.empty() ? "Unnamed 3D Histogram ID="+ID.idAsString() : title ) ;

  // book the histogram
  if ( ID.numeric() )
  {
    hist = this->histoSvc() -> book ( histoPath()  ,
                                      ID.numericID() ,
                                      htitle       ,
                                      binsX        ,
                                      lowX         ,
                                      highX        ,
                                      binsY        ,
                                      lowY         ,
                                      highY        ,
                                      binsZ        ,
                                      lowZ         ,
                                      highZ        ) ;
  }
  else if ( ID.literal() )
  {
    hist = this->histoSvc() -> book ( histoPath()+"/"+
                                      ID.literalID() ,
                                      htitle       ,
                                      binsX        ,
                                      lowX         ,
                                      highX        ,
                                      binsY        ,
                                      lowY         ,
                                      highY        ,
                                      binsZ        ,
                                      lowZ         ,
                                      highZ        ) ;
  }

  // Check OK
  if( 0 == hist )
  { this->Error( "IHistogram3D* points to NULL! ID='" + ID.idAsString() +
                 "' title='"+htitle+"'" ) ; return 0; } // RETURN !!

  // add histogram into histogram storages
  if      ( ID.numeric() )
  { m_histo3DMapNumID [ ID.numericID() ] = hist ; }
  else if ( ID.literal() )
  { m_histo3DMapLitID [ ID.literalID() ] = hist ; }
  m_histo3DMapTitle [ title ] = hist ;

  // Declare to monitoring service
  monitorHisto( Gaudi::Utils::Histos::toBase ( hist ) , ID );

  // Printout and return
  if ( this->msgLevel(MSG::DEBUG) )
  { this->debug() << "Booked 3D Histogram : ID='"
                  << ID << "' Path=" << histoPath()
                  << " Title='"
                  << Gaudi::Utils::Histos::htitle ( hist )
                  << "'" << endmsg; }
  return hist ;
}

template<class PBASE>

AIDA::IHistogram3D * GaudiHistos< PBASE >::book3D	(	const std::string &	title,
		const HistoBinEdges &	edgesX,
		const HistoBinEdges &	edgesY,
		const HistoBinEdges &	edgesZ
	)			const [inline]

book the 3D variable binning histogram

The histogram will be assigned a unique identifier

See also:

AIDA::IHistogram3D

Parameters:

	title	histogram title (must be unique within the algorithm)
	edgesX	The histogram x bin edges
	edgesY	The histogram y bin edges
	edgesZ	The histogram z bin edges

Returns:

pointer to AIDA 3D histogram

Definition at line 8 of file GaudiHistos_3DVariableBinning.icpp.

{
  // exist?
  AIDA::IHistogram3D * hist = histo3D ( title ) ;
  // histogram is already booked
  if( NULL != hist      )                   { return hist ; } // RETURN !!

  // propose the histogram ID
  HistoID ID;
  newHistoID( title, ID );

  // Create a new histogram and return
  return this -> book3D ( ID, title, edgesX, edgesY, edgesZ );
}

template<class PBASE>

AIDA::IHistogram3D * GaudiHistos< PBASE >::book3D	(	const HistoID &	ID,
		const std::string &	title,
		const HistoBinEdges &	edgesX,
		const HistoBinEdges &	edgesY,
		const HistoBinEdges &	edgesZ
	)			const [inline]

book the 3D variable binning histogram with given ID

See also:

AIDA::IHistogram3D

Parameters:

	ID	unique histogram ID
	title	histogram title (must be unique within the algorithm)
	edgesX	The histogram x bin edges
	edgesY	The histogram y bin edges
	edgesZ	The histogram z bin edges

Returns:

pointer to AIDA 3D histogram

Definition at line 30 of file GaudiHistos_3DVariableBinning.icpp.

{
  // Check ID
  if (ID.undefined())
  {
    this->Error("Undefined Histogram ID : Title='"+title+"'");
    return NULL;
  }

  // exist?
  AIDA::IHistogram3D * hist = histo3D ( ID ) ;
  // histogram is already booked
  if ( NULL != hist       )                 { return hist ; } // RETURN !!

  // Histogram title
  const std::string & htitle =
    ( title.empty() ? "Unnamed 3D Histogram ID="+ID.idAsString() : title ) ;

  // book the histogram
  if ( ID.numeric() )
  {
    hist = this->histoSvc() -> book ( histoPath()  ,
                                      ID.numericID() ,
                                      htitle       ,
                                      edgesX       , 
                                      edgesY       ,
                                      edgesZ       ) ;
  }
  else if ( ID.literal() )
  {
    hist = this->histoSvc() -> book ( histoPath()+"/"+
                                      ID.literalID() ,
                                      htitle         ,
                                      edgesX         ,
                                      edgesY         ,
                                      edgesZ         ) ;
  }

  // check OK
  if( NULL == hist )
  { this->Error( "IHistogram3D* points to NULL! ID='" + ID.idAsString() +
                 "' title='"+htitle+"'" ) ; return NULL; } // RETURN !!

  // add histogram into histogram storages
  if      ( ID.numeric() )
  { m_histo3DMapNumID [ ID.numericID() ] = hist ; }
  else if ( ID.literal() )
  { m_histo3DMapLitID [ ID.literalID() ] = hist ; }
  m_histo3DMapTitle [ title ] = hist ;

  // Declare to monitoring service
  monitorHisto( Gaudi::Utils::Histos::toBase ( hist ) , ID );

  // Printout and return
  if ( this->msgLevel(MSG::DEBUG) )
  { this->debug() << "Booked 3D Histogram : ID='" << ID
                  << "' Path=" << histoPath()
                  << " Title='"
                  << Gaudi::Utils::Histos::htitle ( hist )
                  << "'" << endmsg; }
  return hist ;
}

template<class PBASE>

AIDA::IProfile1D * GaudiHistos< PBASE >::bookProfile1D	(	const std::string &	title,
		const double	low = 0,
		const double	high = 100,
		const unsigned long	bins = 100,
		const std::string &	opt = "",
		const double	lowY = -std::numeric_limits<double>::max(),
		const double	highY = std::numeric_limits<double>::max()
	)			const [inline]

book the 1D profile histogram

The histogram will be assigned a unique identifier

See also:

IHistogram1D

Parameters:

	title	histogram title (must be unique within the algorithm)
	low	low limit for histogram
	high	high limit for histogram
	bins	number of bins
	opt	the options, used for evaluation of errors
	lowY	the min cut-off for y-values
	highY	the max cut-off for y-values

Returns:

pointer to AIDA 1D profile histogram

Definition at line 6 of file GaudiHistos_1DProfFixedBinning.icpp.

{
  // exist?
  AIDA::IProfile1D* hist = profile1D ( title ) ;
  // histogram is already booked
  if( NULL != hist      )                       { return hist ; } // RETURN !!

  // propose the histogram ID
  HistoID ID;
  newHistoID( title, ID );

  // Book the histo and return
  return this -> bookProfile1D ( ID, title, low, high, bins , opt , lowY , highY );
}

template<class PBASE>

AIDA::IProfile1D * GaudiHistos< PBASE >::bookProfile1D	(	const HistoID &	ID,
		const std::string &	title,
		const double	low = 0,
		const double	high = 100,
		const unsigned long	bins = 100,
		const std::string &	opt = "",
		const double	lowY = -std::numeric_limits<double>::max(),
		const double	highY = std::numeric_limits<double>::max()
	)			const [inline]

book the 1D profile histogram

The histogram will be assigned a unique identifier

See also:

IHistogram1D

Parameters:

	title	histogram title (must be unique within the algorithm)
	edges	The histogram bin edges
	low	low limit for histogram
	high	high limit for histogram
	bins	number of bins
	opt	the options, used for evaluation of errors
	lowY	the min cut-off for y-values
	highY	the max cut-off for y-values

Returns:

pointer to AIDA 1D profile histogram

Definition at line 31 of file GaudiHistos_1DProfFixedBinning.icpp.

{
  // Check ID
  if (ID.undefined())
  {
    this->Error("Undefined Histogram ID : Title='"+title+"'");
    return NULL;
  }

  // exist?
  AIDA::IProfile1D* hist = profile1D ( ID ) ;
  // histogram is already booked
  if( NULL != hist       )                  { return hist ; } // RETURN !!

  // Histogram title
  const std::string & htitle =
    ( title.empty() ?
      "Unnamed 1D Profile Histogram ID="+ID.idAsString() : title ) ;

  // book the histogram
  if ( ID.numeric() )
  {
    hist = this->histoSvc() -> bookProf ( histoPath()  ,
                                          ID.numericID() ,
                                          htitle       ,
                                          bins         ,
                                          low          ,
                                          high         ,
                                          lowY         ,
                                          highY        ,
                                          opt          ) ;
  }
  else if ( ID.literal() )
  {
    hist = this->histoSvc() -> bookProf ( histoPath()+"/"+
                                          ID.literalID() ,
                                          htitle       ,
                                          bins         ,
                                          low          ,
                                          high         ,
                                          lowY         ,
                                          highY        ,
                                          opt          ) ;
  }

  // test ok
  if( NULL == hist )
  { this->Error( "IProfile1D* points to NULL! ID='" + ID.idAsString() +
                 "' title='"+htitle+"'" ) ; return NULL; } // RETURN !!

  // add histogram into histogram storages
  if      ( ID.numeric() )
  { m_profile1DMapNumID [ ID.numericID() ] = hist ; }
  else if ( ID.literal() )
  { m_profile1DMapLitID [ ID.literalID() ] = hist ; }
  m_profile1DMapTitle [ title ] = hist ;

  // Declare to monitoring service
  monitorHisto( Gaudi::Utils::Histos::toBase ( hist ) , ID );

  // printout and return
  if ( this->msgLevel(MSG::DEBUG) )
  { this->debug() << "Booked 1D Profile Histogram : ID='"
                  << ID << "' Path=" << histoPath()
                  << " Title='"
                  << Gaudi::Utils::Histos::htitle ( hist )
                  << "'" << endmsg; }
  return hist ;
}

template<class PBASE>

AIDA::IProfile1D * GaudiHistos< PBASE >::bookProfile1D	(	const std::string &	title,
		const HistoBinEdges &	edges
	)			const [inline]

book the 1D profile histogram

The histogram will be assigned a unique identifier

See also:

IHistogram1D

Parameters:

	title	histogram title (must be unique within the algorithm)
	edges	The histogram bin edges

Returns:

pointer to AIDA 1D profile histogram

Definition at line 6 of file GaudiHistos_1DProfVariableBinning.icpp.

{
  // exist?
  AIDA::IProfile1D* hist = profile1D ( title ) ;
  // histogram is already booked
  if ( NULL != hist ) { return hist ; } // RETURN !!

  // propose the histogram ID
  HistoID ID;
  newHistoID( title, ID );

  // Book the histo and return
  return this -> bookProfile1D ( ID, title, edges );
}

template<class PBASE>

AIDA::IProfile1D * GaudiHistos< PBASE >::bookProfile1D	(	const HistoID &	ID,
		const std::string &	title,
		const HistoBinEdges &	edges
	)			const [inline]

book the 1D profile histogram

The histogram will be assigned a unique identifier

See also:

IHistogram1D

Parameters:

	title	histogram title (must be unique within the algorithm)
	edges	The histogram bin edges

Returns:

pointer to AIDA 1D profile histogram

Definition at line 26 of file GaudiHistos_1DProfVariableBinning.icpp.

{
  // Check ID
  if (ID.undefined())
  {
    this->Error("Undefined Histogram ID : Title='"+title+"'");
    return NULL;
  }

  // exist?
  AIDA::IProfile1D* hist = profile1D ( ID ) ;
  // histogram is already booked
  if ( NULL != hist ) { return hist ; } // RETURN !!

  // Histogram title
  const std::string & htitle =
    ( title.empty() ?
      "Unnamed 1D Profile Histogram ID="+ID.idAsString() : title ) ;

  // book the histogram
  if ( ID.numeric() )
  {
    hist = this->histoSvc() -> bookProf ( histoPath()    ,
                                          ID.numericID() ,
                                          htitle         ,
                                          edges          ) ;
  }
  else if ( ID.literal() )
  {
    hist = this->histoSvc() -> bookProf ( histoPath()+"/"+
                                          ID.literalID() ,
                                          htitle         ,
                                          edges          ) ;
  }

  // test ok
  if( NULL == hist )
  { this->Error( "IProfile1D* points to NULL! ID='" + ID.idAsString() +
                 "' title='"+htitle+"'" ) ; return NULL; } // RETURN !!

  // add histogram into histogram storages
  if      ( ID.numeric() )
  { m_profile1DMapNumID [ ID.numericID() ] = hist ; }
  else if ( ID.literal() )
  { m_profile1DMapLitID [ ID.literalID() ] = hist ; }
  m_profile1DMapTitle [ title ] = hist ;

  // Declare to monitoring service
  monitorHisto( Gaudi::Utils::Histos::toBase ( hist ) , ID );

  // printout and return
  if ( this->msgLevel(MSG::DEBUG) )
  { this->debug() << "Booked 1D Profile Histogram : ID='"
                  << ID << "' Path=" << histoPath()
                  << " Title='"
                  << Gaudi::Utils::Histos::htitle ( hist )
                  << "'" << endmsg; }
  return hist ;
}

template<class PBASE>

AIDA::IProfile2D * GaudiHistos< PBASE >::bookProfile2D	(	const std::string &	title,
		const double	lowX = 0,
		const double	highX = 100,
		const unsigned long	binsX = 50,
		const double	lowY = 0,
		const double	highY = 100,
		const unsigned long	binsY = 50
	)			const [inline]

book the 2D profile histogram

The histogram will be assigned a unique identifier

See also:

AIDA::IProfile2D

Parameters:

	title	histogram title (must be unique within the algorithm)
	lowX	low x limit for histogram
	highX	high x limit for histogram
	binsX	number of bins in x
	lowY	low y limit for histogram
	highY	high y limit for histogram
	binsY	number of bins in y

Returns:

pointer to AIDA 2D histogram

Definition at line 6 of file GaudiHistos_2DProfFixedBinning.icpp.

{
  // exist?
  AIDA::IProfile2D* hist = profile2D ( title ) ;
  // histogram is already booked
  if( 0 != hist      )                          { return hist ; } // RETURN !!

  // propose the histogram ID
  HistoID ID;
  newHistoID( title, ID );

  // book histogram and return
  return this -> bookProfile2D ( ID, title, lowX, highX, binsX, lowY, highY, binsY );
}

template<class PBASE>

AIDA::IProfile2D * GaudiHistos< PBASE >::bookProfile2D	(	const HistoID &	ID,
		const std::string &	title,
		const double	lowX = 0,
		const double	highX = 100,
		const unsigned long	binsX = 50,
		const double	lowY = 0,
		const double	highY = 100,
		const unsigned long	binsY = 50
	)			const [inline]

book the 2D profile histogram with forced ID

See also:

AIDA::IProfile2D

Parameters:

	ID	unique histogram ID
	title	histogram title (must be unique within the algorithm)
	lowX	low x limit for histogram
	highX	high x limit for histogram
	binsX	number of bins in x
	lowY	low y limit for histogram
	highY	high y limit for histogram
	binsY	number of bins in y

Returns:

pointer to AIDA histogram

Definition at line 31 of file GaudiHistos_2DProfFixedBinning.icpp.

{
  // Check ID
  if (ID.undefined())
  {
    this->Error("Undefined Histogram ID : Title='"+title+"'");
    return NULL;
  }

  // exist?
  AIDA::IProfile2D* hist = profile2D ( ID ) ;
  // histogram is already booked
  if( 0 != hist )                               { return hist ; } // RETURN !!

  // Histogram title
  const std::string & htitle =
    ( title.empty() ?
      "Unnamed 2D Profile Histogram ID="+ID.idAsString() : title ) ;

  // book the histogram
  if ( ID.numeric() )
  {
    hist = this->histoSvc() -> bookProf ( histoPath() ,
                                          ID.numericID() ,
                                          htitle      ,
                                          binsX       ,
                                          lowX        ,
                                          highX       ,
                                          binsY       ,
                                          lowY        ,
                                          highY        ) ;
  }
  else if ( ID.literal() )
  {
    hist = this->histoSvc() -> bookProf ( histoPath()+"/"+
                                          ID.literalID() ,
                                          htitle      ,
                                          binsX       ,
                                          lowX        ,
                                          highX       ,
                                          binsY       ,
                                          lowY        ,
                                          highY        ) ;
  }

  // test OK
  if( 0 == hist )
  { this->Error( "IProfile2D* points to NULL! ID='" + ID.idAsString() +
                 "' title='"+htitle+"'" ) ; return 0; } // RETURN !!

  // add histogram into histogram storages
  if      ( ID.numeric() )
  { m_profile2DMapNumID [ ID.numericID() ] = hist ; }
  else if ( ID.literal() )
  { m_profile2DMapLitID [ ID.literalID() ] = hist ; }
  m_profile2DMapTitle [ title ] = hist ;

  // Declare to monitoring service
  monitorHisto( Gaudi::Utils::Histos::toBase ( hist ) , ID );

  // printout and return
  if ( this->msgLevel(MSG::DEBUG) )
  {  this->debug() << "Booked 2D Profile Histogram : ID='" << ID
                   << "' Path=" << histoPath()
                   << " Title='"
                   << Gaudi::Utils::Histos::htitle ( hist )
                   << "'" << endmsg; }
  return hist ;
}

template<class PBASE>

AIDA::IProfile2D * GaudiHistos< PBASE >::bookProfile2D	(	const std::string &	title,
		const HistoBinEdges &	edgesX,
		const HistoBinEdges &	edgesY
	)			const [inline]

book the 2D profile histogram

The histogram will be assigned a unique identifier

See also:

AIDA::IProfile2D

Parameters:

	title	histogram title (must be unique within the algorithm)
	edgesX	x bin edges
	edgesY	y bin edges

Returns:

pointer to AIDA 2D histogram

Definition at line 6 of file GaudiHistos_2DProfVariableBinning.icpp.

{
  // exist?
  AIDA::IProfile2D* hist = profile2D ( title ) ;
  // histogram is already booked
  if( NULL != hist      )                     { return hist ; } // RETURN !!

  // propose the histogram ID
  HistoID ID;
  newHistoID( title, ID );

  // book histogram and return
  return this -> bookProfile2D ( ID, title, edgesX, edgesY );
}

template<class PBASE>

AIDA::IProfile2D * GaudiHistos< PBASE >::bookProfile2D	(	const HistoID &	ID,
		const std::string &	title,
		const HistoBinEdges &	edgesX,
		const HistoBinEdges &	edgesY
	)			const [inline]

book the 2D profile histogram with forced ID

See also:

AIDA::IProfile2D

Parameters:

	ID	unique histogram ID
	title	histogram title (must be unique within the algorithm)
	edgesX	x bin edges
	edgesY	y bin edges

Returns:

pointer to AIDA histogram

Definition at line 27 of file GaudiHistos_2DProfVariableBinning.icpp.

{
  // Check ID
  if (ID.undefined())
  {
    this->Error("Undefined Histogram ID : Title='"+title+"'");
    return NULL;
  }

  // exist?
  AIDA::IProfile2D* hist = profile2D ( ID ) ;
  // histogram is already booked
  if( NULL != hist )                         { return hist ; } // RETURN !!

  // Histogram title
  const std::string & htitle =
    ( title.empty() ?
      "Unnamed 2D Profile Histogram ID="+ID.idAsString() : title ) ;

  // book the histogram
  if ( ID.numeric() )
  {
    hist = this->histoSvc() -> bookProf ( histoPath() ,
                                          ID.numericID() ,
                                          htitle      ,
                                          edgesX      ,
                                          edgesY      ) ;
  }
  else if ( ID.literal() )
  {
    hist = this->histoSvc() -> bookProf ( histoPath()+"/"+
                                          ID.literalID() ,
                                          htitle      ,
                                          edgesX      ,
                                          edgesY      ) ;
  }

  // test OK
  if( NULL == hist )
  { this->Error( "IProfile2D* points to NULL! ID='" + ID.idAsString() +
                 "' title='"+htitle+"'" ) ; return NULL; } // RETURN !!

  // add histogram into histogram storages
  if      ( ID.numeric() )
  { m_profile2DMapNumID [ ID.numericID() ] = hist ; }
  else if ( ID.literal() )
  { m_profile2DMapLitID [ ID.literalID() ] = hist ; }
  m_profile2DMapTitle [ title ] = hist ;

  // Declare to monitoring service
  monitorHisto( Gaudi::Utils::Histos::toBase ( hist ) , ID );

  // printout and return
  if ( this->msgLevel(MSG::DEBUG) )
  {  this->debug() << "Booked 2D Profile Histogram : ID='" << ID
                   << "' Path=" << histoPath()
                   << " Title='"
                   << Gaudi::Utils::Histos::htitle ( hist )
                   << "'" << endmsg; }
  return hist ;
}

template<class PBASE>

AIDA::IHistogram1D * GaudiHistos< PBASE >::fill	(	AIDA::IHistogram1D *	histo,
		const double	value,
		const double	weight,
		const std::string &	title = ""
	)			const [inline]

fill the 1D histogram with the value and weight

Parameters:

	histo	1D histogram to be filled
	value	value to be put into the histogram
	weight	weight to be used
	title	histogram title (to be used for error report)

Returns:

pointer to AIDA 1D histogram

Reimplemented in HistoTool.

Definition at line 101 of file GaudiHistos_1DFixedBinning.icpp.

{
  if ( NULL != histo && produceHistos() )
  {
    if ( !checkForNaN() )
    { Gaudi::Utils::Histos::fill ( histo , value , weight ) ; }
    else if  ( lfin ( value ) && lfin ( weight ) )
    { Gaudi::Utils::Histos::fill ( histo , value , weight ) ; }
    else if  ( lnan ( value ) || lnan ( weight ) )
    {
      this -> Warning
        ("fill():: 'NaN'      value is skipped from the histogram '"
         + Gaudi::Utils::Histos::htitle ( histo , title ) + "'" ) ;
    }
    else
    {
      this -> Warning
        ("fill():: 'Infinite' value is skipped from the histogram '"
         + Gaudi::Utils::Histos::htitle ( histo , title ) + "'" ) ;
    }
  }
  // return
  return histo ;
}

template<class PBASE>

AIDA::IHistogram2D * GaudiHistos< PBASE >::fill	(	AIDA::IHistogram2D *	histo,
		const double	valueX,
		const double	valueY,
		const double	weight,
		const std::string &	title = ""
	)			const [inline]

fill the 2D histogram with the value and weight

Parameters:

	histo	2D histogram to be filled
	valueX	x value to be put into the histogram
	valueY	y value to be put into the histogram
	weight	weight to be used
	title	histogram title (to be used for error report)

Returns:

pointer to AIDA 2D histogram

Reimplemented in HistoTool.

Definition at line 114 of file GaudiHistos_2DFixedBinning.icpp.

{
  if ( NULL != histo && produceHistos() )
  {
    if ( !checkForNaN() )
    { Gaudi::Utils::Histos::fill ( histo , valueX , valueY , weight ) ; }
    else if  ( lfin ( valueX ) && lfin ( valueY ) && lfin ( weight ) )
    { Gaudi::Utils::Histos::fill ( histo , valueX , valueY , weight ) ; }
    else if  ( lnan ( valueX ) || lnan ( valueY ) || lnan ( weight ) )
    {
      this -> Warning
        ("fill():: 'NaN'      value is skipped from the histogram '"
         + Gaudi::Utils::Histos::htitle ( histo , title ) + "'" ) ;
    }
    else
    {
      this -> Warning
        ("fill():: 'Infinite' value is skipped from the histogram '"
         + Gaudi::Utils::Histos::htitle ( histo , title ) + "'" ) ;
    }
  }
  // return
  return histo ;
}

template<class PBASE>

AIDA::IHistogram3D * GaudiHistos< PBASE >::fill	(	AIDA::IHistogram3D *	histo,
		const double	valueX,
		const double	valueY,
		const double	valueZ,
		const double	weight,
		const std::string &	title = ""
	)			const [inline]

fill the 3D histogram with the value and weight

Parameters:

	histo	3D histogram to be filled
	valueX	x value to be put into the histogram
	valueY	y value to be put into the histogram
	valueZ	z value to be put into the histogram
	weight	weight to be used
	title	histogram title (to be used for error report)

Returns:

pointer to AIDA 3D histogram

Reimplemented in HistoTool.

Definition at line 128 of file GaudiHistos_3DFixedBinning.icpp.

{
  if ( 0 != histo && produceHistos() )
  {
    if ( !checkForNaN() )
    { Gaudi::Utils::Histos::fill ( histo , valueX , valueY , valueZ , weight ) ; }
    else if  ( lfin ( valueX ) && lfin ( valueY ) &&
               lfin ( valueZ ) && lfin ( weight ) )
    { Gaudi::Utils::Histos::fill ( histo , valueX , valueY , valueZ , weight ) ; }
    else if  ( lnan ( valueX ) || lnan ( valueY ) ||
               lnan ( valueZ ) || lnan ( weight ) )
    {
      this -> Warning
        ("fill():: 'NaN'      value is skipped from the histogram '"
         + Gaudi::Utils::Histos::htitle ( histo , title  ) + "'" ) ;
    }
    else
    {
      this -> Warning
        ("fill():: 'Infinite' value is skipped from the histogram '"
         + Gaudi::Utils::Histos::htitle ( histo , title  ) + "'" ) ;
    }
  }
  // return
  return histo ;
}

template<class PBASE>

AIDA::IProfile1D * GaudiHistos< PBASE >::fill	(	AIDA::IProfile1D *	histo,
		const double	valueX,
		const double	valueY,
		const double	weight,
		const std::string &	title = ""
	)			const [inline]

fill the 1D profile histogram with the values and weight

Parameters:

	histo	1D profile histogram to be filled
	valueX	x value to be put into the histogram
	valueY	y value to be put into the histogram
	weight	weight to be used
	title	histogram title (to be used for error report)

Returns:

pointer to AIDA 1D histogram

Definition at line 112 of file GaudiHistos_1DProfFixedBinning.icpp.

{
  if ( NULL != histo && produceHistos() )
  {
    if ( !checkForNaN() )
    { Gaudi::Utils::Histos::fill ( histo , valueX , valueY , weight ); }
    else if  ( lfin ( valueX ) && lfin ( valueY ) && lfin ( weight ) )
    { Gaudi::Utils::Histos::fill ( histo , valueX , valueY , weight ); }
    else if  ( lnan ( valueX ) || lnan ( valueY ) || lnan ( weight ) )
    {
      this -> Warning
        ("fill():: 'NaN'      value is skipped from the histogram '"
         + Gaudi::Utils::Histos::htitle ( histo , title  ) + "'" ) ;
    }
    else
    {
      this -> Warning
        ("fill():: 'Infinite' value is skipped from the histogram '"
         + Gaudi::Utils::Histos::htitle ( histo , title  ) + "'" ) ;
    }
  }
  // return
  return histo ;
}

template<class PBASE>

AIDA::IProfile2D * GaudiHistos< PBASE >::fill	(	AIDA::IProfile2D *	histo,
		const double	valueX,
		const double	valueY,
		const double	valueZ,
		const double	weight,
		const std::string &	title = ""
	)			const [inline]

fill the 2D profile histogram with the values and weight

Parameters:

	histo	2D profile histogram to be filled
	valueX	x value to be put into the histogram
	valueY	y value to be put into the histogram
	valueZ	z value to be put into the histogram
	weight	weight to be used
	title	histogram title (to be used for error report)

Returns:

pointer to AIDA 1D histogram

Definition at line 112 of file GaudiHistos_2DProfFixedBinning.icpp.

{
  if ( 0 != histo && produceHistos() )
  {
    if ( !checkForNaN() )
    { Gaudi::Utils::Histos::fill ( histo , valueX , valueY , valueZ , weight ); }
    else if  ( lfin ( valueX ) && lfin ( valueY ) &&
               lfin ( valueZ ) && lfin ( weight ) )
    { Gaudi::Utils::Histos::fill ( histo , valueX , valueY , valueZ , weight ); }
    else if  ( lnan ( valueX ) || lnan ( valueY ) ||
               lnan ( valueZ ) || lnan ( weight ) )
    {
      this -> Warning
        ("fill():: 'NaN'      value is skipped from the histogram '"
         + Gaudi::Utils::Histos::htitle ( histo , title ) + "'" ) ;
    }
    else
    {
      this -> Warning
        ("fill():: 'Infinite' value is skipped from the histogram '"
         + Gaudi::Utils::Histos::htitle ( histo , title ) + "'" ) ;
    }
  }
  // return
  return histo ;
}

template<class PBASE>

AIDA::IHistogram1D* GaudiHistos< PBASE >::histo1D

(

const std::string &

title

)

const [inline]

access the EXISTING 1D histogram by title return the pointer to existing 1D histogram or NULL

Reimplemented in HistoTool.

Definition at line 2582 of file GaudiHistos.h.

  {
    Histo1DMapTitle::const_iterator found = histo1DMapTitle().find( title ) ;
    return ( histo1DMapTitle().end() == found ? 0 : found->second );
  }

template<class PBASE>

AIDA::IHistogram1D* GaudiHistos< PBASE >::histo

(

const std::string &

title

)

const [inline]

access the EXISTING 1D histogram by title

Wrapper method for the equivalent histo1D method. Retained for backwards compatibility, please use histo1D instead.

return the pointer to existing 1D histogram or NULL

Definition at line 2595 of file GaudiHistos.h.

  {
    return histo1D( title );
  }

template<class PBASE>

AIDA::IHistogram2D* GaudiHistos< PBASE >::histo2D

(

const std::string &

title

)

const [inline]

access the EXISTING 2D histogram by title return the pointer to existing 2D histogram or NULL

Reimplemented in HistoTool.

Definition at line 2603 of file GaudiHistos.h.

  {
    Histo2DMapTitle::const_iterator found = histo2DMapTitle().find( title ) ;
    return ( histo2DMapTitle().end() == found ? 0 : found->second );
  }

template<class PBASE>

AIDA::IHistogram3D* GaudiHistos< PBASE >::histo3D

(

const std::string &

title

)

const [inline]

access the EXISTING 3D histogram by title return the pointer to existing 3D histogram or NULL

Reimplemented in HistoTool.

Definition at line 2612 of file GaudiHistos.h.

  {
    Histo3DMapTitle::const_iterator found = histo3DMapTitle().find( title ) ;
    return ( histo3DMapTitle().end() == found ? 0 : found->second );
  }

template<class PBASE>

AIDA::IProfile1D* GaudiHistos< PBASE >::profile1D

(

const std::string &

title

)

const [inline]

access the EXISTING 1D profile histogram by title return the pointer to existing 1D profile histogram or NULL

Definition at line 2621 of file GaudiHistos.h.

  {
    Profile1DMapTitle::const_iterator found = profile1DMapTitle().find( title ) ;
    return ( profile1DMapTitle().end() == found ? 0 : found->second );
  }

template<class PBASE>

AIDA::IProfile2D* GaudiHistos< PBASE >::profile2D

(

const std::string &

title

)

const [inline]

access the EXISTING 2D profile histogram by title return the pointer to existing 2D profile histogram or NULL

Definition at line 2630 of file GaudiHistos.h.

  {
    Profile2DMapTitle::const_iterator found = profile2DMapTitle().find( title ) ;
    return ( profile2DMapTitle().end() == found ? 0 : found->second );
  }

template<class PBASE>

AIDA::IHistogram1D * GaudiHistos< PBASE >::histo1D

(

const HistoID &

ID

)

const [inline]

access the EXISTING 1D histogram by ID return the pointer to existing 1D histogram or NULL

Reimplemented in HistoTool.

Definition at line 485 of file GaudiHistos.icpp.

{
  AIDA::IHistogram1D * h(NULL);
  if ( ID.numeric() )
  {
    Histo1DMapNumID::const_iterator found =
      histo1DMapNumID().find( ID.numericID() ) ;
    h = ( histo1DMapNumID().end() == found ? NULL : found->second );
  }
  else
  {
    Histo1DMapLitID::const_iterator found =
      histo1DMapLitID().find( ID.literalID() ) ;
    h = ( histo1DMapLitID().end() == found ? NULL : found->second );
  }
  return h;
}

template<class PBASE>

AIDA::IHistogram1D* GaudiHistos< PBASE >::histo

(

const HistoID &

ID

)

const [inline]

access the EXISTING 1D histogram by ID

Wrapper method for the equivalent histo1D method. Retained for backwards compatibility, please use histo1D instead.

return the pointer to existing 1D histogram or NULL

Definition at line 2650 of file GaudiHistos.h.

  {
    return histo1D( ID );
  }

template<class PBASE>

AIDA::IHistogram2D * GaudiHistos< PBASE >::histo2D

(

const HistoID &

ID

)

const [inline]

access the EXISTING 2D histogram by ID return the pointer to existing 2D histogram or NULL

Reimplemented in HistoTool.

Definition at line 506 of file GaudiHistos.icpp.

{
  AIDA::IHistogram2D * h(NULL);
  if ( ID.numeric() )
  {
    Histo2DMapNumID::const_iterator found =
      histo2DMapNumID().find( ID.numericID() ) ;
    h = ( histo2DMapNumID().end() == found ? NULL : found->second );
  }
  else
  {
    Histo2DMapLitID::const_iterator found =
      histo2DMapLitID().find( ID.literalID() ) ;
    h = ( histo2DMapLitID().end() == found ? NULL : found->second );
  }
  return h;
}

template<class PBASE>

AIDA::IHistogram3D * GaudiHistos< PBASE >::histo3D

(

const HistoID &

ID

)

const [inline]

access the EXISTING 3D histogram by ID return the pointer to existing 3D histogram or NULL

Reimplemented in HistoTool.

Definition at line 527 of file GaudiHistos.icpp.

{
  AIDA::IHistogram3D * h(NULL);
  if ( ID.numeric() )
  {
    Histo3DMapNumID::const_iterator found =
      histo3DMapNumID().find( ID.numericID() ) ;
    h = ( histo3DMapNumID().end() == found ? NULL : found->second );
  }
  else
  {
    Histo3DMapLitID::const_iterator found =
      histo3DMapLitID().find( ID.literalID() ) ;
    h = ( histo3DMapLitID().end() == found ? NULL : found->second );
  }
  return h;
}

template<class PBASE>

AIDA::IProfile1D * GaudiHistos< PBASE >::profile1D

(

const HistoID &

ID

)

const [inline]

access the EXISTING 1D profile histogram by ID return the pointer to existing 1D profile histogram or NULL

Definition at line 548 of file GaudiHistos.icpp.

{
  AIDA::IProfile1D * h(NULL);
  if ( ID.numeric() )
  {
    Profile1DMapNumID::const_iterator found =
      profile1DMapNumID().find( ID.numericID() ) ;
    h = ( profile1DMapNumID().end() == found ? NULL : found->second );
  }
  else
  {
    Profile1DMapLitID::const_iterator found =
      profile1DMapLitID().find( ID.literalID() ) ;
    h = ( profile1DMapLitID().end() == found ? NULL : found->second );
  }
  return h;
}

template<class PBASE>

AIDA::IProfile2D * GaudiHistos< PBASE >::profile2D

(

const HistoID &

ID

)

const [inline]

access the EXISTING 2D profile histogram by ID return the pointer to existing 2D profile histogram or NULL

Definition at line 569 of file GaudiHistos.icpp.

{
  AIDA::IProfile2D * h(NULL);
  if ( ID.numeric() )
  {
    Profile2DMapNumID::const_iterator found =
      profile2DMapNumID().find( ID.numericID() ) ;
    h = ( profile2DMapNumID().end() == found ? NULL : found->second );
  }
  else
  {
    Profile2DMapLitID::const_iterator found =
      profile2DMapLitID().find( ID.literalID() ) ;
    h = ( profile2DMapLitID().end() == found ? NULL : found->second );
  }
  return h;
}

template<class PBASE>

bool GaudiHistos< PBASE >::histoExists

(

const std::string &

title

)

const [inline]

check the existence AND validity of the histogram with given title

Reimplemented in HistoTool.

Definition at line 2678 of file GaudiHistos.h.

  {
    return
      ( 0 != histo     ( title ) ||
        0 != histo2D   ( title ) ||
        0 != histo3D   ( title ) ||
        0 != profile1D ( title ) ||
        0 != profile2D ( title ) );
  }

template<class PBASE>

bool GaudiHistos< PBASE >::histoExists

(

const HistoID &

ID

)

const [inline]

check the existence AND validity of the histogram with given title

Reimplemented in HistoTool.

Definition at line 2689 of file GaudiHistos.h.

  {
    return
      ( 0 != histo     ( ID ) ||
        0 != histo2D   ( ID ) ||
        0 != histo3D   ( ID ) ||
        0 != profile1D ( ID ) ||
        0 != profile2D ( ID ) );
  }

template<class PBASE>

unsigned int GaudiHistos< PBASE >::totalNumberOfHistos

(

)

const [inline]

Returns the total number of histograms (of all types) currently booked.

Definition at line 590 of file GaudiHistos.icpp.

{
  const unsigned int n1D  = histo1DMapNumID().size()+histo1DMapLitID().size();
  const unsigned int n2D  = histo2DMapNumID().size()+histo2DMapLitID().size();
  const unsigned int n3D  = histo3DMapNumID().size()+histo3DMapLitID().size();
  const unsigned int n1DP = profile1DMapNumID().size()+profile1DMapLitID().size();
  const unsigned int n2DP = profile2DMapNumID().size()+profile2DMapLitID().size();
  return n1D+n2D+n3D+n1DP+n2DP;
}

template<class PBASE>

bool GaudiHistos< PBASE >::produceHistos

(

)

const [inline]

get the flag for histogram production (property "HistoProduce")

Definition at line 2704 of file GaudiHistos.h.

{ return m_produceHistos ; }

template<class PBASE>

bool GaudiHistos< PBASE >::fullDetail

(

)

const [inline]

get flag to control output level of histograms

Definition at line 2706 of file GaudiHistos.h.

{ return m_fullDetail    ; }

template<class PBASE>

bool GaudiHistos< PBASE >::checkForNaN

(

)

const [inline]

get the flag for NaN checks (property "HistoCheckForNan")

Definition at line 2708 of file GaudiHistos.h.

{ return m_checkForNaN   ; }

template<class PBASE>

bool GaudiHistos< PBASE >::splitHistoDir

(

)

const [inline]

get the flag for histogram path split (property "HistoSplitDir")

Definition at line 2710 of file GaudiHistos.h.

{ return m_splitHistoDir ; }

template<class PBASE>

HistoID::NumericID GaudiHistos< PBASE >::histoOffSet

(

)

const [inline]

get the value for histogram offset (property "HistoOffSet")

Definition at line 2712 of file GaudiHistos.h.

{ return m_histoOffSet ; }

template<class PBASE>

const std::string& GaudiHistos< PBASE >::histoTopDir

(

)

const [inline]

get top-level histogram directory (property "HistoTopDir")

Definition at line 2714 of file GaudiHistos.h.

{ return m_histoTopDir   ; }

template<class PBASE>

const std::string& GaudiHistos< PBASE >::histoDir

(

)

const [inline]

get histogram directory (property "HistoDir")

Definition at line 2716 of file GaudiHistos.h.

{ return m_histoDir      ; }

template<class PBASE>

std::string GaudiHistos< PBASE >::histoPath

(

)

const [inline]

get the constructed histogram path

Definition at line 2718 of file GaudiHistos.h.

  {
    const std::string path = histoTopDir() + histoDir();
    return ( splitHistoDir() ? dirHbookName(path) : path );
  }

template<class PBASE>

bool GaudiHistos< PBASE >::histosPrint

(

)

const [inline]

print histograms at finalization ?

Definition at line 2724 of file GaudiHistos.h.

{ return m_histosPrint ; }

template<class PBASE>

bool GaudiHistos< PBASE >::useNumericAutoIDs

(

)

const [inline]

Use old style sequencial numerical automatically assigned IDs ?

Definition at line 2726 of file GaudiHistos.h.

{ return m_useNumericAutoIDs; }

template<class PBASE>

int GaudiHistos< PBASE >::printHistos

(

const MSG::Level

level = MSG::ALWAYS

)

const [inline]

perform the actual printout of histograms

Parameters:

level

The message level to print at

Returns:

number of active histograms

Definition at line 222 of file GaudiHistos.icpp.

{
  // temporary storage
  std::set<const AIDA::IBaseHistogram*> histos   ;
  std::set<const AIDA::IBaseHistogram*> profiles ;

  using namespace Gaudi::Utils::Histos ;

  if ( noHistos() )
  { if (this->msgLevel(MSG::DEBUG)) this->msgStream(level) << "No histograms are booked" << endmsg ; }
  else
  {
    MsgStream & msg = this->msgStream(level);

    // Printout all histograms
    // Note, each must appear in either the numeric or literal map

    Gaudi::Utils::Histos::Table table
      ( m_histo1DTableFormat ,
        m_histo1DTableHeader ) ;

    if ( !histo1DMapNumID().empty() || !histo1DMapLitID().empty() )
    {
      msg << "List of booked 1D histograms in directory         "
          << "\"" << histoPath() << "\" :-"  ;

      if ( !table.header().empty() )
      {
        msg << std::endl << Gaudi::Utils::Histos::format
          ( "ID" , table.header() , m_histo1DTableFormatShort ) ;
      }
      {
        typedef std::map<Histo1DMapNumID::key_type, Histo1DMapNumID::mapped_type> ordered_map_t;
        ordered_map_t ordered_map(histo1DMapNumID().begin(), histo1DMapNumID().end());
        for ( ordered_map_t::const_iterator entry = ordered_map.begin() ;
              ordered_map.end() != entry ; ++entry )
        {
          AIDA::IHistogram1D* aida = entry->second ;
          if ( NULL == aida )
          { this->error() << "IHistogram1D points to NULL" << endmsg ; continue ; }
          if ( histos.end() != histos.find( toBase ( aida ) ) ) { continue ; }
          histos.insert ( toBase ( aida  ) ) ;
          // format and print the row
          msg << std::endl << table.toString
            ( aida                      ,
              HistoID ( entry->first )  ,
              m_histo1DTableFormatShort ) ;
        }
      }
      {
        typedef std::map<Histo1DMapLitID::key_type, Histo1DMapLitID::mapped_type> ordered_map_t;
        ordered_map_t ordered_map(histo1DMapLitID().begin(), histo1DMapLitID().end());
        for ( ordered_map_t::const_iterator entry = ordered_map.begin() ;
              ordered_map.end() != entry ; ++entry )
        {
          AIDA::IHistogram1D* aida = entry->second ;
          if ( NULL == aida )
          { this->error() << "IHistogram1D points to NULL" << endmsg ; continue ; }
          if ( histos.end() != histos.find( toBase ( aida ) ) ) { continue ; }
          histos.insert ( toBase ( aida  ) ) ;
          // format and print the row
          msg << std::endl << table.toString
            ( aida                      ,
              entry->first              ,
              m_histo1DTableFormatShort ) ;
        }
      }
      msg << endmsg ;
    }
    if ( !histo2DMapNumID().empty() || !histo2DMapLitID().empty() )
    {
      msg << "List of booked 2D histograms in directory         "
          << "\"" << histoPath() << "\" :-" ;
      {
        typedef std::map<Histo2DMapNumID::key_type, Histo2DMapNumID::mapped_type> ordered_map_t;
        ordered_map_t ordered_map(histo2DMapNumID().begin(), histo2DMapNumID().end());
        for ( ordered_map_t::const_iterator entry = ordered_map.begin() ;
              ordered_map.end() != entry ; ++entry )
        {
          AIDA::IHistogram2D* aida = entry->second ;
          if ( NULL == aida )
          { this->error() << "IHistogram2D points to NULL" << endmsg ; continue ; }
          if ( histos.end() != histos.find( toBase ( aida ) ) ) { continue ; }
          histos.insert ( toBase ( aida  ) ) ;
          msg << std::endl
              << GaudiAlg::Print2D::toString ( aida , entry->first );
        }
      }
      {
        typedef std::map<Histo2DMapLitID::key_type, Histo2DMapLitID::mapped_type> ordered_map_t;
        ordered_map_t ordered_map(histo2DMapLitID().begin(), histo2DMapLitID().end());
        for ( ordered_map_t::const_iterator entry = ordered_map.begin() ;
              ordered_map.end() != entry ; ++entry )
        {
          AIDA::IHistogram2D* aida = entry->second ;
          if ( NULL == aida )
          { this->error() << "IHistogram2D points to NULL" << endmsg ; continue ; }
          if ( histos.end() != histos.find( toBase ( aida ) ) ) { continue ; }
          histos.insert ( toBase ( aida  ) ) ;
          msg << std::endl
              << GaudiAlg::Print2D::toString ( aida , entry->first );
        }
      }
      msg << endmsg ;
    }

    if ( !histo3DMapNumID().empty() || !histo3DMapLitID().empty() )
    {
      msg << "List of booked 3D histograms in directory         "
          << "\"" << histoPath() << "\" :-" ;
      {
        typedef std::map<Histo3DMapNumID::key_type, Histo3DMapNumID::mapped_type> ordered_map_t;
        ordered_map_t ordered_map(histo3DMapNumID().begin(), histo3DMapNumID().end());
        for ( ordered_map_t::const_iterator entry = ordered_map.begin() ;
              ordered_map.end() != entry ; ++entry )
        {
          AIDA::IHistogram3D* aida = entry->second ;
          if ( NULL == aida )
          { this->error() << "IHistogram3D points to NULL" << endmsg ; continue ; }
          if ( histos.end() != histos.find( toBase ( aida ) ) ) { continue ; }
          histos.insert ( toBase ( aida  ) ) ;
          msg << std::endl << GaudiAlg::Print3D::toString ( aida , entry->first );
        }
      }
      {
        typedef std::map<Histo3DMapLitID::key_type, Histo3DMapLitID::mapped_type> ordered_map_t;
        ordered_map_t ordered_map(histo3DMapLitID().begin(), histo3DMapLitID().end());
        for ( ordered_map_t::const_iterator entry = ordered_map.begin() ;
              ordered_map.end() != entry ; ++entry )
        {
          AIDA::IHistogram3D* aida = entry->second ;
          if ( NULL == aida )
          { this->error() << "IHistogram3D points to NULL" << endmsg ; continue ; }
          if ( histos.end() != histos.find( toBase ( aida ) ) ) { continue ; }
          histos.insert ( toBase ( aida  ) ) ;
          msg << std::endl << GaudiAlg::Print3D::toString ( aida , entry->first ) ;
        }
      }
      msg << endmsg ;
    }
    if ( !profile1DMapNumID().empty() || !profile1DMapLitID().empty() )
    {
      msg << "List of booked 1D profile histograms in directory "
          << "\"" << histoPath() << "\" :-" ;
      {
        typedef std::map<Profile1DMapNumID::key_type, Profile1DMapNumID::mapped_type> ordered_map_t;
        ordered_map_t ordered_map(profile1DMapNumID().begin(), profile1DMapNumID().end());
        for ( ordered_map_t::const_iterator entry = ordered_map.begin() ;
              ordered_map.end() != entry ; ++entry )
        {
          AIDA::IProfile1D*   aida = entry->second ;
          if ( NULL == aida )
          { this->error() << "IProfile1D points to NULL" << endmsg ; continue ; }
          if ( profiles.end() != profiles.find( toBase ( aida ) ) ) { continue ; }
          profiles.insert ( toBase ( aida  ) ) ;
          msg << std::endl << GaudiAlg::Print1DProf::toString  ( aida , entry->first );
        }
      }
      {
        typedef std::map<Profile1DMapLitID::key_type, Profile1DMapLitID::mapped_type> ordered_map_t;
        ordered_map_t ordered_map(profile1DMapLitID().begin(), profile1DMapLitID().end());
        for ( ordered_map_t::const_iterator entry = ordered_map.begin() ;
              ordered_map.end() != entry ; ++entry )
        {
          AIDA::IProfile1D*   aida = entry->second ;
          if ( NULL == aida )
          { this->error() << "IProfile1D points to NULL" << endmsg ; continue ; }
          if ( profiles.end() != profiles.find( toBase ( aida ) ) ) { continue ; }
          profiles.insert ( toBase ( aida  ) ) ;
          msg << std::endl << GaudiAlg::Print1DProf::toString ( aida , entry->first );
        }
      }
      msg << endmsg ;
    }
    if ( !profile2DMapNumID().empty() || !profile2DMapLitID().empty() )
    {
      msg << "List of booked 2D profile histograms in directory "
          << "\"" << histoPath() << "\" :-" ;
      {
        typedef std::map<Profile2DMapNumID::key_type, Profile2DMapNumID::mapped_type> ordered_map_t;
        ordered_map_t ordered_map(profile2DMapNumID().begin(), profile2DMapNumID().end());
        for ( ordered_map_t::const_iterator entry = ordered_map.begin() ;
              ordered_map.end() != entry ; ++entry )
        {
          AIDA::IProfile2D*   aida = entry->second ;
          if ( NULL == aida )
          { this->error() << "IProfile2D points to NULL" << endmsg ; continue ; }
          if ( profiles.end() != profiles.find( toBase ( aida ) ) ) { continue ; }
          profiles.insert ( toBase ( aida  ) ) ;
          msg << std::endl << GaudiAlg::Print2DProf::toString ( aida , entry->first );
        }
      }
      {
        typedef std::map<Profile2DMapLitID::key_type, Profile2DMapLitID::mapped_type> ordered_map_t;
        ordered_map_t ordered_map(profile2DMapLitID().begin(), profile2DMapLitID().end());
        for ( ordered_map_t::const_iterator entry = ordered_map.begin() ;
              ordered_map.end() != entry ; ++entry )
        {
          AIDA::IProfile2D*   aida = entry->second ;
          if ( NULL == aida )
          { this->error() << "IProfile2D points to NULL" << endmsg ; continue ; }
          if ( profiles.end() != profiles.find( toBase ( aida ) ) ) { continue ; }
          profiles.insert ( toBase ( aida  ) ) ;
          msg << std::endl << GaudiAlg::Print2DProf::toString ( aida , entry->first );
        }
      }
      msg << endmsg ;
    }

  }
  return histos.size() + profiles.size() ;
}

template<class PBASE>

const Histo1DMapTitle& GaudiHistos< PBASE >::histo1DMapTitle

(

)

const [inline]

get access to the map of all 1D histograms indexed via their title

Using this method one can inspect e.g. a list of active histograms

  const Histo1DMapTitle& histos = histo1DMapTitle() ;
  // iterate over the map!
  for ( Histo1DMapTitle::const_iterator entry = histos.begin() ;
        histos.end() != entry ; ++entry  )
     {
        // histogram title
        const std::string&   title = entry->first ;
        // histogram itself
        AIDA::IHistogram1D* hist  = entry->second ;
        if( 0 == hist )  { continue ; }                // ATTENTION!

        std::cout << " Histogram title " << title << std::endl ;

     }

Attention:

The map *COULD* contains NULL pointers, the check before use is mandatory!

Definition at line 2761 of file GaudiHistos.h.

{ return m_histo1DMapTitle; }

template<class PBASE>

const Histo1DMapNumID& GaudiHistos< PBASE >::histo1DMapNumID

(

)

const [inline]

get access to the map of 1D histograms index via a numeric ID

Attention:

This map only contains 1D histogram booked via a numeric ID, either forced or automatically assigned.

  const Histo1DMapNumID& histos = histo1DMapNumID() ;
  // iterate over the map!
  for ( Histo1DMapNumID::const_iterator entry = histos.begin() ;
        histos.end() != entry ; ++entry  )
     {
        // histogram ID
        const HistoID        ID = entry->first ;
        // histogram itself
        AIDA::IHistogram1D* h  = entry->second ;
        if ( 0 == h ) { continue ;}

        std::cout << " Histogram ID    " << ID
                  << " Histogram title " << h->title() << std::endl ;

     }

Attention:

The map *COULD* contains NULL pointers, the check before use is mandatory!

Definition at line 2792 of file GaudiHistos.h.

{ return m_histo1DMapNumID; }

template<class PBASE>

const Histo1DMapLitID& GaudiHistos< PBASE >::histo1DMapLitID

(

)

const [inline]

get access to the map of all 1D histograms index via a literal (string) ID

Attention:

This map only contains 1D histogram booked via a literal ID.

  const Histo1DMapLitID& histos = histo1DMapLitID() ;
  // iterate over the map!
  for ( Histo1DMapLitID::const_iterator entry = histos.begin() ;
        histos.end() != entry ; ++entry  )
     {
        // histogram ID
        const HistoID        ID = entry->first ;
        // histogram itself
        AIDA::IHistogram1D* h  = entry->second ;
        if ( 0 == h ) { continue ;}

        std::cout << " Histogram ID    " << ID
                  << " Histogram title " << h->title() << std::endl ;

     }

Attention:

The map *COULD* contains NULL pointers, the check before use is mandatory!

Definition at line 2822 of file GaudiHistos.h.

{ return m_histo1DMapLitID; }

template<class PBASE>

const Histo2DMapTitle& GaudiHistos< PBASE >::histo2DMapTitle

(

)

const [inline]

get access to the map of all 2D histograms indexed via their title

Using this method one can inspect e.g. a list of active histograms

  const Histo2DMapTitle& histos = histo2DMapTitle() ;
  // iterate over the map!
  for ( Histo2DMapTitle::const_iterator entry = histos.begin() ;
        histos.end() != entry ; ++entry  )
     {
        // histogram title
        const std::string&   title = entry->first ;
        // histogram itself
        AIDA::IHistogram2D* hist  = entry->second ;
        if( 0 == hist )  { continue ; }                // ATTENTION!

        std::cout << " Histogram title " << title << std::endl ;

     }

Attention:

The map *COULD* contains NULL pointers, the check before use is mandatory!

Definition at line 2851 of file GaudiHistos.h.

{ return m_histo2DMapTitle ; }

template<class PBASE>

const Histo2DMapNumID& GaudiHistos< PBASE >::histo2DMapNumID

(

)

const [inline]

get access to the map of 2D histograms index via a numeric ID

Attention:

This map only contains 2D histogram booked via a numeric ID, either forced or automatically assigned.

  const Histo2DMapNumID& histos = histo2DMapNumID() ;
  // iterate over the map!
  for ( Histo2DMapNumID::const_iterator entry = histos.begin() ;
        histos.end() != entry ; ++entry  )
     {
        // histogram ID
        const HistoID        ID = entry->first ;
        // histogram itself
        AIDA::IHistogram2D* h  = entry->second ;
        if ( 0 == h ) { continue ;}

        std::cout << " Histogram ID    " << ID
                  << " Histogram title " << h->title() << std::endl ;

     }

Attention:

The map *COULD* contains NULL pointers, the check before use is mandatory!

Definition at line 2882 of file GaudiHistos.h.

{ return m_histo2DMapNumID; }

template<class PBASE>

const Histo2DMapLitID& GaudiHistos< PBASE >::histo2DMapLitID

(

)

const [inline]

get access to the map of all 2D histograms index via a literal (string) ID

Attention:

This map only contains 2D histogram booked via a literal ID.

  const Histo2DMapLitID& histos = histo2DMapLitID() ;
  // iterate over the map!
  for ( Histo2DMapLitID::const_iterator entry = histos.begin() ;
        histos.end() != entry ; ++entry  )
     {
        // histogram ID
        const HistoID        ID = entry->first ;
        // histogram itself
        AIDA::IHistogram2D* h  = entry->second ;
        if ( 0 == h ) { continue ;}

        std::cout << " Histogram ID    " << ID
                  << " Histogram title " << h->title() << std::endl ;

     }

Attention:

The map *COULD* contains NULL pointers, the check before use is mandatory!

Definition at line 2912 of file GaudiHistos.h.

{ return m_histo2DMapLitID; }

template<class PBASE>

const Histo3DMapTitle& GaudiHistos< PBASE >::histo3DMapTitle

(

)

const [inline]

get access to the map of all 3D histograms indexed via their title

Using this method one can inspect e.g. a list of active histograms

  const Histo3DMapTitle& histos = histo3DMapTitle() ;
  // iterate over the map!
  for ( Histo3DMapTitle::const_iterator entry = histos.begin() ;
        histos.end() != entry ; ++entry  )
     {
        // histogram title
        const std::string&   title = entry->first ;
        // histogram itself
        AIDA::IHistogram3D* hist  = entry->second ;
        if( 0 == hist )  { continue ; }                // ATTENTION!

        std::cout << " Histogram title " << title << std::endl ;

     }

Attention:

The map *COULD* contains NULL pointers, the check before use is mandatory!

Definition at line 2941 of file GaudiHistos.h.

{ return m_histo3DMapTitle ; }

template<class PBASE>

const Histo3DMapNumID& GaudiHistos< PBASE >::histo3DMapNumID

(

)

const [inline]

get access to the map of 3D histograms index via a numeric ID

Attention:

This map only contains 3D histogram booked via a numeric ID, either forced or automatically assigned.

  const Histo3DMapNumID& histos = histo3DMapNumID() ;
  // iterate over the map!
  for ( Histo3DMapNumID::const_iterator entry = histos.begin() ;
        histos.end() != entry ; ++entry  )
     {
        // histogram ID
        const HistoID        ID = entry->first ;
        // histogram itself
        AIDA::IHistogram3D* h  = entry->second ;
        if ( 0 == h ) { continue ;}

        std::cout << " Histogram ID    " << ID
                  << " Histogram title " << h->title() << std::endl ;

     }

Attention:

The map *COULD* contains NULL pointers, the check before use is mandatory!

Definition at line 2972 of file GaudiHistos.h.

{ return m_histo3DMapNumID; }

template<class PBASE>

const Histo3DMapLitID& GaudiHistos< PBASE >::histo3DMapLitID

(

)

const [inline]

get access to the map of all 3D histograms index via a literal (string) ID

Attention:

This map only contains 3D histogram booked via a literal ID.

  const Histo3DMapLitID& histos = histo3DMapLitID() ;
  // iterate over the map!
  for ( Histo3DMapLitID::const_iterator entry = histos.begin() ;
        histos.end() != entry ; ++entry  )
     {
        // histogram ID
        const HistoID        ID = entry->first ;
        // histogram itself
        AIDA::IHistogram3D* h  = entry->second ;
        if ( 0 == h ) { continue ;}

        std::cout << " Histogram ID    " << ID
                  << " Histogram title " << h->title() << std::endl ;

     }

Attention:

The map *COULD* contains NULL pointers, the check before use is mandatory!

Definition at line 3002 of file GaudiHistos.h.

{ return m_histo3DMapLitID; }

template<class PBASE>

const Profile1DMapTitle& GaudiHistos< PBASE >::profile1DMapTitle

(

)

const [inline]

get access to the map of all 1D profile histograms indexed via their title

Using this method one can inspect e.g. a list of active histograms

  const Profile1DMapTitle& histos = profile1DMapTitle() ;
  // iterate over the map!
  for ( Profile1DMapTitle::const_iterator entry = histos.begin() ;
        histos.end() != entry ; ++entry  )
     {
        // histogram title
        const std::string&   title = entry->first ;
        // histogram itself
        AIDA::IProfile1D* hist  = entry->second ;
        if( 0 == hist )  { continue ; }                // ATTENTION!

        std::cout << " Histogram title " << title << std::endl ;

     }

Attention:

The map *COULD* contains NULL pointers, the check before use is mandatory!

Definition at line 3031 of file GaudiHistos.h.

{ return m_profile1DMapTitle; }

template<class PBASE>

const Profile1DMapNumID& GaudiHistos< PBASE >::profile1DMapNumID

(

)

const [inline]

get access to the map of 1D profile histograms index via a numeric ID

Attention:

This map only contains 2D histogram booked via a numeric ID, either forced or automatically assigned.

  const Profile1DMapNumID& histos = profile1DMapNumID() ;
  // iterate over the map!
  for ( Profile1DMapNumID::const_iterator entry = histos.begin() ;
        histos.end() != entry ; ++entry  )
     {
        // histogram ID
        const HistoID        ID = entry->first ;
        // histogram itself
        AIDA::IProfile1D* h  = entry->second ;
        if ( 0 == h ) { continue ;}

        std::cout << " Histogram ID    " << ID
                  << " Histogram title " << h->title() << std::endl ;

     }

Attention:

The map *COULD* contains NULL pointers, the check before use is mandatory!

Definition at line 3062 of file GaudiHistos.h.

{ return m_profile1DMapNumID; }

template<class PBASE>

const Profile1DMapLitID& GaudiHistos< PBASE >::profile1DMapLitID

(

)

const [inline]

get access to the map of 1D profile histograms index via a literal ID

Attention:

This map only contains 2D histogram booked via a literal ID, either forced or automatically assigned.

  const Profile1DMapLitID& histos = profile1DMapLitID() ;
  // iterate over the map!
  for ( Profile1DMapLitID::const_iterator entry = histos.begin() ;
        histos.end() != entry ; ++entry  )
     {
        // histogram ID
        const HistoID        ID = entry->first ;
        // histogram itself
        AIDA::IProfile1D* h  = entry->second ;
        if ( 0 == h ) { continue ;}

        std::cout << " Histogram ID    " << ID
                  << " Histogram title " << h->title() << std::endl ;

     }

Attention:

The map *COULD* contains NULL pointers, the check before use is mandatory!

Definition at line 3093 of file GaudiHistos.h.

{ return m_profile1DMapLitID; }

template<class PBASE>

const Profile2DMapTitle& GaudiHistos< PBASE >::profile2DMapTitle

(

)

const [inline]

get access to the map of all 2D profile histograms indexed via their title

Using this method one can inspect e.g. a list of active histograms

  const Profile2DMapTitle& histos = profile2DMapTitle() ;
  // iterate over the map!
  for ( Profile2DMapTitle::const_iterator entry = histos.begin() ;
        histos.end() != entry ; ++entry  )
     {
        // histogram title
        const std::string&   title = entry->first ;
        // histogram itself
        AIDA::IProfile2D* hist  = entry->second ;
        if( 0 == hist )  { continue ; }                // ATTENTION!

        std::cout << " Histogram title " << title << std::endl ;

     }

Attention:

The map *COULD* contains NULL pointers, the check before use is mandatory!

Definition at line 3122 of file GaudiHistos.h.

{ return m_profile2DMapTitle; }

template<class PBASE>

const Profile2DMapNumID& GaudiHistos< PBASE >::profile2DMapNumID

(

)

const [inline]

get access to the map of 2D profile histograms index via a numeric ID

Attention:

This map only contains 2D histogram booked via a numeric ID, either forced or automatically assigned.

  const Profile2DMapNumID& histos = profile2DMapNumID() ;
  // iterate over the map!
  for ( Profile2DMapNumID::const_iterator entry = histos.begin() ;
        histos.end() != entry ; ++entry  )
     {
        // histogram ID
        const HistoID        ID = entry->first ;
        // histogram itself
        AIDA::IProfile2D* h  = entry->second ;
        if ( 0 == h ) { continue ;}

        std::cout << " Histogram ID    " << ID
                  << " Histogram title " << h->title() << std::endl ;

     }

Attention:

The map *COULD* contains NULL pointers, the check before use is mandatory!

Definition at line 3153 of file GaudiHistos.h.

{ return m_profile2DMapNumID; }

template<class PBASE>

const Profile2DMapLitID& GaudiHistos< PBASE >::profile2DMapLitID

(

)

const [inline]

get access to the map of 2D profile histograms index via a literal ID

Attention:

This map only contains 2D histogram booked via a literal ID, either forced or automatically assigned.

  const Profile2DMapLitID& histos = profile2DMapLitID() ;
  // iterate over the map!
  for ( Profile2DMapLitID::const_iterator entry = histos.begin() ;
        histos.end() != entry ; ++entry  )
     {
        // histogram ID
        const HistoID        ID = entry->first ;
        // histogram itself
        AIDA::IProfile2D* h  = entry->second ;
        if ( 0 == h ) { continue ;}

        std::cout << " Histogram ID    " << ID
                  << " Histogram title " << h->title() << std::endl ;

     }

Attention:

The map *COULD* contains NULL pointers, the check before use is mandatory!

Definition at line 3184 of file GaudiHistos.h.

{ return m_profile2DMapLitID; }

template<class PBASE>

void GaudiHistos< PBASE >::setProduceHistos

(

const bool

val

)

[inline]

set the flag for histogram production (property "HistoProduce")

Definition at line 3189 of file GaudiHistos.h.

{ m_produceHistos = val ; }

template<class PBASE>

void GaudiHistos< PBASE >::setFullDetail

(

const bool

val

)

[inline]

set flag to control output level of histograms

Definition at line 3191 of file GaudiHistos.h.

{ m_fullDetail    = val ; }

template<class PBASE>

void GaudiHistos< PBASE >::setCheckForNaN

(

const bool

val

)

[inline]

set the flag for NaN checks (property "HistoCheckForNan")

Definition at line 3193 of file GaudiHistos.h.

{ m_checkForNaN   = val ; }

template<class PBASE>

void GaudiHistos< PBASE >::setSplitHistoDir

(

const bool

val

)

[inline]

set the flag for histogram path split (property "HistoSplitDir")

Definition at line 3195 of file GaudiHistos.h.

{ m_splitHistoDir = val ; }

template<class PBASE>

void GaudiHistos< PBASE >::setHistoOffSet

(

const HistoID::NumericID

val

)

[inline]

set a value for histogram offset (property "HistoOffSet"

Definition at line 3197 of file GaudiHistos.h.

  { m_histoOffSet   = val ; }

template<class PBASE>

void GaudiHistos< PBASE >::setHistoTopDir

(

const std::string &

val

)

[inline]

set top-level histogram directory (property "HistoTopDir")

Definition at line 3201 of file GaudiHistos.h.

{ m_histoTopDir   = val ; }

template<class PBASE>

void GaudiHistos< PBASE >::setHistoDir

(

const std::string &

val

)

[inline]

set histogram directory (property "HistoDir")

Definition at line 3204 of file GaudiHistos.h.

{ m_histoDir      = val ; }

template<class PBASE>

StatusCode GaudiHistos< PBASE >::initialize

(

)

[inline, protected, virtual]

standard initialization method

Returns:

status code

Reimplemented in GaudiHistoAlg, GaudiHistoTool, GaudiTupleAlg, GaudiTupleTool, GaudiTuples< GaudiHistoTool >, and GaudiTuples< GaudiHistoAlg >.

Definition at line 130 of file GaudiHistos.icpp.

{
  // initialize base class
  const StatusCode sc = PBASE::initialize();
  if ( sc.isFailure() ) return sc;

  // produce histograms?
  if ( !produceHistos() )
  {
    this->debug() << "Histogram production is switched OFF" << endmsg;
    return sc;
  }

  // check the validity of histogram service
  if ( this->histoSvc() == NULL )
  { return this->Error("initialize():: IHistogramSvc* is invalid"); }

  // Warn if the user has decided to use numerical automatic IDs
  if ( useNumericAutoIDs() )
  {
    this ->
      Warning( "Using numerical automatic IDs. These are not guaranteed to be totally deterministic. Use with care...",
               StatusCode::SUCCESS );
  }

  // Finally, print the location histogram will be written to
  Print
    ( "The histogram path is set to be '" + histoPath() + "'",
      StatusCode( StatusCode::SUCCESS, true )  , MSG::DEBUG );

  return sc;
}

template<class PBASE>

StatusCode GaudiHistos< PBASE >::finalize

(

void

)

[inline, protected, virtual]

standard finalization method

Returns:

status code

Reimplemented in GaudiHistoAlg, GaudiHistoTool, GaudiTupleAlg, GaudiTupleTool, GaudiTuples< GaudiHistoTool >, and GaudiTuples< GaudiHistoAlg >.

Definition at line 166 of file GaudiHistos.icpp.

{

  if ( produceHistos() )
  {

    // Count how many histos of each type
    if ( !noHistos() )
    {
      const unsigned int n1D  = histo1DMapNumID().size()+histo1DMapLitID().size();
      const unsigned int n2D  = histo2DMapNumID().size()+histo2DMapLitID().size();
      const unsigned int n3D  = histo3DMapNumID().size()+histo3DMapLitID().size();
      const unsigned int n1DP = profile1DMapNumID().size()+profile1DMapLitID().size();
      const unsigned int n2DP = profile2DMapNumID().size()+profile2DMapLitID().size();
      const unsigned int total = n1D+n2D+n3D+n1DP+n2DP;
      if ( total>0 )
      {
        this->always() << "Booked " << total << " Histogram(s) : ";
        if ( n1D>0  ) this->always() << "1D=" << n1D << " ";
        if ( n2D>0  ) this->always() << "2D=" << n2D << " ";
        if ( n3D>0  ) this->always() << "3D=" << n3D << " ";
        if ( n1DP>0 ) this->always() << "1DProf=" << n1DP << " ";
        if ( n2DP>0 ) this->always() << "2DProf=" << n2DP << " ";
        this->always() << endmsg;
      }
    }

    // detailed printing
    if ( histosPrint() ) { printHistos() ; }

  }

  // clear all maps
  m_histo1DMapTitle   .clear() ;
  m_histo2DMapTitle   .clear() ;
  m_histo3DMapTitle   .clear() ;
  m_histo1DMapNumID   .clear() ;
  m_histo1DMapLitID   .clear() ;
  m_histo2DMapNumID   .clear() ;
  m_histo2DMapLitID   .clear() ;
  m_histo3DMapNumID   .clear() ;
  m_histo3DMapLitID   .clear() ;
  m_profile1DMapTitle .clear() ;
  m_profile2DMapTitle .clear() ;
  m_profile1DMapNumID .clear() ;
  m_profile1DMapLitID .clear() ;
  m_profile2DMapNumID .clear() ;
  m_profile2DMapLitID .clear() ;

  // finalize base class
  return PBASE::finalize();
}

template<class PBASE>

bool GaudiHistos< PBASE >::noHistos

(

)

const [inline, private]

Check if all histogram maps are empty.

Definition at line 438 of file GaudiHistos.icpp.

{
  return ( histo1DMapTitle()   .empty() &&
           histo2DMapTitle()   .empty() &&
           histo3DMapTitle()   .empty() &&
           profile1DMapTitle() .empty() &&
           profile2DMapTitle() .empty() &&
           histo1DMapNumID()   .empty() &&
           histo1DMapLitID()   .empty() &&
           histo2DMapNumID()   .empty() &&
           histo2DMapLitID()   .empty() &&
           histo3DMapNumID()   .empty() &&
           histo3DMapLitID()   .empty() &&
           profile1DMapNumID() .empty() &&
           profile1DMapLitID() .empty() &&
           profile2DMapNumID() .empty() &&
           profile2DMapLitID() .empty() );
}

template<class PBASE>

void GaudiHistos< PBASE >::initGaudiHistosConstructor

(

)

[inline, private]

Constructor initialisation and job options.

Definition at line 60 of file GaudiHistos.icpp.

{
  // SWITCH ON/OFF the histograms
  this->declareProperty
    ( "HistoProduce"          ,
      m_produceHistos = true  ,
      "Swith on/off the production of histograms "   ) ;
  // print the histograms at finalization
  this->declareProperty
    ( "HistoPrint"            ,
      m_histosPrint   = false ,
      "Switch on/off the printout of histograms at finalization"    )
    -> declareUpdateHandler ( &GaudiHistos<PBASE>::printHistoHandler, this ) ;
  // check for NaN/Finite
  this->declareProperty
    ( "HistoCheckForNaN"      ,
      m_checkForNaN   = true  ,
      "Swicth on/off the checks for NaN and Infinity for histogram fill" ) ;
  // for HBOOK persistency, 'true' can be useful
  this->declareProperty
    ( "HistoSplitDir"         ,
      m_splitHistoDir = false ,
      "Split long directory names into short pieces (suitable for HBOOK)" );
  // general OffSet for histogram ID
  this->declareProperty
    ( "HistoOffSet"           ,
      m_histoOffSet   =   0   ,
      "OffSet for automatically assigned histogram numerical identifiers " ) ;
  // top level histogram directory
  this->declareProperty
    ( "HistoTopDir"           ,
      m_histoTopDir   =   ""  ,
      "Top level histogram directory (take care that it ends with '/')" ) ;
  // histogram directory
  this->declareProperty
    ( "HistoDir"             ,
      m_histoDir      = this->name() ,
      "Histogram Directory" ) ;
  // control output level of histograms
  this->declareProperty ( "FullDetail"            , m_fullDetail    = false ) ;
  // monitor histograms
  this->declareProperty ( "MonitorHistograms"     , m_declareMoniHists = true ) ;
  // format for 1D-histograms printout
  this->declareProperty
    ( "FormatFor1DHistoTable" ,
      m_histo1DTableFormat   = Gaudi::Utils::Histos::Formats::format () ,
      "Format string for printout of 1D histograms"      ) ;
  // "short" format for 1D-histograms printout
  this->declareProperty
    ( "ShortFormatFor1DHistoTable" ,
      m_histo1DTableFormatShort   = " | %1$-25.25s %2%"  ,
      "Format string for printout of 1D histograms"      ) ;
  // the header for 1D-histogram tabkle
  this->declareProperty
    ( "HeaderFor1DHistoTable" ,
      m_histo1DTableHeader   = Gaudi::Utils::Histos::Formats::header () ,
      "The table header for printout of 1D histograms "  ) ;
  this->declareProperty
    ( "UseSequencialNumericAutoIDs", m_useNumericAutoIDs = false,
      "Flag to allow users to switch back to the old style of creating numerical automatic IDs" );
  m_idReplaceInfo.clear();
  m_idReplaceInfo["/"] = "=SLASH=";
  this->declareProperty
    ( "AutoStringIDPurgeMap", m_idReplaceInfo,
      "Map of strings to search and replace when using the title as the basis of automatically generated literal IDs" );
}

template<class PBASE>

void GaudiHistos< PBASE >::monitorHisto	(	const AIDA::IBaseHistogram *	hist,
		const HistoID &	ID
	)			const [inline, private]

Declare a histogram to the monitor service.

Uses the histogram ID as the 'name' sent to the monitor service and the histogram title as the long description

Definition at line 463 of file GaudiHistos.icpp.

{
  if ( hist && m_declareMoniHists )
  {
    if ( this->msgLevel(MSG::DEBUG) )
    {
      this->debug() << "Monitoring histogram '"
                    << ID.idAsString() << "' desc = '"
                    << Gaudi::Utils::Histos::htitle(hist) << "'" << endmsg;
    }
    this->declareInfo ( histoPath()+"/"+ID.idAsString() ,
                        hist            ,
                        Gaudi::Utils::Histos::htitle(hist) ) ;
  }
}

template<class PBASE>

void GaudiHistos< PBASE >::newHistoID	(	const std::string &	title,
		HistoID &	ID
	)			const [inline, private]

Create a new histogram ID using the given title.

Parameters:

[in]	title	Histogram title
[out]	ID	The ID to use for the new histogram

Definition at line 603 of file GaudiHistos.icpp.

{
  if ( useNumericAutoIDs() || title.empty() )
  {
    if ( !useNumericAutoIDs() )
    {
      this -> Warning( "Cannot generate automatic literal ID from an empty title ! Using numeric ID instead for histogram ID",
                       StatusCode::SUCCESS );
    }
    // propose the histogram ID (always numeric)
    ID = HistoID( totalNumberOfHistos() + 1 + histoOffSet() );
    // adjust the proposed ID
    while ( histoExists( ID ) ) { ID = HistoID( ID.numeric() + 1 ) ; }
  }
  else
  {
    // use the title to create a unique literal ID
    ID = HistoID( this->convertTitleToID(title) );
    // Just in case ...
    while ( histoExists( ID ) ) { ID = HistoID(ID.idAsString()+"_"); }
  }
}

template<class PBASE>

void GaudiHistos< PBASE >::stringSearchReplace	(	std::string &	title,
		const std::string &	A,
		const std::string &	B
	)			const [inline, private]

Searches 'title' for all instancies of 'A' and replaces them with 'B'.

Definition at line 645 of file GaudiHistos.icpp.

{
  std::string::size_type slash = title.find_first_of ( A ) ;
  while ( std::string::npos != slash )
  {
    title = title.substr(0,slash) + B + title.substr(slash+A.size());
    slash = title.find_first_of( A );
  }
}

template<class PBASE>

std::string GaudiHistos< PBASE >::convertTitleToID

(

const std::string &

title

)

const [inline, protected]

Create an ID string from a title string.

Definition at line 630 of file GaudiHistos.icpp.

{
  // clean up the ID string for all unwanted characters
  std::string tmp_id = title;
  for ( std::map<std::string,std::string>::const_iterator i = m_idReplaceInfo.begin();
        i != m_idReplaceInfo.end(); ++i )
  {
    stringSearchReplace( tmp_id, i->first, i->second );
  }
  return tmp_id;
}

template<class PBASE>

void GaudiHistos< PBASE >::printHistoHandler

(

Property &

)

[inline, private]

the handler for "HistoPrint" property

Definition at line 660 of file GaudiHistos.icpp.

{
  // no action if not yet initialized 
  if ( this -> FSMState() < Gaudi::StateMachine::INITIALIZED ) { return ; }
  if ( this -> histosPrint() ) { this -> printHistos ( MSG::ALWAYS ) ; } 
}

---

Member Data Documentation

template<class PBASE>

bool GaudiHistos< PBASE >::m_produceHistos [private]

flag to SWITCH ON/SWITCH OFF the histogrm fillling and booking

Definition at line 3273 of file GaudiHistos.h.

template<class PBASE>

bool GaudiHistos< PBASE >::m_fullDetail [private]

flag to control output level of histograms

Definition at line 3275 of file GaudiHistos.h.

template<class PBASE>

bool GaudiHistos< PBASE >::m_checkForNaN [private]

flag to control check for Nan/Finite while filling the histogram

Definition at line 3277 of file GaudiHistos.h.

template<class PBASE>

bool GaudiHistos< PBASE >::m_splitHistoDir [private]

split histogram directory name (very useful for Hbook)

Definition at line 3279 of file GaudiHistos.h.

template<class PBASE>

HistoID::NumericID GaudiHistos< PBASE >::m_histoOffSet [private]

general histogram ID offset (only works for automatically assigned numeric IDs)

Definition at line 3281 of file GaudiHistos.h.

template<class PBASE>

std::string GaudiHistos< PBASE >::m_histoTopDir [private]

histogram top level directory

Definition at line 3283 of file GaudiHistos.h.

template<class PBASE>

std::string GaudiHistos< PBASE >::m_histoDir [private]

histogram directory

Definition at line 3285 of file GaudiHistos.h.

template<class PBASE>

bool GaudiHistos< PBASE >::m_histosPrint [private]

print histograms at finalization

Definition at line 3287 of file GaudiHistos.h.

template<class PBASE>

bool GaudiHistos< PBASE >::m_declareMoniHists [private]

Flag to turn on/off the registration of histograms to the Monitoring Service.

Definition at line 3289 of file GaudiHistos.h.

template<class PBASE>

Histo1DMapTitle GaudiHistos< PBASE >::m_histo1DMapTitle [mutable, private]

the actual storage/access of 1D histograms by unique title

Definition at line 3292 of file GaudiHistos.h.

template<class PBASE>

Histo1DMapNumID GaudiHistos< PBASE >::m_histo1DMapNumID [mutable, private]

the actual storage/access of 1D histograms by unique numeric ID

Definition at line 3294 of file GaudiHistos.h.

template<class PBASE>

Histo1DMapLitID GaudiHistos< PBASE >::m_histo1DMapLitID [mutable, private]

the actual storage/access of 1D histograms by unique literal ID

Definition at line 3296 of file GaudiHistos.h.

template<class PBASE>

Histo2DMapTitle GaudiHistos< PBASE >::m_histo2DMapTitle [mutable, private]

the actual storage/access of 2D histograms by unique title

Definition at line 3299 of file GaudiHistos.h.

template<class PBASE>

Histo2DMapNumID GaudiHistos< PBASE >::m_histo2DMapNumID [mutable, private]

the actual storage/access of 2D histograms by unique numeric ID

Definition at line 3301 of file GaudiHistos.h.

template<class PBASE>

Histo2DMapLitID GaudiHistos< PBASE >::m_histo2DMapLitID [mutable, private]

the actual storage/access of 2D histograms by unique literal ID

Definition at line 3303 of file GaudiHistos.h.

template<class PBASE>

Histo3DMapTitle GaudiHistos< PBASE >::m_histo3DMapTitle [mutable, private]

the actual storage/access of 3D histograms by unique title

Definition at line 3306 of file GaudiHistos.h.

template<class PBASE>

Histo3DMapNumID GaudiHistos< PBASE >::m_histo3DMapNumID [mutable, private]

the actual storage/access of 3D histograms by unique numeric ID

Definition at line 3308 of file GaudiHistos.h.

template<class PBASE>

Histo3DMapLitID GaudiHistos< PBASE >::m_histo3DMapLitID [mutable, private]

the actual storage/access of 3D histograms by unique literal ID

Definition at line 3310 of file GaudiHistos.h.

template<class PBASE>

Profile1DMapTitle GaudiHistos< PBASE >::m_profile1DMapTitle [mutable, private]

the actual storage/access of 1D profile histograms by unique title

Definition at line 3313 of file GaudiHistos.h.

template<class PBASE>

Profile1DMapNumID GaudiHistos< PBASE >::m_profile1DMapNumID [mutable, private]

the actual storage/access of 1D profile histograms by unique numeric ID

Definition at line 3315 of file GaudiHistos.h.

template<class PBASE>

Profile1DMapLitID GaudiHistos< PBASE >::m_profile1DMapLitID [mutable, private]

the actual storage/access of 1D profile histograms by unique literal ID

Definition at line 3317 of file GaudiHistos.h.

template<class PBASE>

Profile2DMapTitle GaudiHistos< PBASE >::m_profile2DMapTitle [mutable, private]

the actual storage/access of 2D profile histograms by unique title

Definition at line 3320 of file GaudiHistos.h.

template<class PBASE>

Profile2DMapNumID GaudiHistos< PBASE >::m_profile2DMapNumID [mutable, private]

the actual storage/access of 2D profile histograms by unique numeric ID

Definition at line 3322 of file GaudiHistos.h.

template<class PBASE>

Profile2DMapLitID GaudiHistos< PBASE >::m_profile2DMapLitID [mutable, private]

the actual storage/access of 2D profile histograms by unique literal ID

Definition at line 3324 of file GaudiHistos.h.

template<class PBASE>

std::string GaudiHistos< PBASE >::m_histo1DTableFormat [private]

format for printout of 1D-histograms as a table

Definition at line 3327 of file GaudiHistos.h.

template<class PBASE>

std::string GaudiHistos< PBASE >::m_histo1DTableFormatShort [private]

format for printout of 1D-histograms as a table

Definition at line 3329 of file GaudiHistos.h.

template<class PBASE>

std::string GaudiHistos< PBASE >::m_histo1DTableHeader [private]

the header for the table of 1-D historgrams

Definition at line 3331 of file GaudiHistos.h.

template<class PBASE>

bool GaudiHistos< PBASE >::m_useNumericAutoIDs [private]

Flag to switch back to the old style sequencial numerical automatic IDs.

Definition at line 3333 of file GaudiHistos.h.

template<class PBASE>

std::map<std::string,std::string> GaudiHistos< PBASE >::m_idReplaceInfo [private]

Map of strings to search and replace when using the title as the basis of automatically generated literal IDs.

Definition at line 3337 of file GaudiHistos.h.

---

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

• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v21r4/GaudiAlg/GaudiAlg/GaudiHistos.h
• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v21r4/GaudiAlg/GaudiAlg/GaudiHistos.icpp
• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v21r4/GaudiAlg/GaudiAlg/GaudiHistos_1DFixedBinning.icpp
• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v21r4/GaudiAlg/GaudiAlg/GaudiHistos_1DProfFixedBinning.icpp
• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v21r4/GaudiAlg/GaudiAlg/GaudiHistos_1DProfVariableBinning.icpp
• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v21r4/GaudiAlg/GaudiAlg/GaudiHistos_1DVariableBinning.icpp
• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v21r4/GaudiAlg/GaudiAlg/GaudiHistos_2DFixedBinning.icpp
• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v21r4/GaudiAlg/GaudiAlg/GaudiHistos_2DProfFixedBinning.icpp
• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v21r4/GaudiAlg/GaudiAlg/GaudiHistos_2DProfVariableBinning.icpp
• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v21r4/GaudiAlg/GaudiAlg/GaudiHistos_2DVariableBinning.icpp
• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v21r4/GaudiAlg/GaudiAlg/GaudiHistos_3DFixedBinning.icpp
• /afs/cern.ch/sw/Gaudi/releases/GAUDI/GAUDI_v21r4/GaudiAlg/GaudiAlg/GaudiHistos_3DVariableBinning.icpp