#include <DQMStore.h>

Public Types
enum	OpenRunDirs { KeepRunDirs, StripRunDirs }
enum	SaveReferenceTag { SaveWithoutReference, SaveWithReference, SaveWithReferenceForQTest }
Public Member Functions
MonitorElement *	book1D (const char name, const char title, int nchX, double lowX, double highX)
	Book 1D histogram.
MonitorElement *	book1D (const std::string &name, const std::string &title, int nchX, double lowX, double highX)
	Book 1D histogram.
MonitorElement *	book1D (const char name, const char title, int nchX, float *xbinsize)
	Book 1D variable bin histogram.
MonitorElement *	book1D (const std::string &name, const std::string &title, int nchX, float *xbinsize)
	Book 1D variable bin histogram.
MonitorElement *	book1D (const char name, TH1F h)
	Book 1D histogram by cloning an existing histogram.
MonitorElement *	book1D (const std::string &name, TH1F *h)
	Book 1D histogram by cloning an existing histogram.
MonitorElement *	book1DD (const char name, TH1D h)
	Book 1D double histogram by cloning an existing histogram.
MonitorElement *	book1DD (const std::string &name, TH1D *h)
	Book 1D double histogram by cloning an existing histogram.
MonitorElement *	book1DD (const char name, const char title, int nchX, double lowX, double highX)
	Book 1S histogram.
MonitorElement *	book1DD (const std::string &name, const std::string &title, int nchX, double lowX, double highX)
	Book 1S histogram.
MonitorElement *	book1DD (const char name, const char title, int nchX, float *xbinsize)
MonitorElement *	book1DD (const std::string &name, const std::string &title, int nchX, float *xbinsize)
MonitorElement *	book1S (const char name, const char title, int nchX, double lowX, double highX)
	Book 1S histogram.
MonitorElement *	book1S (const std::string &name, const std::string &title, int nchX, double lowX, double highX)
	Book 1S histogram.
MonitorElement *	book1S (const std::string &name, const std::string &title, int nchX, float *xbinsize)
MonitorElement *	book1S (const char name, TH1S h)
	Book 1S histogram by cloning an existing histogram.
MonitorElement *	book1S (const std::string &name, TH1S *h)
	Book 1S histogram by cloning an existing histogram.
MonitorElement *	book1S (const char name, const char title, int nchX, float *xbinsize)
MonitorElement *	book2D (const char name, const char title, int nchX, double lowX, double highX, int nchY, double lowY, double highY)
	Book 2D histogram.
MonitorElement *	book2D (const std::string &name, const std::string &title, int nchX, double lowX, double highX, int nchY, double lowY, double highY)
	Book 2D histogram.
MonitorElement *	book2D (const char name, const char title, int nchX, float xbinsize, int nchY, float ybinsize)
	Book 2D variable bin histogram.
MonitorElement *	book2D (const std::string &name, const std::string &title, int nchX, float xbinsize, int nchY, float ybinsize)
	Book 2D variable bin histogram.
MonitorElement *	book2D (const char name, TH2F h)
	Book 2D histogram by cloning an existing histogram.
MonitorElement *	book2D (const std::string &name, TH2F *h)
	Book 2D histogram by cloning an existing histogram.
MonitorElement *	book2DD (const char name, const char title, int nchX, double lowX, double highX, int nchY, double lowY, double highY)
	Book 2D double histogram.
MonitorElement *	book2DD (const std::string &name, const std::string &title, int nchX, double lowX, double highX, int nchY, double lowY, double highY)
	Book 2S histogram.
MonitorElement *	book2DD (const char name, const char title, int nchX, float xbinsize, int nchY, float ybinsize)
MonitorElement *	book2DD (const std::string &name, const std::string &title, int nchX, float xbinsize, int nchY, float ybinsize)
MonitorElement *	book2DD (const char name, TH2D h)
	Book 2DS histogram by cloning an existing histogram.
MonitorElement *	book2DD (const std::string &name, TH2D *h)
	Book 2DS histogram by cloning an existing histogram.
MonitorElement *	book2S (const char name, const char title, int nchX, double lowX, double highX, int nchY, double lowY, double highY)
	Book 2S histogram.
MonitorElement *	book2S (const std::string &name, const std::string &title, int nchX, double lowX, double highX, int nchY, double lowY, double highY)
	Book 2S histogram.
MonitorElement *	book2S (const char name, const char title, int nchX, float xbinsize, int nchY, float ybinsize)
MonitorElement *	book2S (const std::string &name, const std::string &title, int nchX, float xbinsize, int nchY, float ybinsize)
MonitorElement *	book2S (const char name, TH2S h)
	Book 2DS histogram by cloning an existing histogram.
MonitorElement *	book2S (const std::string &name, TH2S *h)
	Book 2DS histogram by cloning an existing histogram.
MonitorElement *	book3D (const char name, const char title, int nchX, double lowX, double highX, int nchY, double lowY, double highY, int nchZ, double lowZ, double highZ)
	Book 3D histogram.
MonitorElement *	book3D (const std::string &name, const std::string &title, int nchX, double lowX, double highX, int nchY, double lowY, double highY, int nchZ, double lowZ, double highZ)
	Book 3D histogram.
MonitorElement *	book3D (const char name, TH3F h)
	Book 3D histogram by cloning an existing histogram.
MonitorElement *	book3D (const std::string &name, TH3F *h)
	Book 3D histogram by cloning an existing histogram.
MonitorElement *	bookFloat (const char *name)
	Book float.
MonitorElement *	bookFloat (const std::string &name)
	Book float.
MonitorElement *	bookInt (const std::string &name)
	Book int.
MonitorElement *	bookInt (const char *name)
	Book int.
MonitorElement *	bookProfile (const char name, TProfile h)
	Book TProfile by cloning an existing profile.
MonitorElement *	bookProfile (const std::string &name, const std::string &title, int nchX, double lowX, double highX, double lowY, double highY, const char *option="s")
MonitorElement *	bookProfile (const std::string &name, TProfile *h)
	Book TProfile by cloning an existing profile.
MonitorElement *	bookProfile (const std::string &name, const std::string &title, int nchX, double xbinsize, double lowY, double highY, const char option="s")
MonitorElement *	bookProfile (const char name, const char title, int nchX, double lowX, double highX, int nchY, double lowY, double highY, const char *option="s")
MonitorElement *	bookProfile (const std::string &name, const std::string &title, int nchX, double lowX, double highX, int nchY, double lowY, double highY, const char *option="s")
MonitorElement *	bookProfile (const char name, const char title, int nchX, double lowX, double highX, double lowY, double highY, const char *option="s")
MonitorElement *	bookProfile (const char name, const char title, int nchX, double xbinsize, int nchY, double lowY, double highY, const char option="s")
MonitorElement *	bookProfile (const std::string &name, const std::string &title, int nchX, double xbinsize, int nchY, double lowY, double highY, const char option="s")
MonitorElement *	bookProfile (const char name, const char title, int nchX, double xbinsize, double lowY, double highY, const char option="s")
MonitorElement *	bookProfile2D (const char name, const char title, int nchX, double lowX, double highX, int nchY, double lowY, double highY, int nchZ, double lowZ, double highZ, const char *option="s")
MonitorElement *	bookProfile2D (const char name, const char title, int nchX, double lowX, double highX, int nchY, double lowY, double highY, double lowZ, double highZ, const char *option="s")
MonitorElement *	bookProfile2D (const std::string &name, const std::string &title, int nchX, double lowX, double highX, int nchY, double lowY, double highY, double lowZ, double highZ, const char *option="s")
MonitorElement *	bookProfile2D (const char name, TProfile2D h)
	Book TProfile2D by cloning an existing profile.
MonitorElement *	bookProfile2D (const std::string &name, TProfile2D *h)
	Book TProfile2D by cloning an existing profile.
MonitorElement *	bookProfile2D (const std::string &name, const std::string &title, int nchX, double lowX, double highX, int nchY, double lowY, double highY, int nchZ, double lowZ, double highZ, const char *option="s")
MonitorElement *	bookString (const std::string &name, const std::string &value)
	Book string.
MonitorElement *	bookString (const char name, const char value)
	Book string.
void	cd (void)
	go to top directory (ie. root)
void	cd (const std::string &subdir)
	cd to subdirectory (if there)
bool	containsAnyMonitorable (const std::string &path) const
QCriterion *	createQTest (const std::string &algoname, const std::string &qtname)
bool	dirExists (const std::string &path) const
	true if directory exists
void	disableSoftReset (MonitorElement *me)
	DQMStore (const edm::ParameterSet &pset)
MonitorElement *	get (const std::string &path) const
	get ME from full pathname (e.g. "my/long/dir/my_histo")
std::vector< MonitorElement * >	get (unsigned int tag) const
	get all MonitorElements tagged as <tag>
std::vector< MonitorElement * >	getAllContents (const std::string &path) const
void	getAllTags (std::vector< std::string > &into) const
void	getContents (std::vector< std::string > &into, bool showContents=true) const
std::vector< MonitorElement * >	getContents (const std::string &path, unsigned int tag) const
	same as above for tagged MonitorElements
std::vector< MonitorElement * >	getContents (const std::string &path) const
std::vector< MonitorElement * >	getMatchingContents (const std::string &pattern, lat::Regexp::Syntax syntaxType=lat::Regexp::Wildcard) const
std::vector< std::string >	getMEs (void) const
	get list of (non-dir) MEs of current directory
QCriterion *	getQCriterion (const std::string &qtname) const
int	getStatus (const std::string &path="") const
std::vector< std::string >	getSubdirs (void) const
void	goUp (void)
	equivalent to "cd .."
bool	load (const std::string &filename, OpenRunDirs stripdirs=StripRunDirs, bool fileMustExist=true)
bool	open (const std::string &filename, bool overwrite=false, const std::string &path="", const std::string &prepend="", OpenRunDirs stripdirs=KeepRunDirs, bool fileMustExist=true)
const std::string &	pwd (void) const
void	removeContents (void)
	erase all monitoring elements in current directory (not including subfolders);
void	removeContents (const std::string &dir)
	remove all monitoring elements from directory;
void	removeElement (const std::string &name)
void	removeElement (const std::string &dir, const std::string &name, bool warning=true)
void	rmdir (const std::string &fullpath)
void	runQTests (void)
void	save (const std::string &filename, const std::string &path="", const std::string &pattern="", const std::string &rewrite="", SaveReferenceTag ref=SaveWithReference, int minStatus=dqm::qstatus::STATUS_OK, const std::string &fileupdate="RECREATE")
void	setCurrentFolder (const std::string &fullpath)
void	setVerbose (unsigned level)
void	showDirStructure (void) const
void	softReset (MonitorElement *me)
void	tag (const std::string &path, unsigned int myTag)
	tag ME specified by full pathname (e.g. "my/long/dir/my_histo")
void	tag (MonitorElement *me, unsigned int myTag)
void	tagAllContents (const std::string &path, unsigned int myTag)
void	tagContents (const std::string &path, unsigned int myTag)
	tag all children of folder (does NOT include subfolders)
void	useQTest (const std::string &dir, const std::string &qtname)
int	useQTestByMatch (const std::string &pattern, const std::string &qtname)
	attach quality test <qc> to monitor elements matching <pattern>.
	~DQMStore (void)
Private Types
typedef std::set< MonitorElement >	MEMap
typedef std::map< std::string, QCriterion ()(const std::string &)	QAMap )
typedef std::map< std::string, QCriterion * >	QCMap
typedef std::pair< lat::Regexp , QCriterion >	QTestSpec
typedef std::list< QTestSpec >	QTestSpecs
Private Member Functions
MonitorElement *	book (const std::string &dir, const std::string &name, const char *context)
template<class HISTO , class COLLATE >
MonitorElement *	book (const std::string &dir, const std::string &name, const char context, int kind, HISTO h, COLLATE collate)
MonitorElement *	book1D (const std::string &dir, const std::string &name, TH1F *h)
	Book 1D histogram based on TH1F.
MonitorElement *	book1DD (const std::string &dir, const std::string &name, TH1D *h)
	Book 1D histogram based on TH1D.
MonitorElement *	book1S (const std::string &dir, const std::string &name, TH1S *h)
	Book 1D histogram based on TH1S.
MonitorElement *	book2D (const std::string &dir, const std::string &name, TH2F *h)
	Book 2D histogram based on TH2F.
MonitorElement *	book2DD (const std::string &dir, const std::string &name, TH2D *h)
	Book 2D histogram based on TH2D.
MonitorElement *	book2S (const std::string &dir, const std::string &name, TH2S *h)
	Book 2D histogram based on TH2S.
MonitorElement *	book3D (const std::string &dir, const std::string &name, TH3F *h)
	Book 3D histogram based on TH3F.
MonitorElement *	bookFloat (const std::string &dir, const std::string &name)
	Book float.
MonitorElement *	bookInt (const std::string &dir, const std::string &name)
	Book int.
MonitorElement *	bookProfile (const std::string &dir, const std::string &name, TProfile *h)
	Book profile histogram based on TProfile.
MonitorElement *	bookProfile2D (const std::string &folder, const std::string &name, TProfile2D *h)
	Book 2D profile histogram based on TProfile2D.
MonitorElement *	bookString (const std::string &dir, const std::string &name, const std::string &value)
	Book string.
bool	cdInto (const std::string &path) const
	DQMStore (const DQMStore &)
bool	extract (TObject *obj, const std::string &dir, bool overwrite)
MonitorElement *	findObject (const std::string &dir, const std::string &name) const
MonitorElement *	initialise (MonitorElement *me, const std::string &path)
bool	isCollateME (MonitorElement *me) const
void	makeDirectory (const std::string &path)
	get folder corresponding to inpath wrt to root (create subdirs if necessary)
const DQMStore &	operator= (const DQMStore &)
unsigned int	readDirectory (TFile *file, bool overwrite, const std::string &path, const std::string &prepend, const std::string &curdir, OpenRunDirs stripdirs)
bool	readFile (const std::string &filename, bool overwrite=false, const std::string &path="", const std::string &prepend="", OpenRunDirs stripdirs=StripRunDirs, bool fileMustExist=true)
void	reset (void)
void	setAccumulate (MonitorElement *me, bool flag)
Static Private Member Functions
static bool	checkBinningMatches (MonitorElement me, TH1 h)
static void	collate1D (MonitorElement me, TH1F h)
static void	collate1DD (MonitorElement me, TH1D h)
static void	collate1S (MonitorElement me, TH1S h)
static void	collate2D (MonitorElement me, TH2F h)
static void	collate2DD (MonitorElement me, TH2D h)
static void	collate2S (MonitorElement me, TH2S h)
static void	collate3D (MonitorElement me, TH3F h)
static void	collateProfile (MonitorElement me, TProfile h)
static void	collateProfile2D (MonitorElement me, TProfile2D h)
static DQMStore *	instance (void)
Private Attributes
bool	collateHistograms_
MEMap	data_
std::set< std::string >	dirs_
std::string	pwd_
QAMap	qalgos_
QCMap	qtests_
QTestSpecs	qtestspecs_
std::string	readSelectedDirectory_
bool	reset_
unsigned	verbose_
unsigned	verboseQT_
Friends
class	DQMNet
class	DQMOldReceiver
class	DQMService
class	DQMStoreExample
class	edm::DQMHttpSource

Detailed Description

Definition at line 35 of file DQMStore.h.

Member Typedef Documentation

typedef std::set<MonitorElement> DQMStore::MEMap [private]

Definition at line 412 of file DQMStore.h.

typedef std::map<std::string, QCriterion *(*)(const std::string &) DQMStore::QAMap) [private]

Definition at line 414 of file DQMStore.h.

typedef std::map<std::string, QCriterion *> DQMStore::QCMap [private]

Definition at line 413 of file DQMStore.h.

typedef std::pair<lat::Regexp *, QCriterion *> DQMStore::QTestSpec [private]

Definition at line 410 of file DQMStore.h.

typedef std::list<QTestSpec> DQMStore::QTestSpecs [private]

Definition at line 411 of file DQMStore.h.

Member Enumeration Documentation

enum DQMStore::OpenRunDirs

Enumerator:

KeepRunDirs
StripRunDirs

Definition at line 44 of file DQMStore.h.

  {
    KeepRunDirs,
    StripRunDirs
  };

enum DQMStore::SaveReferenceTag

Enumerator:

SaveWithoutReference
SaveWithReference
SaveWithReferenceForQTest

Definition at line 38 of file DQMStore.h.

  {
    SaveWithoutReference,
    SaveWithReference,
    SaveWithReferenceForQTest
  };

Constructor & Destructor Documentation

DQMStore::DQMStore ( const edm::ParameterSet & pset )

Definition at line 139 of file DQMStore.cc.

References collateHistograms_, gather_cfg::cout, edm::ParameterSet::getUntrackedParameter(), makeDirectory(), qalgos_, readFile(), reset(), s_referenceDirName, StripRunDirs, verbose_, and verboseQT_.

Referenced by instance().

  : verbose_ (1),
    verboseQT_ (1),
    reset_ (false),
    collateHistograms_ (false),
    readSelectedDirectory_ (""),
    pwd_ ("")
{
  assert(! s_instance);
  s_instance = this;
  makeDirectory("");
  reset();

  // set steerable parameters
  verbose_ = pset.getUntrackedParameter<int>("verbose", 0);
  if (verbose_ > 0)
    std::cout << "DQMStore: verbosity set to " << verbose_ << std::endl;
  
  verboseQT_ = pset.getUntrackedParameter<int>("verboseQT", 0);
  if (verbose_ > 0)
    std::cout << "DQMStore: QTest verbosity set to " << verboseQT_ << std::endl;
  
  collateHistograms_ = pset.getUntrackedParameter<bool>("collateHistograms", false);
  if (collateHistograms_)
    std::cout << "DQMStore: histogram collation is enabled\n";

  std::string ref = pset.getUntrackedParameter<std::string>("referenceFileName", "");
  if (! ref.empty())
  {
    std::cout << "DQMStore: using reference file '" << ref << "'\n";
    readFile(ref, true, "", s_referenceDirName, StripRunDirs, false);
  }  

  initQCriterion<Comp2RefChi2>(qalgos_);
  initQCriterion<Comp2RefKolmogorov>(qalgos_);
  initQCriterion<ContentsXRange>(qalgos_);
  initQCriterion<ContentsYRange>(qalgos_);
  initQCriterion<MeanWithinExpected>(qalgos_);
  initQCriterion<Comp2RefEqualH>(qalgos_);
  initQCriterion<DeadChannel>(qalgos_);
  initQCriterion<NoisyChannel>(qalgos_);
  initQCriterion<ContentsWithinExpected>(qalgos_);
  initQCriterion<CompareToMedian>(qalgos_);
}

DQMStore::~DQMStore ( void )

Definition at line 184 of file DQMStore.cc.

References ExpressReco_HICollisions_FallBack::e, i, if(), qtests_, and qtestspecs_.

{
  for (QCMap::iterator i = qtests_.begin(), e = qtests_.end(); i != e; ++i)
    delete i->second;

  for (QTestSpecs::iterator i = qtestspecs_.begin(), e = qtestspecs_.end(); i != e; ++i)
    delete i->first;

  if (s_instance == this)
    s_instance = 0;
}

DQMStore::DQMStore ( const DQMStore & ) [private]

Member Function Documentation

MonitorElement * DQMStore::book	(	const std::string &	dir,
		const std::string &	name,
		const char *	context
	)		`[private]`

Definition at line 376 of file DQMStore.cc.

References gather_cfg::cout, data_, dirs_, findObject(), mergePath(), AlCaRecoCosmics_cfg::name, path(), and verbose_.

Referenced by book1D(), book1DD(), book1S(), book2D(), book2DD(), book2S(), book3D(), bookFloat(), bookInt(), bookProfile(), bookProfile2D(), and bookString().

{
  assert(name.find('/') == std::string::npos);

  // Check if the request monitor element already exists.
  if (MonitorElement *me = findObject(dir, name))
  {
    if (verbose_ > 1)
    {
      std::string path;
      mergePath(path, dir, name);

      std::cout << "DQMStore: "
                << context << ": monitor element '"
                << path << "' already exists, resetting" << std::endl;
    }
    me->Reset();
    return me;
  }
  else
  {
    // Create it and return for initialisation.
    assert(dirs_.count(dir));
    MonitorElement me(&*dirs_.find(dir), name);
    return &const_cast<MonitorElement &>(*data_.insert(me).first);
  }
}

template<class HISTO , class COLLATE >

MonitorElement * DQMStore::book	(	const std::string &	dir,
		const std::string &	name,
		const char *	context,
		int	kind,
		HISTO *	h,
		COLLATE	collate
	)		`[private]`

Definition at line 309 of file DQMStore.cc.

References collateHistograms_, gather_cfg::cout, data_, dir, dirs_, DQMNet::DQM_PROP_HAS_REFERENCE, findObject(), h, initialise(), mergePath(), AlCaRecoCosmics_cfg::name, path(), qtestspecs_, s_referenceDirName, and verbose_.

{
  assert(name.find('/') == std::string::npos);
  std::string path;
  mergePath(path, dir, name);

  // Put us in charge of h.
  h->SetDirectory(0);

  // Check if the request monitor element already exists.
  if (MonitorElement *me = findObject(dir, name))
  {
    if (collateHistograms_)
    {
      collate(me, h);
      delete h;
      return me;
    }
    else
    {    
      if (verbose_ > 1)
        std::cout << "DQMStore: "
                  << context << ": monitor element '"
                  << path << "' already exists, collating" << std::endl;
      me->Reset();
      collate(me, h);
      delete h;
      return me;
    }
  }
  else
  {
    // Create and initialise core object.
    assert(dirs_.count(dir));
    MonitorElement proto(&*dirs_.find(dir), name);
    MonitorElement *me
      = const_cast<MonitorElement &>(*data_.insert(proto).first)
      .initialise((MonitorElement::Kind)kind, h);

    // Initialise quality test information.
    QTestSpecs::iterator qi = qtestspecs_.begin();
    QTestSpecs::iterator qe = qtestspecs_.end();
    for ( ; qi != qe; ++qi)
      if (qi->first->match(path))
        me->addQReport(qi->second);

    // Assign reference if we have one.
    std::string refdir;
    refdir.reserve(s_referenceDirName.size() + dir.size() + 2);
    refdir += s_referenceDirName;
    refdir += '/';
    refdir += dir;

    if (MonitorElement *refme = findObject(refdir, name))
    {
      me->data_.flags |= DQMNet::DQM_PROP_HAS_REFERENCE;
      me->reference_ = refme->object_;
    }

    // Return the monitor element.
    return me;
  }
}

MonitorElement * DQMStore::book1D	(	const char *	name,
		const char *	title,
		int	nchX,
		float *	xbinsize
	)

Book 1D variable bin histogram.

Definition at line 567 of file DQMStore.cc.

References book1D(), and pwd_.

{
  return book1D(pwd_, name, new TH1F(name, title, nchX, xbinsize));
}

MonitorElement * DQMStore::book1D	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		float *	xbinsize
	)

Book 1D variable bin histogram.

Definition at line 575 of file DQMStore.cc.

References book1D(), and pwd_.

{
  return book1D(pwd_, name, new TH1F(name.c_str(), title.c_str(), nchX, xbinsize));
}

MonitorElement * DQMStore::book1D	(	const char *	name,
		TH1F *	h
	)

Book 1D histogram by cloning an existing histogram.

Definition at line 583 of file DQMStore.cc.

References book1D(), and pwd_.

{
  return book1D(pwd_, name, static_cast<TH1F *>(source->Clone(name)));
}

MonitorElement * DQMStore::book1D	(	const std::string &	name,
		TH1F *	h
	)

Book 1D histogram by cloning an existing histogram.

Definition at line 590 of file DQMStore.cc.

References book1D(), and pwd_.

{
  return book1D(pwd_, name, static_cast<TH1F *>(source->Clone(name.c_str())));
}

MonitorElement * DQMStore::book1D	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		double	lowX,
		double	highX
	)

Book 1D histogram.

Definition at line 527 of file DQMStore.cc.

References book1D(), and pwd_.

{
  return book1D(pwd_, name, new TH1F(name.c_str(), title.c_str(), nchX, lowX, highX));
}

MonitorElement * DQMStore::book1D	(	const char *	name,
		const char *	title,
		int	nchX,
		double	lowX,
		double	highX
	)

Book 1D histogram.

Definition at line 519 of file DQMStore.cc.

References pwd_.

{
  return book1D(pwd_, name, new TH1F(name, title, nchX, lowX, highX));
}

MonitorElement * DQMStore::book1D	(	const std::string &	dir,
		const std::string &	name,
		TH1F *	h
	)		`[private]`

Book 1D histogram based on TH1F.

Definition at line 498 of file DQMStore.cc.

References book(), collate1D(), and MonitorElement::DQM_KIND_TH1F.

{
  return book(dir, name, "book1D", MonitorElement::DQM_KIND_TH1F, h, collate1D);
}

MonitorElement * DQMStore::book1DD	(	const char *	name,
		const char *	title,
		int	nchX,
		double	lowX,
		double	highX
	)

Book 1S histogram.

Definition at line 551 of file DQMStore.cc.

References pwd_.

Referenced by MEtoMEComparitor::book(), book1DD(), extract(), EDMtoMEConverter::getData(), EBOccupancyTask::setup(), and EEOccupancyTask::setup().

{
  return book1DD(pwd_, name, new TH1D(name, title, nchX, lowX, highX));
}

MonitorElement * DQMStore::book1DD	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		double	lowX,
		double	highX
	)

Book 1S histogram.

Definition at line 559 of file DQMStore.cc.

References book1DD(), and pwd_.

{
  return book1DD(pwd_, name, new TH1D(name.c_str(), title.c_str(), nchX, lowX, highX));
}

MonitorElement* DQMStore::book1DD	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		float *	xbinsize
	)

MonitorElement* DQMStore::book1DD	(	const char *	name,
		const char *	title,
		int	nchX,
		float *	xbinsize
	)

MonitorElement * DQMStore::book1DD	(	const std::string &	dir,
		const std::string &	name,
		TH1D *	h
	)		`[private]`

Book 1D histogram based on TH1D.

Definition at line 512 of file DQMStore.cc.

References book(), collate1DD(), and MonitorElement::DQM_KIND_TH1D.

{
  return book(dir, name, "book1DD", MonitorElement::DQM_KIND_TH1D, h, collate1DD);
}

MonitorElement * DQMStore::book1DD	(	const char *	name,
		TH1D *	h
	)

Book 1D double histogram by cloning an existing histogram.

Definition at line 611 of file DQMStore.cc.

References book1DD(), and pwd_.

{
  return book1DD(pwd_, name, static_cast<TH1D *>(source->Clone(name)));
}

MonitorElement * DQMStore::book1DD	(	const std::string &	name,
		TH1D *	h
	)

Book 1D double histogram by cloning an existing histogram.

Definition at line 618 of file DQMStore.cc.

References book1DD(), and pwd_.

{
  return book1DD(pwd_, name, static_cast<TH1D *>(source->Clone(name.c_str())));
}

MonitorElement * DQMStore::book1S	(	const char *	name,
		const char *	title,
		int	nchX,
		double	lowX,
		double	highX
	)

Book 1S histogram.

Definition at line 535 of file DQMStore.cc.

References pwd_.

Referenced by DQMSourceExample::beginJob(), MEtoMEComparitor::book(), book1S(), dqmRegisterHistogram(), extract(), and EDMtoMEConverter::getData().

{
  return book1S(pwd_, name, new TH1S(name, title, nchX, lowX, highX));
}

MonitorElement * DQMStore::book1S	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		double	lowX,
		double	highX
	)

Book 1S histogram.

Definition at line 543 of file DQMStore.cc.

References book1S(), and pwd_.

{
  return book1S(pwd_, name, new TH1S(name.c_str(), title.c_str(), nchX, lowX, highX));
}

MonitorElement* DQMStore::book1S	(	const char *	name,
		const char *	title,
		int	nchX,
		float *	xbinsize
	)

MonitorElement* DQMStore::book1S	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		float *	xbinsize
	)

MonitorElement * DQMStore::book1S	(	const std::string &	name,
		TH1S *	h
	)

Book 1S histogram by cloning an existing histogram.

Definition at line 604 of file DQMStore.cc.

References book1S(), and pwd_.

{
  return book1S(pwd_, name, static_cast<TH1S *>(source->Clone(name.c_str())));
}

MonitorElement * DQMStore::book1S	(	const char *	name,
		TH1S *	h
	)

Book 1S histogram by cloning an existing histogram.

Definition at line 597 of file DQMStore.cc.

References book1S(), and pwd_.

{
  return book1S(pwd_, name, static_cast<TH1S *>(source->Clone(name)));
}

MonitorElement * DQMStore::book1S	(	const std::string &	dir,
		const std::string &	name,
		TH1S *	h
	)		`[private]`

Book 1D histogram based on TH1S.

Definition at line 505 of file DQMStore.cc.

References book(), collate1S(), and MonitorElement::DQM_KIND_TH1S.

{
  return book(dir, name, "book1S", MonitorElement::DQM_KIND_TH1S, h, collate1S);
}

MonitorElement * DQMStore::book2D	(	const char *	name,
		const char *	title,
		int	nchX,
		double	lowX,
		double	highX,
		int	nchY,
		double	lowY,
		double	highY
	)

Book 2D histogram.

Definition at line 647 of file DQMStore.cc.

References pwd_.

{
  return book2D(pwd_, name, new TH2F(name, title,
                                     nchX, lowX, highX,
                                     nchY, lowY, highY));
}

MonitorElement * DQMStore::book2D	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		double	lowX,
		double	highX,
		int	nchY,
		double	lowY,
		double	highY
	)

Book 2D histogram.

Definition at line 658 of file DQMStore.cc.

References book2D(), and pwd_.

{
  return book2D(pwd_, name, new TH2F(name.c_str(), title.c_str(),
                                     nchX, lowX, highX,
                                     nchY, lowY, highY));
}

MonitorElement * DQMStore::book2D	(	const char *	name,
		const char *	title,
		int	nchX,
		float *	xbinsize,
		int	nchY,
		float *	ybinsize
	)

Book 2D variable bin histogram.

Definition at line 713 of file DQMStore.cc.

References book2D(), and pwd_.

{
  return book2D(pwd_, name, new TH2F(name, title, 
                                     nchX, xbinsize, nchY, ybinsize));
}

MonitorElement * DQMStore::book2D	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		float *	xbinsize,
		int	nchY,
		float *	ybinsize
	)

Book 2D variable bin histogram.

Definition at line 722 of file DQMStore.cc.

References book2D(), and pwd_.

{
  return book2D(pwd_, name, new TH2F(name.c_str(), title.c_str(), 
                                     nchX, xbinsize, nchY, ybinsize));
}

MonitorElement * DQMStore::book2D	(	const char *	name,
		TH2F *	h
	)

Book 2D histogram by cloning an existing histogram.

Definition at line 731 of file DQMStore.cc.

References book2D(), and pwd_.

{
  return book2D(pwd_, name, static_cast<TH2F *>(source->Clone(name)));
}

MonitorElement * DQMStore::book2D	(	const std::string &	name,
		TH2F *	h
	)

Book 2D histogram by cloning an existing histogram.

Definition at line 738 of file DQMStore.cc.

References book2D(), and pwd_.

{
  return book2D(pwd_, name, static_cast<TH2F *>(source->Clone(name.c_str())));
}

MonitorElement * DQMStore::book2D	(	const std::string &	dir,
		const std::string &	name,
		TH2F *	h
	)		`[private]`

Book 2D histogram based on TH2F.

Definition at line 626 of file DQMStore.cc.

References book(), collate2D(), and MonitorElement::DQM_KIND_TH2F.

{
  return book(dir, name, "book2D", MonitorElement::DQM_KIND_TH2F, h, collate2D);
}

MonitorElement * DQMStore::book2DD	(	const char *	name,
		const char *	title,
		int	nchX,
		double	lowX,
		double	highX,
		int	nchY,
		double	lowY,
		double	highY
	)

Book 2D double histogram.

Definition at line 691 of file DQMStore.cc.

References pwd_.

Referenced by book2DD(), extract(), and EDMtoMEConverter::getData().

{
  return book2DD(pwd_, name, new TH2D(name, title,
                                      nchX, lowX, highX,
                                      nchY, lowY, highY));
}

MonitorElement * DQMStore::book2DD	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		double	lowX,
		double	highX,
		int	nchY,
		double	lowY,
		double	highY
	)

Book 2S histogram.

Definition at line 702 of file DQMStore.cc.

References book2DD(), and pwd_.

{
  return book2DD(pwd_, name, new TH2D(name.c_str(), title.c_str(),
                                      nchX, lowX, highX,
                                      nchY, lowY, highY));
}

MonitorElement* DQMStore::book2DD	(	const char *	name,
		const char *	title,
		int	nchX,
		float *	xbinsize,
		int	nchY,
		float *	ybinsize
	)

MonitorElement* DQMStore::book2DD	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		float *	xbinsize,
		int	nchY,
		float *	ybinsize
	)

MonitorElement * DQMStore::book2DD	(	const char *	name,
		TH2D *	h
	)

Book 2DS histogram by cloning an existing histogram.

Definition at line 759 of file DQMStore.cc.

References book2DD(), and pwd_.

{
  return book2DD(pwd_, name, static_cast<TH2D *>(source->Clone(name)));
}

MonitorElement * DQMStore::book2DD	(	const std::string &	name,
		TH2D *	h
	)

Book 2DS histogram by cloning an existing histogram.

Definition at line 766 of file DQMStore.cc.

References book2DD(), and pwd_.

{
  return book2DD(pwd_, name, static_cast<TH2D *>(source->Clone(name.c_str())));
}

MonitorElement * DQMStore::book2DD	(	const std::string &	dir,
		const std::string &	name,
		TH2D *	h
	)		`[private]`

Book 2D histogram based on TH2D.

Definition at line 640 of file DQMStore.cc.

References book(), collate2DD(), and MonitorElement::DQM_KIND_TH2D.

{
  return book(dir, name, "book2DD", MonitorElement::DQM_KIND_TH2D, h, collate2DD);
}

MonitorElement * DQMStore::book2S	(	const char *	name,
		const char *	title,
		int	nchX,
		double	lowX,
		double	highX,
		int	nchY,
		double	lowY,
		double	highY
	)

Book 2S histogram.

Definition at line 669 of file DQMStore.cc.

References pwd_.

Referenced by book2S(), dqmRegisterHistogram(), extract(), and EDMtoMEConverter::getData().

{
  return book2S(pwd_, name, new TH2S(name, title,
                                     nchX, lowX, highX,
                                     nchY, lowY, highY));
}

MonitorElement * DQMStore::book2S	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		double	lowX,
		double	highX,
		int	nchY,
		double	lowY,
		double	highY
	)

Book 2S histogram.

Definition at line 680 of file DQMStore.cc.

References book2S(), and pwd_.

{
  return book2S(pwd_, name, new TH2S(name.c_str(), title.c_str(),
                                     nchX, lowX, highX,
                                     nchY, lowY, highY));
}

MonitorElement* DQMStore::book2S	(	const char *	name,
		const char *	title,
		int	nchX,
		float *	xbinsize,
		int	nchY,
		float *	ybinsize
	)

MonitorElement* DQMStore::book2S	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		float *	xbinsize,
		int	nchY,
		float *	ybinsize
	)

MonitorElement * DQMStore::book2S	(	const char *	name,
		TH2S *	h
	)

Book 2DS histogram by cloning an existing histogram.

Definition at line 745 of file DQMStore.cc.

References book2S(), and pwd_.

{
  return book2S(pwd_, name, static_cast<TH2S *>(source->Clone(name)));
}

MonitorElement * DQMStore::book2S	(	const std::string &	name,
		TH2S *	h
	)

Book 2DS histogram by cloning an existing histogram.

Definition at line 752 of file DQMStore.cc.

References book2S(), and pwd_.

{
  return book2S(pwd_, name, static_cast<TH2S *>(source->Clone(name.c_str())));
}

MonitorElement * DQMStore::book2S	(	const std::string &	dir,
		const std::string &	name,
		TH2S *	h
	)		`[private]`

Book 2D histogram based on TH2S.

Definition at line 633 of file DQMStore.cc.

References book(), collate2S(), and MonitorElement::DQM_KIND_TH2S.

{
  return book(dir, name, "book2S", MonitorElement::DQM_KIND_TH2S, h, collate2S);
}

MonitorElement * DQMStore::book3D	(	const char *	name,
		const char *	title,
		int	nchX,
		double	lowX,
		double	highX,
		int	nchY,
		double	lowY,
		double	highY,
		int	nchZ,
		double	lowZ,
		double	highZ
	)

Book 3D histogram.

Definition at line 781 of file DQMStore.cc.

References pwd_.

Referenced by ConverterTester::beginJob(), L1TdeECAL::beginJob(), book3D(), SiStripMonitorTrack::bookME3D(), CSCMonitorModule::bookMonitorObject(), CaloJetTester::CaloJetTester(), dqmRegisterHistogram(), BTagValidator::endJob(), extract(), EDMtoMEConverter::getData(), GlobalHitsTester::GlobalHitsTester(), JPTJetTester::JPTJetTester(), PFJetTester::PFJetTester(), CastorEventDisplay::setup(), EBTriggerTowerTask::setup(), and EETriggerTowerTask::setup().

{
  return book3D(pwd_, name, new TH3F(name, title,
                                     nchX, lowX, highX,
                                     nchY, lowY, highY,
                                     nchZ, lowZ, highZ));
}

MonitorElement * DQMStore::book3D	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		double	lowX,
		double	highX,
		int	nchY,
		double	lowY,
		double	highY,
		int	nchZ,
		double	lowZ,
		double	highZ
	)

Book 3D histogram.

Definition at line 794 of file DQMStore.cc.

References book3D(), and pwd_.

{
  return book3D(pwd_, name, new TH3F(name.c_str(), title.c_str(),
                                     nchX, lowX, highX,
                                     nchY, lowY, highY,
                                     nchZ, lowZ, highZ));
}

MonitorElement * DQMStore::book3D	(	const char *	name,
		TH3F *	h
	)

Book 3D histogram by cloning an existing histogram.

Definition at line 807 of file DQMStore.cc.

References book3D(), and pwd_.

{
  return book3D(pwd_, name, static_cast<TH3F *>(source->Clone(name)));
}

MonitorElement * DQMStore::book3D	(	const std::string &	name,
		TH3F *	h
	)

Book 3D histogram by cloning an existing histogram.

Definition at line 814 of file DQMStore.cc.

References book3D(), and pwd_.

{
  return book3D(pwd_, name, static_cast<TH3F *>(source->Clone(name.c_str())));
}

MonitorElement * DQMStore::book3D	(	const std::string &	dir,
		const std::string &	name,
		TH3F *	h
	)		`[private]`

Book 3D histogram based on TH3F.

Definition at line 774 of file DQMStore.cc.

References book(), collate3D(), and MonitorElement::DQM_KIND_TH3F.

{
  return book(dir, name, "book3D", MonitorElement::DQM_KIND_TH3F, h, collate3D);
}

MonitorElement * DQMStore::bookFloat ( const std::string & name )

Book float.

Definition at line 461 of file DQMStore.cc.

References bookFloat(), and pwd_.

{
  return bookFloat(pwd_, name);
}

MonitorElement * DQMStore::bookFloat	(	const std::string &	dir,
		const std::string &	name
	)		`[private]`

Book float.

Definition at line 439 of file DQMStore.cc.

References book(), collateHistograms_, MonitorElement::DQM_KIND_REAL, MonitorElement::Fill(), findObject(), and MonitorElement::initialise().

{
  if (collateHistograms_)
  {
    if (MonitorElement *me = findObject(dir, name))
    {
      me->Fill(0.);
      return me;
    }
  }

  return book(dir, name, "bookFloat")
    ->initialise(MonitorElement::DQM_KIND_REAL);
}

MonitorElement * DQMStore::bookFloat ( const char * name )

Book float.

Definition at line 456 of file DQMStore.cc.

References pwd_.

Referenced by EcalBarrelMonitorClient::beginJob(), EEDaqInfoTask::beginJob(), EEDcsInfoTask::beginJob(), Vx3DHLTAnalyzer::beginJob(), HcalDCSInfo::beginJob(), DQMFEDIntegrityClient::beginJob(), HcalDAQInfo::beginJob(), L1TEventInfoClient::beginJob(), RPCDaqInfo::beginJob(), ConverterTester::beginJob(), EBDataCertificationTask::beginJob(), EcalEndcapMonitorClient::beginJob(), EBDaqInfoTask::beginJob(), EBDcsInfoTask::beginJob(), L1TEMUEventInfoClient::beginJob(), SiPixelDaqInfo::beginJob(), SiPixelDcsInfo::beginJob(), DQMOfflineHLTEventInfoClient::beginJob(), HcalDataCertification::beginJob(), SiPixelCertification::beginJob(), BeamMonitor::beginJob(), EEDataCertificationTask::beginJob(), DQMDaqInfo::beginJob(), DQMSourceExample::beginJob(), HLTMonElectronConsumer::beginJob(), HLTEventInfoClient::beginJob(), ZDCMonitorClient::beginRun(), DTOfflineSummaryClients::beginRun(), DQMProvInfo::beginRun(), RPCEventSummary::beginRun(), RPCDataCertification::beginRun(), HcalSummaryClient::beginRun(), DTSummaryClients::beginRun(), RPCDCSSummary::beginRun(), JetMETHLTOfflineSource::beginRun(), bookFloat(), EcalSelectiveReadoutValidation::bookFloat(), SiPixelDataQuality::bookGlobalQualityFlag(), DTLocalTriggerSynchTask::bookHistos(), CSCMonitorModule::bookMonitorObject(), CSCOfflineClient::bookMonitorObject(), SiStripCertificationInfo::bookSiStripCertificationMEs(), SiStripDcsInfo::bookStatus(), SiStripQualityChecker::bookStatus(), SiStripDaqInfo::bookStatus(), SiStripCertificationInfo::bookTrackingCertificationMEs(), QcdUeDQM::createHistos(), QcdLowPtDQM::createHistos(), DQMEventInfo::DQMEventInfo(), DataCertificationJetMET::endRun(), DQMDcsInfoClient::endRun(), HLTTauCertifier::endRun(), PhotonDataCertification::endRun(), HLTMuonCertSummary::endRun(), HLTOverallSummary::endRun(), extract(), EDMtoMEConverter::getData(), GlobalHitsTester::GlobalHitsTester(), HcalTimingMonitorModule::HcalTimingMonitorModule(), HLTMuonValidator::initializeHists(), EgHLTOfflineSummaryClient::runClient_(), DQMFileSaver::saveForOffline(), HcalRecHitMonitor::setup(), HcalCoarsePedestalMonitor::setup(), CastorChannelQualityMonitor::setup(), HcalDeadCellMonitor::setup(), HcalHotCellMonitor::setup(), CastorPSMonitor::setup(), HLXMonitor::SetupEventInfo(), PFMETDQMAnalyzer::storeBadEvents(), PFJetDQMAnalyzer::storeBadEvents(), SubTaskSummaryStatus::WriteThreshold(), and XmasToDQMEventInfo::XmasToDQMEventInfo().

{ return bookFloat(pwd_, name); }

MonitorElement * DQMStore::bookInt ( const char * name )

Book int.

Definition at line 426 of file DQMStore.cc.

References pwd_.

Referenced by SiStripDcsInfo::addBadModules(), L1Scalers::beginJob(), ConverterTester::beginJob(), PhotonAnalyzer::beginJob(), HLTScalers::beginJob(), CastorMonitorModule::beginJob(), L1TLTC::beginJob(), DQMSourceExample::beginJob(), EgHLTOfflineSource::beginJob(), ZDCMonitorModule::beginRun(), DQMProvInfo::beginRun(), HcalDetDiagPedestalMonitor::beginRun(), HcalDetDiagLaserMonitor::beginRun(), FineDelayTask::book(), CalibrationTask::book(), CalibrationScanTask::book(), SiPixelDataQuality::bookGlobalQualityFlag(), bookInt(), CSCMonitorModule::bookMonitorObject(), CSCOfflineClient::bookMonitorObject(), CommissioningHistograms::copyCustomInformation(), DQMEventInfo::DQMEventInfo(), HLTOverallSummary::endRun(), extract(), SiStripQualityChecker::fillFaultyModuleStatus(), SiStripDaqInfo::findExcludedModule(), EDMtoMEConverter::getData(), GlobalHitsTester::GlobalHitsTester(), DQMProvInfo::makeProvInfo(), CastorLEDMonitor::setup(), EcalBarrelMonitorModule::setup(), HcalEEUSMonitor::setup(), HcalZDCMonitor::setup(), HcalDetDiagNoiseMonitor::setup(), HcalDigiMonitor::setup(), HcalCoarsePedestalMonitor::setup(), CastorEventDisplay::setup(), HcalRawDataMonitor::setup(), CastorHIMonitor::setup(), HcalDetDiagLEDMonitor::setup(), CastorRecHitMonitor::setup(), EcalEndcapMonitorModule::setup(), HcalMonitorModule::setup(), HcalDeadCellMonitor::setup(), CastorDigiMonitor::setup(), HcalCaloTowerMonitor::setup(), HcalBaseDQMonitor::setup(), HcalHotCellMonitor::setup(), CastorPSMonitor::setup(), HLXMonitor::SetupEventInfo(), and XmasToDQMEventInfo::XmasToDQMEventInfo().

{ return bookInt(pwd_, name); }

MonitorElement * DQMStore::bookInt ( const std::string & name )

Book int.

Definition at line 431 of file DQMStore.cc.

References bookInt(), and pwd_.

{
  return bookInt(pwd_, name);
}

MonitorElement * DQMStore::bookInt	(	const std::string &	dir,
		const std::string &	name
	)		`[private]`

Book int.

Definition at line 409 of file DQMStore.cc.

References book(), collateHistograms_, MonitorElement::DQM_KIND_INT, MonitorElement::Fill(), findObject(), and MonitorElement::initialise().

{
  if (collateHistograms_)
  {
    if (MonitorElement *me = findObject(dir, name))
    {
      me->Fill(0);
      return me;
    }
  }

  return book(dir, name, "bookInt")
    ->initialise(MonitorElement::DQM_KIND_INT);
}

MonitorElement * DQMStore::bookProfile	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		double *	xbinsize,
		double	lowY,
		double	highY,
		const char *	option = `"s"`
	)

Book variable bin profile. Option is one of: " ", "s" (default), "i", "G" (see TProfile::BuildOptions). The number of channels in Y is disregarded in a profile plot.

Definition at line 938 of file DQMStore.cc.

References bookProfile(), and pwd_.

{
  return bookProfile(pwd_, name, new TProfile(name.c_str(), title.c_str(),
                                              nchX, xbinsize,
                                              lowY, highY,
                                              option));
}

MonitorElement * DQMStore::bookProfile	(	const std::string &	dir,
		const std::string &	name,
		TProfile *	h
	)		`[private]`

Book profile histogram based on TProfile.

Definition at line 822 of file DQMStore.cc.

References book(), collateProfile(), and MonitorElement::DQM_KIND_TPROFILE.

{
  return book(dir, name, "bookProfile",
              MonitorElement::DQM_KIND_TPROFILE,
              h, collateProfile);
}

MonitorElement * DQMStore::bookProfile	(	const char *	name,
		const char *	title,
		int	nchX,
		double	lowX,
		double	highX,
		int	nchY,
		double	lowY,
		double	highY,
		const char *	option = `"s"`
	)

Book profile. Option is one of: " ", "s" (default), "i", "G" (see TProfile::BuildOptions). The number of channels in Y is disregarded in a profile plot.

Definition at line 833 of file DQMStore.cc.

References pwd_.

Referenced by HLTMuonDQMSource::beginJob(), BxTiming::beginJob(), TrackAnalyzer::beginJob(), PFJetAnalyzer::beginJob(), HaloTrigger::beginJob(), L1TFED::beginJob(), L1TCSCTF::beginJob(), ConverterTester::beginJob(), MBUEandQCDValidation::beginJob(), AlcaBeamMonitor::beginJob(), L1TGT::beginJob(), PhotonValidator::beginJob(), TrackBuildingAnalyzer::beginJob(), ZdcSimHitStudy::beginJob(), TkConvValidator::beginJob(), HcalSimHitStudy::beginJob(), BeamMonitor::beginJob(), DQMSourceExample::beginJob(), JetAnalyzer::beginJob(), AlcaBeamMonitor::beginRun(), SiStripLAProfileBooker::beginRun(), MuonTrackValidator::beginRun(), PhotonOfflineClient::book2DHistoVector(), PhotonOfflineClient::book3DHistoVector(), L1TGMT::book_(), HLTTauDQMSummaryPlotter::bookEfficiencyHisto(), HltSusyExoPostProcessor::bookEffMEProfileFromTH1(), TrackAnalyzer::bookHistosForState(), SiStripMonitorTrack::bookMEProfile(), SiStripMonitorTrack::bookMETrend(), SiStripMonitorDigi::bookMETrend(), SiStripMonitorCluster::bookMETrend(), CSCMonitorModule::bookMonitorObject(), HcalSubdetDigiMonitor::bookProfile(), EcalSelectiveReadoutValidation::bookProfile(), bookProfile(), HistoProviderDQM::bookProfile(), QcdUeDQM::bookProfile(), JPTJetAnalyzer::bookProfile(), MTVHistoProducerAlgoForTracker::bookRecoHistosForStandaloneRunning(), SiStripBaseCondObjDQM::bookSummaryMEs(), SiStripBaseCondObjDQM::bookSummaryProfileMEs(), HLTTauDQMSummaryPlotter::bookTriggerBitEfficiencyHistos(), DQMGenericTnPClient::calculateEfficiency(), HeavyFlavorHarvesting::calculateEfficiency1D(), CaloJetTester::CaloJetTester(), CaloTowersValidation::CaloTowersValidation(), SiStripMonitorCluster::createLayerMEs(), SiStripMonitorDigi::createLayerMEs(), SiStripMonitorDigi::createMEs(), SiStripMonitorPedestals::createMEs(), SiStripMonitorCluster::createModuleMEs(), SiStripMonitorCluster::createSubDetMEs(), SiStripMonitorDigi::createSubDetMEs(), TrackAnalyzer::doTrackerSpecificInitialization(), dqmRegisterHistogram(), JetMETDQMPostProcessor::endRun(), HltSusyExoPostProcessor::endRun(), extract(), EDMtoMEConverter::getData(), GlobalDigisAnalyzer::GlobalDigisAnalyzer(), GlobalDigisHistogrammer::GlobalDigisHistogrammer(), GlobalHitsTester::GlobalHitsTester(), HcalRecHitsValidation::HcalRecHitsValidation(), HcalSimHitsValidation::HcalSimHitsValidation(), CommissioningHistograms::histogram(), MuIsoValidation::InitHistos(), JPTJetTester::JPTJetTester(), MixCollectionValidation::MixCollectionValidation(), MonitorElementsDb::MonitorElementsDb(), PFJetTester::PFJetTester(), EBClusterTask::setup(), EBTestPulseTask::setup(), EBTimingTask::setup(), EETrendClient::setup(), EcalBarrelMonitorModule::setup(), EBTrendTask::setup(), HcalNZSMonitor::setup(), HcalDigiMonitor::setup(), HcalRecHitMonitor::setup(), EBPedestalTask::setup(), EBSelectiveReadoutTask::setup(), EELaserTask::setup(), EBTrendClient::setup(), EEBeamCaloTask::setup(), HcalBeamMonitor::setup(), HcalRawDataMonitor::setup(), EBTriggerTowerTask::setup(), EESelectiveReadoutTask::setup(), EBBeamCaloTask::setup(), EBLaserTask::setup(), EcalEndcapMonitorModule::setup(), HcalDeadCellMonitor::setup(), EBSummaryClient::setup(), EETrendTask::setup(), EETimingTask::setup(), EETriggerTowerTask::setup(), HcalCaloTowerMonitor::setup(), EELedTask::setup(), EEPedestalTask::setup(), EETestPulseTask::setup(), HcalHotCellMonitor::setup(), HcalTrigPrimMonitor::setup(), EESummaryClient::setup(), EEClusterTask::setup(), and HLXMonitor::SetupHists().

{
  return bookProfile(pwd_, name, new TProfile(name, title,
                                              nchX, lowX, highX,
                                              lowY, highY,
                                              option));
}

MonitorElement * DQMStore::bookProfile	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		double	lowX,
		double	highX,
		int	nchY,
		double	lowY,
		double	highY,
		const char *	option = `"s"`
	)

Book profile. Option is one of: " ", "s" (default), "i", "G" (see TProfile::BuildOptions). The number of channels in Y is disregarded in a profile plot.

Definition at line 848 of file DQMStore.cc.

References bookProfile(), and pwd_.

{
  return bookProfile(pwd_, name, new TProfile(name.c_str(), title.c_str(),
                                              nchX, lowX, highX,
                                              lowY, highY,
                                              option));
}

MonitorElement * DQMStore::bookProfile	(	const char *	name,
		const char *	title,
		int	nchX,
		double	lowX,
		double	highX,
		double	lowY,
		double	highY,
		const char *	option = `"s"`
	)

Book profile. Option is one of: " ", "s" (default), "i", "G" (see TProfile::BuildOptions). The number of channels in Y is disregarded in a profile plot.

Definition at line 863 of file DQMStore.cc.

References bookProfile(), and pwd_.

{
  return bookProfile(pwd_, name, new TProfile(name, title,
                                              nchX, lowX, highX,
                                              lowY, highY,
                                              option));
}

MonitorElement * DQMStore::bookProfile	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		double	lowX,
		double	highX,
		double	lowY,
		double	highY,
		const char *	option = `"s"`
	)

Book profile. Option is one of: " ", "s" (default), "i", "G" (see TProfile::BuildOptions). The number of channels in Y is disregarded in a profile plot.

Definition at line 878 of file DQMStore.cc.

References bookProfile(), and pwd_.

{
  return bookProfile(pwd_, name, new TProfile(name.c_str(), title.c_str(),
                                              nchX, lowX, highX,
                                              lowY, highY,
                                              option));
}

MonitorElement * DQMStore::bookProfile	(	const char *	name,
		const char *	title,
		int	nchX,
		double *	xbinsize,
		int	nchY,
		double	lowY,
		double	highY,
		const char *	option = `"s"`
	)

Book variable bin profile. Option is one of: " ", "s" (default), "i", "G" (see TProfile::BuildOptions). The number of channels in Y is disregarded in a profile plot.

Definition at line 893 of file DQMStore.cc.

References bookProfile(), and pwd_.

{
  return bookProfile(pwd_, name, new TProfile(name, title,
                                              nchX, xbinsize,
                                              lowY, highY,
                                              option));
}

MonitorElement * DQMStore::bookProfile	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		double *	xbinsize,
		int	nchY,
		double	lowY,
		double	highY,
		const char *	option = `"s"`
	)

Book variable bin profile. Option is one of: " ", "s" (default), "i", "G" (see TProfile::BuildOptions). The number of channels in Y is disregarded in a profile plot.

Definition at line 908 of file DQMStore.cc.

References bookProfile(), and pwd_.

{
  return bookProfile(pwd_, name, new TProfile(name.c_str(), title.c_str(),
                                              nchX, xbinsize,
                                              lowY, highY,
                                              option));
}

MonitorElement * DQMStore::bookProfile	(	const char *	name,
		const char *	title,
		int	nchX,
		double *	xbinsize,
		double	lowY,
		double	highY,
		const char *	option = `"s"`
	)

Book variable bin profile. Option is one of: " ", "s" (default), "i", "G" (see TProfile::BuildOptions). The number of channels in Y is disregarded in a profile plot.

Definition at line 923 of file DQMStore.cc.

References bookProfile(), and pwd_.

{
  return bookProfile(pwd_, name, new TProfile(name, title,
                                              nchX, xbinsize,
                                              lowY, highY,
                                              option));
}

MonitorElement * DQMStore::bookProfile	(	const char *	name,
		TProfile *	h
	)

Book TProfile by cloning an existing profile.

Definition at line 951 of file DQMStore.cc.

References bookProfile(), and pwd_.

{
  return bookProfile(pwd_, name, static_cast<TProfile *>(source->Clone(name)));
}

MonitorElement * DQMStore::bookProfile	(	const std::string &	name,
		TProfile *	h
	)

Book TProfile by cloning an existing profile.

Definition at line 958 of file DQMStore.cc.

References bookProfile(), and pwd_.

{
  return bookProfile(pwd_, name, static_cast<TProfile *>(source->Clone(name.c_str())));
}

MonitorElement * DQMStore::bookProfile2D	(	const char *	name,
		const char *	title,
		int	nchX,
		double	lowX,
		double	highX,
		int	nchY,
		double	lowY,
		double	highY,
		int	nchZ,
		double	lowZ,
		double	highZ,
		const char *	option = `"s"`
	)

Book 2-D profile. Option is one of: " ", "s" (default), "i", "G" (see TProfile2D::BuildOptions). The number of channels in Z is disregarded in a 2-D profile.

Definition at line 977 of file DQMStore.cc.

References pwd_.

Referenced by ConverterTester::beginJob(), TkConvValidator::beginJob(), DQMSourceExample::beginJob(), L1TdeECAL::beginJob(), MuonTrackValidator::beginRun(), CSCMonitorModule::bookMonitorObject(), bookProfile2D(), EcalSelectiveReadoutValidation::bookProfile2D(), MTVHistoProducerAlgoForTracker::bookRecoHistos(), DQMGenericTnPClient::calculateEfficiency(), HeavyFlavorHarvesting::calculateEfficiency2D(), CaloJetTester::CaloJetTester(), SiStripMonitorCluster::createSubDetMEs(), TkHistoMap::createTkHistoMap(), dqmRegisterHistogram(), extract(), EDMtoMEConverter::getData(), GlobalHitsTester::GlobalHitsTester(), JPTJetTester::JPTJetTester(), MonitorElementsDb::MonitorElementsDb(), HeavyFlavorValidation::myBookProfile2D(), PFJetTester::PFJetTester(), EBClusterTask::setup(), EBTestPulseTask::setup(), EBTimingTask::setup(), EEPedestalOnlineTask::setup(), EBPedestalTask::setup(), EBSelectiveReadoutTask::setup(), EBOccupancyTask::setup(), EELaserTask::setup(), EBCosmicTask::setup(), EBTriggerTowerTask::setup(), EESelectiveReadoutTask::setup(), EBLaserTask::setup(), EECosmicTask::setup(), EBPedestalOnlineTask::setup(), EEOccupancyTask::setup(), EETimingTask::setup(), EETriggerTowerTask::setup(), EELedTask::setup(), EEPedestalTask::setup(), EETestPulseTask::setup(), and EEClusterTask::setup().

{
  return bookProfile2D(pwd_, name, new TProfile2D(name, title,
                                                  nchX, lowX, highX,
                                                  nchY, lowY, highY,
                                                  lowZ, highZ,
                                                  option));
}

MonitorElement * DQMStore::bookProfile2D	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		double	lowX,
		double	highX,
		int	nchY,
		double	lowY,
		double	highY,
		int	nchZ,
		double	lowZ,
		double	highZ,
		const char *	option = `"s"`
	)

Book 2-D profile. Option is one of: " ", "s" (default), "i", "G" (see TProfile2D::BuildOptions). The number of channels in Z is disregarded in a 2-D profile.

Definition at line 994 of file DQMStore.cc.

References bookProfile2D(), and pwd_.

{
  return bookProfile2D(pwd_, name, new TProfile2D(name.c_str(), title.c_str(),
                                                  nchX, lowX, highX,
                                                  nchY, lowY, highY,
                                                  lowZ, highZ,
                                                  option));
}

MonitorElement * DQMStore::bookProfile2D	(	const char *	name,
		const char *	title,
		int	nchX,
		double	lowX,
		double	highX,
		int	nchY,
		double	lowY,
		double	highY,
		double	lowZ,
		double	highZ,
		const char *	option = `"s"`
	)

Book 2-D profile. Option is one of: " ", "s" (default), "i", "G" (see TProfile2D::BuildOptions). The number of channels in Z is disregarded in a 2-D profile.

Definition at line 1011 of file DQMStore.cc.

References bookProfile2D(), and pwd_.

{
  return bookProfile2D(pwd_, name, new TProfile2D(name, title,
                                                  nchX, lowX, highX,
                                                  nchY, lowY, highY,
                                                  lowZ, highZ,
                                                  option));
}

MonitorElement * DQMStore::bookProfile2D	(	const std::string &	name,
		const std::string &	title,
		int	nchX,
		double	lowX,
		double	highX,
		int	nchY,
		double	lowY,
		double	highY,
		double	lowZ,
		double	highZ,
		const char *	option = `"s"`
	)

Book 2-D profile. Option is one of: " ", "s" (default), "i", "G" (see TProfile2D::BuildOptions). The number of channels in Z is disregarded in a 2-D profile.

Definition at line 1028 of file DQMStore.cc.

References bookProfile2D(), and pwd_.

{
  return bookProfile2D(pwd_, name, new TProfile2D(name.c_str(), title.c_str(),
                                                  nchX, lowX, highX,
                                                  nchY, lowY, highY,
                                                  lowZ, highZ,
                                                  option));
}

MonitorElement * DQMStore::bookProfile2D	(	const char *	name,
		TProfile2D *	h
	)

Book TProfile2D by cloning an existing profile.

Definition at line 1043 of file DQMStore.cc.

References bookProfile2D(), and pwd_.

{
  return bookProfile2D(pwd_, name, static_cast<TProfile2D *>(source->Clone(name)));
}

MonitorElement * DQMStore::bookProfile2D	(	const std::string &	name,
		TProfile2D *	h
	)

Book TProfile2D by cloning an existing profile.

Definition at line 1050 of file DQMStore.cc.

References bookProfile2D(), and pwd_.

{
  return bookProfile2D(pwd_, name, static_cast<TProfile2D *>(source->Clone(name.c_str())));
}

MonitorElement * DQMStore::bookProfile2D	(	const std::string &	folder,
		const std::string &	name,
		TProfile2D *	h
	)		`[private]`

Book 2D profile histogram based on TProfile2D.

Definition at line 966 of file DQMStore.cc.

References book(), collateProfile2D(), and MonitorElement::DQM_KIND_TPROFILE2D.

{
  return book(dir, name, "bookProfile2D",
              MonitorElement::DQM_KIND_TPROFILE2D,
              h, collateProfile2D);
}

MonitorElement * DQMStore::bookString	(	const std::string &	dir,
		const std::string &	name,
		const std::string &	value
	)		`[private]`

Book string.

Definition at line 469 of file DQMStore.cc.

References book(), collateHistograms_, MonitorElement::DQM_KIND_STRING, findObject(), and MonitorElement::initialise().

{
  if (collateHistograms_)
  {
    if (MonitorElement *me = findObject(dir, name))
      return me;
  }

  return book(dir, name, "bookString")
    ->initialise(MonitorElement::DQM_KIND_STRING, value);
}

MonitorElement * DQMStore::bookString	(	const char *	name,
		const char *	value
	)

Book string.

Definition at line 485 of file DQMStore.cc.

References pwd_.

Referenced by HLTMuonDQMSource::beginJob(), ConverterTester::beginJob(), DQMSourceExample::beginJob(), DQMFileReader::beginJob(), TopTrigAnalyzer::beginRun(), BPAGTrigAnalyzer::beginRun(), HcalDetDiagPedestalMonitor::beginRun(), OfflineDQMMuonTrigAnalyzer::beginRun(), HcalDetDiagLaserMonitor::beginRun(), HcalRecHitMonitor::beginRun(), CSCMonitorModule::bookMonitorObject(), CSCOfflineClient::bookMonitorObject(), bookString(), SiStripCommissioningSource::createRunNumber(), SiStripCommissioningSource::createTask(), DQMEventInfo::DQMEventInfo(), extract(), EDMtoMEConverter::getData(), GlobalHitsTester::GlobalHitsTester(), DQMProvInfo::makeHLTKeyInfo(), DQMProvInfo::makeProvInfo(), CommissioningHistograms::runNumber(), CommissioningHistograms::runType(), DQMFileSaver::saveForOffline(), HcalDetDiagLEDMonitor::setup(), HLXMonitor::SetupEventInfo(), and XmasToDQMEventInfo::XmasToDQMEventInfo().

{ return bookString(pwd_, name, value); }

MonitorElement * DQMStore::bookString	(	const std::string &	name,
		const std::string &	value
	)

Book string.

Definition at line 490 of file DQMStore.cc.

References bookString(), and pwd_.

{
  return bookString(pwd_, name, value);
}

void DQMStore::cd ( void )

go to top directory (ie. root)

Definition at line 214 of file DQMStore.cc.

References setCurrentFolder().

{ setCurrentFolder(""); }

void DQMStore::cd ( const std::string & subdir )

cd to subdirectory (if there)

Definition at line 219 of file DQMStore.cc.

References clean, cleanTrailingSlashes(), dirExists(), raiseDQMError(), and setCurrentFolder().

{
  std::string clean;
  const std::string *cleaned = 0;
  cleanTrailingSlashes(subdir, clean, cleaned);

  if (! dirExists(*cleaned))
    raiseDQMError("DQMStore", "Cannot 'cd' into non-existent directory '%s'",
                  cleaned->c_str());
  
  setCurrentFolder(*cleaned);
}

bool DQMStore::cdInto ( const std::string & path ) const [private]

Use this for saving monitoring objects in ROOT files with dir structure; cd into directory (create first if it doesn't exist); returns success flag

Definition at line 1836 of file DQMStore.cc.

References end, connectstrParser::o, and raiseDQMError().

Referenced by save().

{
  assert(! path.empty());

  // Find the first path component.
  size_t start = 0;
  size_t end = path.find('/', start);
  if (end == std::string::npos)
    end = path.size();

  while (true)
  {
    // Check if this subdirectory component exists.  If yes, make sure
    // it is actually a subdirectory.  Otherwise create or cd into it.
    std::string part(path, start, end-start);
    TObject *o = gDirectory->Get(part.c_str());
    if (o && ! dynamic_cast<TDirectory *>(o))
      raiseDQMError("DQMStore", "Attempt to create directory '%s' in a file"
                    " fails because the part '%s' already exists and is not"
                    " directory", path.c_str(), part.c_str());
    else if (! o)
      gDirectory->mkdir(part.c_str());

    if (! gDirectory->cd(part.c_str()))
      raiseDQMError("DQMStore", "Attempt to create directory '%s' in a file"
                    " fails because could not cd into subdirectory '%s'",
                    path.c_str(), part.c_str());

    // Stop if we reached the end, ignoring any trailing '/'.
    if (end+1 >= path.size())
      break;

    // Find the next path component.
    start = end+1;
    end = path.find('/', start);
    if (end == std::string::npos)
      end = path.size();
  }

  return true;
}

bool DQMStore::checkBinningMatches	(	MonitorElement *	me,
		TH1 *	h
	)		`[static, private]`

Definition at line 1059 of file DQMStore.cc.

References gather_cfg::cout, MonitorElement::getFullname(), and MonitorElement::getTH1().

Referenced by collate1D(), collate1DD(), collate1S(), collate2D(), collate2DD(), collate2S(), collate3D(), collateProfile(), and collateProfile2D().

{
  if (me->getTH1()->GetNbinsX() != h->GetNbinsX()
      || me->getTH1()->GetNbinsY() != h->GetNbinsY()
      || me->getTH1()->GetNbinsZ() != h->GetNbinsZ()
      || me->getTH1()->GetXaxis()->GetXmin() != h->GetXaxis()->GetXmin()
      || me->getTH1()->GetYaxis()->GetXmin() != h->GetYaxis()->GetXmin()
      || me->getTH1()->GetZaxis()->GetXmin() != h->GetZaxis()->GetXmin()
      || me->getTH1()->GetXaxis()->GetXmax() != h->GetXaxis()->GetXmax()
      || me->getTH1()->GetYaxis()->GetXmax() != h->GetYaxis()->GetXmax()
      || me->getTH1()->GetZaxis()->GetXmax() != h->GetZaxis()->GetXmax())
  {
    //  edm::LogWarning ("DQMStore")
    std::cout << "*** DQMStore: WARNING:"
              << "checkBinningMatches: different binning - cannot add object '"
              << h->GetName() << "' of type "
              << h->IsA()->GetName() << " to existing ME: '"
              << me->getFullname() << "'\n";
    return false;
  }
  return true;     
}

void DQMStore::collate1D	(	MonitorElement *	me,
		TH1F *	h
	)		`[static, private]`

Definition at line 1083 of file DQMStore.cc.

References checkBinningMatches(), and MonitorElement::getTH1F().

Referenced by book1D(), and extract().

{ 
  if (checkBinningMatches(me,h)) 
    me->getTH1F()->Add(h); 
}

void DQMStore::collate1DD	(	MonitorElement *	me,
		TH1D *	h
	)		`[static, private]`

Definition at line 1097 of file DQMStore.cc.

References checkBinningMatches(), and MonitorElement::getTH1D().

Referenced by book1DD(), and extract().

{  
  if (checkBinningMatches(me,h)) 
    me->getTH1D()->Add(h); 
}

void DQMStore::collate1S	(	MonitorElement *	me,
		TH1S *	h
	)		`[static, private]`

Definition at line 1090 of file DQMStore.cc.

References checkBinningMatches(), and MonitorElement::getTH1S().

Referenced by book1S(), and extract().

{  
  if (checkBinningMatches(me,h)) 
    me->getTH1S()->Add(h); 
}

void DQMStore::collate2D	(	MonitorElement *	me,
		TH2F *	h
	)		`[static, private]`

Definition at line 1104 of file DQMStore.cc.

References checkBinningMatches(), and MonitorElement::getTH2F().

Referenced by book2D(), and extract().

{  
  if (checkBinningMatches(me,h)) 
    me->getTH2F()->Add(h); 
}

void DQMStore::collate2DD	(	MonitorElement *	me,
		TH2D *	h
	)		`[static, private]`

Definition at line 1118 of file DQMStore.cc.

References checkBinningMatches(), and MonitorElement::getTH2D().

Referenced by book2DD(), and extract().

{  
  if (checkBinningMatches(me,h)) 
    me->getTH2D()->Add(h); 
}

void DQMStore::collate2S	(	MonitorElement *	me,
		TH2S *	h
	)		`[static, private]`

Definition at line 1111 of file DQMStore.cc.

References checkBinningMatches(), and MonitorElement::getTH2S().

Referenced by book2S(), and extract().

{  
  if (checkBinningMatches(me,h)) 
    me->getTH2S()->Add(h); 
}

void DQMStore::collate3D	(	MonitorElement *	me,
		TH3F *	h
	)		`[static, private]`

Definition at line 1125 of file DQMStore.cc.

References checkBinningMatches(), and MonitorElement::getTH3F().

Referenced by book3D(), and extract().

{  
  if (checkBinningMatches(me,h)) 
    me->getTH3F()->Add(h); 
}

void DQMStore::collateProfile	(	MonitorElement *	me,
		TProfile *	h
	)		`[static, private]`

Definition at line 1132 of file DQMStore.cc.

References MonitorElement::addProfiles(), checkBinningMatches(), and MonitorElement::getTProfile().

Referenced by bookProfile(), and extract().

{
  if (checkBinningMatches(me,h)) 
  {
    TProfile *meh = me->getTProfile();
    me->addProfiles(h, meh, meh, 1, 1);
  }
}

void DQMStore::collateProfile2D	(	MonitorElement *	me,
		TProfile2D *	h
	)		`[static, private]`

Definition at line 1142 of file DQMStore.cc.

References MonitorElement::addProfiles(), checkBinningMatches(), and MonitorElement::getTProfile2D().

Referenced by bookProfile2D(), and extract().

{
  if (checkBinningMatches(me,h)) 
  {
    TProfile2D *meh = me->getTProfile2D();
    me->addProfiles(h, meh, meh, 1, 1);
  }
}

bool DQMStore::containsAnyMonitorable ( const std::string & path ) const

true if directory (or any subfolder at any level below it) contains at least one monitorable element

Definition at line 1260 of file DQMStore.cc.

References data_, ExpressReco_HICollisions_FallBack::e, i, and isSubdirectory().

Referenced by ContentReader::give_subdirs().

{
  MonitorElement proto(&path, std::string());
  MEMap::const_iterator e = data_.end();
  MEMap::const_iterator i = data_.lower_bound(proto);
  return (i != e && isSubdirectory(path, *i->data_.dirname));
}

QCriterion * DQMStore::createQTest	(	const std::string &	algoname,
		const std::string &	qtname
	)

create quality test with unique name <qtname> (analogous to ME name); quality test can then be attached to ME with useQTest method (<algo_name> must match one of known algorithms)

Definition at line 2374 of file DQMStore.cc.

References i, qalgos_, qtests_, raiseDQMError(), QCriterion::setVerbose(), and verboseQT_.

{
  if (qtests_.count(qtname))
    raiseDQMError("DQMStore", "Attempt to create duplicate quality test '%s'",
                  qtname.c_str());

  QAMap::iterator i = qalgos_.find(algoname);
  if (i == qalgos_.end())
    raiseDQMError("DQMStore", "Cannot create a quality test using unknown"
                  " algorithm '%s'", algoname.c_str());

  QCriterion *qc = i->second(qtname);
  qc->setVerbose(verboseQT_);

  qtests_[qtname] = qc;
  return qc;
}

bool DQMStore::dirExists ( const std::string & path ) const

true if directory exists

Definition at line 301 of file DQMStore.cc.

References dirs_.

Referenced by L1GtHwValidation::beginJob(), L1ExtraDQM::beginRun(), HLTTauDQMSummaryPlotter::bookEfficiencyHisto(), HLTTauDQMSummaryPlotter::bookTriggerBitEfficiencyHistos(), cd(), SiStripActionExecutor::createSummary(), DQMHcalIsoTrackPostProcessor::endJob(), JetMETDQMPostProcessor::endRun(), HltSusyExoPostProcessor::endRun(), EmDQMPostProcessor::endRun(), SiStripQualityChecker::fillDetectorStatus(), SiStripQualityChecker::fillFaultyModuleStatus(), SiStripDaqInfo::findExcludedModule(), FUShmDQMOutputService::findMonitorElements(), SiStripTrackerMapCreator::getDetectorFlagAndComment(), SiStripUtility::getTopFolderPath(), HLTTauDQMSummaryPlotter::plotEfficiencyHisto(), HLTTauDQMSummaryPlotter::plotIntegratedEffHisto(), HLTTauDQMSummaryPlotter::plotTriggerBitEfficiencyHistos(), SiStripActionExecutor::printFaultyModuleList(), SiStripBadComponentsDQMService::readBadComponents(), SiStripInformationExtractor::readGlobalHistoList(), SiStripInformationExtractor::readLayoutNames(), SiStripInformationExtractor::readModuleAndHistoList(), SiStripInformationExtractor::readNonGeomHistoTree(), SiStripInformationExtractor::readQTestSummary(), CommissioningHistograms::remove(), ZDCMonitorClient::removeAllME(), PhotonOfflineClient::runClient(), SiPixelErrorsDigisToCalibDigis::setDQMDirectory(), SiPixelOfflineCalibAnalysisBase::setDQMDirectory(), and SiStripTrackerMapCreator::setTkMapFromHistogram().

{ return dirs_.count(path) > 0; }

void DQMStore::disableSoftReset ( MonitorElement * me )

Definition at line 2520 of file DQMStore.cc.

References MonitorElement::disableSoftReset().

Referenced by TrackingMonitor::endRun(), EcalBarrelMonitorClient::softReset(), EcalEndcapMonitorClient::softReset(), and TrackAnalyzer::undoSoftReset().

{
  if (me)
    me->disableSoftReset();
}

bool DQMStore::extract	(	TObject *	obj,
		const std::string &	dir,
		bool	overwrite
	)		`[private]`

extract object (TH1F, TH2F, ...) from <to>; return success flag flag fromRemoteNode indicating if ME arrived from different node

Definition at line 1553 of file DQMStore.cc.

References MonitorElement::addQReport(), DQMNet::QValue::algorithm, book1D(), book1DD(), book1S(), book2D(), book2DD(), book2S(), book3D(), bookFloat(), bookInt(), bookProfile(), bookProfile2D(), bookString(), DQMNet::QValue::code, collate1D(), collate1DD(), collate1S(), collate2D(), collate2DD(), collate2S(), collate3D(), collateHistograms_, collateProfile(), collateProfile2D(), MonitorElement::copyFrom(), gather_cfg::cout, dot(), DQMNet::DQM_PROP_HAS_REFERENCE, MonitorElement::Fill(), findObject(), h, isCollateME(), isSubdirectory(), label, m, funct::master(), DQMNet::QValue::message, n, MonitorElement::object_, DQMNet::QValue::qtname, DQMNet::QValue::qtresult, asciidump::s, s_referenceDirName, s_rxmeqr1(), s_rxmeqr2(), s_rxmeval(), tag(), relativeConstraints::value, and verbose_.

Referenced by edm::DQMHttpSource::addEventToDQMBackend(), and readDirectory().

{
  // NB: Profile histograms inherit from TH*D, checking order matters.
  MonitorElement *refcheck = 0;
  if (TProfile *h = dynamic_cast<TProfile *>(obj))
  {
    MonitorElement *me = findObject(dir, h->GetName());
    if (! me)
      me = bookProfile(dir, h->GetName(), (TProfile *) h->Clone());
    else if (overwrite)
      me->copyFrom(h);
    else if (isCollateME(me) || collateHistograms_)
      collateProfile(me, h);
    refcheck = me;
  }
  else if (TProfile2D *h = dynamic_cast<TProfile2D *>(obj))
  {
    MonitorElement *me = findObject(dir, h->GetName());
    if (! me)
      me = bookProfile2D(dir, h->GetName(), (TProfile2D *) h->Clone());
    else if (overwrite)
      me->copyFrom(h);
    else if (isCollateME(me) || collateHistograms_)
      collateProfile2D(me, h);
    refcheck = me;
  }
  else if (TH1F *h = dynamic_cast<TH1F *>(obj))
  {
    MonitorElement *me = findObject(dir, h->GetName());
    if (! me)
      me = book1D(dir, h->GetName(), (TH1F *) h->Clone());
    else if (overwrite)
      me->copyFrom(h);
    else if (isCollateME(me) || collateHistograms_)
      collate1D(me, h);
    refcheck = me;
  }
  else if (TH1S *h = dynamic_cast<TH1S *>(obj))
  {
    MonitorElement *me = findObject(dir, h->GetName());
    if (! me)
      me = book1S(dir, h->GetName(), (TH1S *) h->Clone());
    else if (overwrite)
      me->copyFrom(h);
    else if (isCollateME(me) || collateHistograms_)
      collate1S(me, h);
    refcheck = me;
  }
  else if (TH1D *h = dynamic_cast<TH1D *>(obj))
  {
    MonitorElement *me = findObject(dir, h->GetName());
    if (! me)
      me = book1DD(dir, h->GetName(), (TH1D *) h->Clone());
    else if (overwrite)
      me->copyFrom(h);
    else if (isCollateME(me) || collateHistograms_)
      collate1DD(me, h);
    refcheck = me;
  }
  else if (TH2F *h = dynamic_cast<TH2F *>(obj))
  {
    MonitorElement *me = findObject(dir, h->GetName());
    if (! me)
      me = book2D(dir, h->GetName(), (TH2F *) h->Clone());
    else if (overwrite)
      me->copyFrom(h);
    else if (isCollateME(me) || collateHistograms_)
      collate2D(me, h);
    refcheck = me;
  }
  else if (TH2S *h = dynamic_cast<TH2S *>(obj))
  {
    MonitorElement *me = findObject(dir, h->GetName());
    if (! me)
      me = book2S(dir, h->GetName(), (TH2S *) h->Clone());
    else if (overwrite)
      me->copyFrom(h);
    else if (isCollateME(me) || collateHistograms_)
      collate2S(me, h);
    refcheck = me;
  }
  else if (TH2D *h = dynamic_cast<TH2D *>(obj))
  {
    MonitorElement *me = findObject(dir, h->GetName());
    if (! me)
      me = book2DD(dir, h->GetName(), (TH2D *) h->Clone());
    else if (overwrite)
      me->copyFrom(h);
    else if (isCollateME(me) || collateHistograms_)
      collate2DD(me, h);
    refcheck = me;
  }
  else if (TH3F *h = dynamic_cast<TH3F *>(obj))
  {
    MonitorElement *me = findObject(dir, h->GetName());
    if (! me)
      me = book3D(dir, h->GetName(), (TH3F *) h->Clone());
    else if (overwrite)
      me->copyFrom(h);
    else if (isCollateME(me) || collateHistograms_)
      collate3D(me, h);
    refcheck = me;
  }
  else if (dynamic_cast<TObjString *>(obj))
  {
    lat::RegexpMatch m;
    if (! s_rxmeval.match(obj->GetName(), 0, 0, &m))
    {
      if (strstr(obj->GetName(), "CMSSW"))
      {
        if (verbose_)
          std::cout << "Input file version: " << obj->GetName() << std::endl;
        return true;
      }
      else if (strstr(obj->GetName(), "DQMPATCH"))
      {
        if (verbose_)
          std::cout << "DQM patch version: " << obj->GetName() << std::endl;
        return true;
      }
      else
      {
        std::cout << "*** DQMStore: WARNING: cannot extract object '"
                  << obj->GetName() << "' of type '"
                  << obj->IsA()->GetName() << "'\n";
        return false;
      }
    }

    std::string label = m.matchString(obj->GetName(), 1);
    std::string kind = m.matchString(obj->GetName(), 2);
    std::string value = m.matchString(obj->GetName(), 3);

    if (kind == "i")
    {
      MonitorElement *me = findObject(dir, label);
      if (! me || overwrite)
      {
        if (! me) me = bookInt(dir, label);
        me->Fill(atoll(value.c_str()));
      }
    }
    else if (kind == "f")
    {
      MonitorElement *me = findObject(dir, label);
      if (! me || overwrite)
      {
        if (! me) me = bookFloat(dir, label);
        me->Fill(atof(value.c_str()));
      }
    }
    else if (kind == "s")
    {
      MonitorElement *me = findObject(dir, label);
      if (! me)
        me = bookString(dir, label, value);
      else if (overwrite)
        me->Fill(value);
    }
    else if (kind == "t")
    {
      MonitorElement *me = findObject(dir, label);
      if (! me)
      {
        std::cout << "*** DQMStore: WARNING: no monitor element '"
                  << label << "' in directory '"
                  << dir << "' for a tag\n";
        return false;
      }
      errno = 0;
      char *endp = 0;
      unsigned long val = strtoul(value.c_str(), &endp, 10);
      if ((val == 0 && errno) || *endp || val > ~uint32_t(0))
      {
        std::cout << "*** DQMStore: WARNING: cannot restore tag '"
                  << value << "' for monitor element '"
                  << label << "' in directory '"
                  << dir << "' - invalid value\n";
        return false;
      }
      tag(me, val);
    }
    else if (kind == "qr")
    {
      // Handle qreports, but skip them while reading in references.
      if (! isSubdirectory(s_referenceDirName, dir))
      {
        size_t dot = label.find('.');
        if (dot == std::string::npos)
        {
          std::cout << "*** DQMStore: WARNING: quality report label in '" << label
                    << "' is missing a '.' and cannot be extracted\n";
          return false;
        }

        std::string mename (label, 0, dot);
        std::string qrname (label, dot+1, std::string::npos);

        m.reset();
        DQMNet::QValue qv;
        if (s_rxmeqr1.match(value, 0, 0, &m))
        {
          qv.code = atoi(m.matchString(value, 1).c_str());
          qv.qtresult = strtod(m.matchString(value, 2).c_str(), 0);
          qv.message = m.matchString(value, 4);
          qv.qtname = qrname;
          qv.algorithm = m.matchString(value, 3);
        }
        else if (s_rxmeqr2.match(value, 0, 0, &m))
        {
          qv.code = atoi(m.matchString(value, 1).c_str());
          qv.qtresult = 0; // unavailable in old format
          qv.message = m.matchString(value, 2);
          qv.qtname = qrname;
          // qv.algorithm unavailable in old format
        }
        else
        {
          std::cout << "*** DQMStore: WARNING: quality test value '"
                    << value << "' is incorrectly formatted\n";
          return false;
        }

        MonitorElement *me = findObject(dir, mename);
        if (! me)
        {
          std::cout << "*** DQMStore: WARNING: no monitor element '"
                    << mename << "' in directory '"
                    << dir << "' for quality test '"
                    << label << "'\n";
          return false;
        }

        me->addQReport(qv, /* FIXME: getQTest(qv.qtname)? */ 0);
      }
    }
    else
    {
      std::cout << "*** DQMStore: WARNING: cannot extract object '"
                << obj->GetName() << "' of type '"
                << obj->IsA()->GetName() << "'\n";
      return false;
    }
  }
  else if (TNamed *n = dynamic_cast<TNamed *>(obj))
  {
    // For old DQM data.
    std::string s;
    s.reserve(6 + strlen(n->GetTitle()) + 2*strlen(n->GetName()));
    s += '<'; s += n->GetName(); s += '>';
    s += n->GetTitle();
    s += '<'; s += '/'; s += n->GetName(); s += '>';
    TObjString os(s.c_str());
    return extract(&os, dir, overwrite);
  }
  else
  {
    std::cout << "*** DQMStore: WARNING: cannot extract object '"
              << obj->GetName() << "' of type '" << obj->IsA()->GetName()
              << "' and with title '" << obj->GetTitle() << "'\n";
    return false;
  }

  // If we just read in a reference monitor element, and there is a
  // monitor element with the same name, link the two together. The
  // other direction is handled by the initialise() method.
  if (refcheck && isSubdirectory(s_referenceDirName, dir))
  {
    std::string mdir(dir, s_referenceDirName.size()+1, std::string::npos);
    if (MonitorElement *master = findObject(mdir, obj->GetName()))
    {
      master->data_.flags |= DQMNet::DQM_PROP_HAS_REFERENCE;
      master->reference_ = refcheck->object_;
    }
  }

  return true;
}

MonitorElement * DQMStore::findObject	(	const std::string &	dir,
		const std::string &	name
	)		const `[private]`

get MonitorElement <name> in directory <dir> (null if MonitorElement does not exist)

Definition at line 1400 of file DQMStore.cc.

References data_, MonitorElement::data_, dir, DQMNet::CoreObject::dirname, AlCaRecoCosmics_cfg::name, DQMNet::CoreObject::objname, raiseDQMError(), and s_safe.

Referenced by book(), bookFloat(), bookInt(), bookString(), extract(), makeDirectory(), and tag().

{
  if (dir.find_first_not_of(s_safe) != std::string::npos)
    raiseDQMError("DQMStore", "Monitor element path name '%s' uses"
                  " unacceptable characters", dir.c_str());
  if (name.find_first_not_of(s_safe) != std::string::npos)
    raiseDQMError("DQMStore", "Monitor element path name '%s' uses"
                  " unacceptable characters", name.c_str());

  MonitorElement proto;
  proto.data_.dirname = &dir;
  proto.data_.objname = name;

  MEMap::const_iterator mepos = data_.find(proto);
  return (mepos == data_.end() ? 0
          : const_cast<MonitorElement *>(&*mepos));
}

MonitorElement * DQMStore::get ( const std::string & path ) const

get ME from full pathname (e.g. "my/long/dir/my_histo")

Definition at line 1270 of file DQMStore.cc.

References data_, dir, AlCaRecoCosmics_cfg::name, and splitPath().

{
  std::string dir;
  std::string name;
  splitPath(dir, name, path);
  MonitorElement proto(&dir, name);
  MEMap::const_iterator mepos = data_.find(proto);
  return (mepos == data_.end() ? 0
          : const_cast<MonitorElement *>(&*mepos));
}

std::vector< MonitorElement * > DQMStore::get ( unsigned int tag ) const

get all MonitorElements tagged as <tag>

Definition at line 1283 of file DQMStore.cc.

References data_, MonitorElement::data_, DQMNet::DQM_PROP_TAGGED, ExpressReco_HICollisions_FallBack::e, DQMNet::CoreObject::flags, i, query::result, DQMNet::CoreObject::tag, and tag().

{
  // FIXME: Use reverse map [tag -> path] / [tag -> dir]?
  std::vector<MonitorElement *> result;
  for (MEMap::const_iterator i = data_.begin(), e = data_.end(); i != e; ++i)
  {
    const MonitorElement &me = *i;
    if ((me.data_.flags & DQMNet::DQM_PROP_TAGGED) && me.data_.tag == tag)
      result.push_back(const_cast<MonitorElement *>(&me));
  }
  return result;
}

std::vector< MonitorElement * > DQMStore::getAllContents ( const std::string & path ) const

get vector with children of folder, including all subfolders + their children; must use an exact pathname

Definition at line 1474 of file DQMStore.cc.

References clean, cleanTrailingSlashes(), data_, ExpressReco_HICollisions_FallBack::e, i, isSubdirectory(), and query::result.

Referenced by SiStripCalibLorentzAngle::algoBeginJob(), HcalDAQInfo::beginJob(), SiPixelDQMRocLevelAnalyzer::beginJob(), HcalDataCertification::beginJob(), SiStripDQMProfileToTkMapConverter::beginRun(), edmtest::DQMReferenceHistogramRootFileEventSetupAnalyzer::beginRun(), MEtoEDMConverter::beginRun(), SiStripQualityHotStripIdentifierRoot::bookHistos(), HcalDataCertification::CertifyHcal(), DQMHistoryServiceBase::createSummary(), MEtoEDMConverter::endJob(), HcalDAQInfo::endLuminosityBlock(), DataCertificationJetMET::endRun(), HcalBaseDQClient::htmlOutput(), MEtoEDMConverter::putData(), SiStripNoisesDQMService::readNoises(), SiStripPedestalsDQMService::readPedestals(), HcalRecHitMonitor::reset(), EcalBarrelMonitorClient::softReset(), and EcalEndcapMonitorClient::softReset().

{
  std::string clean;
  const std::string *cleaned = 0;
  cleanTrailingSlashes(path, clean, cleaned);
  MonitorElement proto(cleaned, std::string());

  std::vector<MonitorElement *> result;
  MEMap::const_iterator e = data_.end();
  MEMap::const_iterator i = data_.lower_bound(proto);
  for ( ; i != e && isSubdirectory(*cleaned, *i->data_.dirname); ++i)
    result.push_back(const_cast<MonitorElement *>(&*i));

  return result;
}

void DQMStore::getAllTags ( std::vector< std::string > & into ) const

get tags for various maps, return vector with strings of the form <dir pathname>="">:<obj1>/<tag1>/<tag2>,<obj2>/<tag1>/<tag3>, etc.

Definition at line 1421 of file DQMStore.cc.

References data_, dirs_, DQMNet::DQM_PROP_TAGGED, isSubdirectory(), and m.

Referenced by EDMtoMEConverter::getData().

{
  into.clear();
  into.reserve(dirs_.size());

  MEMap::const_iterator me = data_.end();
  std::set<std::string>::const_iterator di = dirs_.begin();
  std::set<std::string>::const_iterator de = dirs_.end();
  char tagbuf[32]; // more than enough for '/' and up to 10 digits

  for ( ; di != de; ++di)
  {
    MonitorElement proto(&*di, std::string());
    MEMap::const_iterator mi = data_.lower_bound(proto);
    MEMap::const_iterator m = mi;
    size_t sz = di->size() + 2;
    size_t nfound = 0;
    for ( ; m != me && isSubdirectory(*di, *m->data_.dirname); ++m)
      if (*di == *m->data_.dirname && (m->data_.flags & DQMNet::DQM_PROP_TAGGED))
      {
        // the tags count for '/' + up to 10 digits, otherwise ',' + ME name
        sz += 1 + m->data_.objname.size() + 11;
        ++nfound;
      }

    if (! nfound)
      continue;

    std::vector<std::string>::iterator istr
      = into.insert(into.end(), std::string());

    istr->reserve(sz);

    *istr += *di;
    *istr += ':';
    for (sz = 0; mi != m; ++mi)
    {
      if (*di == *m->data_.dirname && (m->data_.flags & DQMNet::DQM_PROP_TAGGED))
      {
        sprintf(tagbuf, "/%u", mi->data_.tag);
        if (sz > 0)
          *istr += ',';
        *istr += m->data_.objname;
        *istr += tagbuf;
        ++sz;
      }
    }
  }
}

std::vector< MonitorElement * > DQMStore::getContents	(	const std::string &	path,
		unsigned int	tag
	)		const

same as above for tagged MonitorElements

Definition at line 1318 of file DQMStore.cc.

References clean, cleanTrailingSlashes(), data_, DQMNet::DQM_PROP_TAGGED, ExpressReco_HICollisions_FallBack::e, i, isSubdirectory(), query::result, and tag().

{
  std::string clean;
  const std::string *cleaned = 0;
  cleanTrailingSlashes(path, clean, cleaned);
  MonitorElement proto(cleaned, std::string());

  std::vector<MonitorElement *> result;
  MEMap::const_iterator e = data_.end();
  MEMap::const_iterator i = data_.lower_bound(proto);
  for ( ; i != e && isSubdirectory(*cleaned, *i->data_.dirname); ++i)
    if (*cleaned == *i->data_.dirname
        && (i->data_.flags & DQMNet::DQM_PROP_TAGGED)
        && i->data_.tag == tag)
      result.push_back(const_cast<MonitorElement *>(&*i));

  return result;
}

void DQMStore::getContents	(	std::vector< std::string > &	into,
		bool	showContents = `true`
	)		const

get contents; return vector<string> of the form <dir pathname>="">:<obj1>,<obj2>,<obj3>; if showContents = false, change form to <dir pathname>="">: (useful for subscription requests; meant to imply "all contents")

Definition at line 1342 of file DQMStore.cc.

References data_, dirs_, isSubdirectory(), and m.

{
  into.clear();
  into.reserve(dirs_.size());

  MEMap::const_iterator me = data_.end();
  std::set<std::string>::const_iterator di = dirs_.begin();
  std::set<std::string>::const_iterator de = dirs_.end();
  for ( ; di != de; ++di)
  {
    MonitorElement proto(&*di, std::string());
    MEMap::const_iterator mi = data_.lower_bound(proto);
    MEMap::const_iterator m = mi;
    size_t sz = di->size() + 2;
    size_t nfound = 0;
    for ( ; m != me && isSubdirectory(*di, *m->data_.dirname); ++m)
      if (*di == *m->data_.dirname)
      {
        sz += m->data_.objname.size() + 1;
        ++nfound;
      }

    if (! nfound)
      continue;

    std::vector<std::string>::iterator istr
      = into.insert(into.end(), std::string());

    if (showContents)
    {
      istr->reserve(sz);

      *istr += *di;
      *istr += ':';
      for (sz = 0; mi != m; ++mi)
      {
        if (*di != *mi->data_.dirname)
          continue;

        if (sz > 0)
          *istr += ',';

        *istr += mi->data_.objname;
        ++sz;
      }
    }
    else
    {
      istr->reserve(di->size() + 2);
      *istr += *di;
      *istr += ':';
    }
  }
}

std::vector< MonitorElement * > DQMStore::getContents ( const std::string & path ) const

get vector with all children of folder (does NOT include contents of subfolders)

Definition at line 1299 of file DQMStore.cc.

References clean, cleanTrailingSlashes(), data_, ExpressReco_HICollisions_FallBack::e, i, isSubdirectory(), and query::result.

{
  std::string clean;
  const std::string *cleaned = 0;
  cleanTrailingSlashes(path, clean, cleaned);
  MonitorElement proto(cleaned, std::string());

  std::vector<MonitorElement *> result;
  MEMap::const_iterator e = data_.end();
  MEMap::const_iterator i = data_.lower_bound(proto);
  for ( ; i != e && isSubdirectory(*cleaned, *i->data_.dirname); ++i)
    if (*cleaned == *i->data_.dirname)
      result.push_back(const_cast<MonitorElement *>(&*i));

  return result;
}

std::vector< MonitorElement * > DQMStore::getMatchingContents	(	const std::string &	pattern,
		lat::Regexp::Syntax	syntaxType = `lat::Regexp::Wildcard`
	)		const

get vector with children of folder, including all subfolders + their children; matches names against a wildcard pattern matched against the full ME path

Definition at line 1493 of file DQMStore.cc.

References data_, ExpressReco_HICollisions_FallBack::e, i, mergePath(), path(), raiseDQMError(), and query::result.

Referenced by DQMStoreStats::calcstats(), and EgHLTOfflineSummaryClient::getQTestResults_().

{
  lat::Regexp rx;
  try
  {
    rx = lat::Regexp(pattern, 0, syntaxType);
    rx.study();
  }
  catch (lat::Error &e)
  {
    raiseDQMError("DQMStore", "Invalid regular expression '%s': %s",
                  pattern.c_str(), e.explain().c_str());
  }

  std::string path;
  std::vector<MonitorElement *> result;
  MEMap::const_iterator i = data_.begin();
  MEMap::const_iterator e = data_.end();
  for ( ; i != e; ++i)
  {
    path.clear();
    mergePath(path, *i->data_.dirname, i->data_.objname);
    if (rx.match(path))
      result.push_back(const_cast<MonitorElement *>(&*i));
  }

  return result;
}

std::vector< std::string > DQMStore::getMEs ( void ) const

get list of (non-dir) MEs of current directory

Definition at line 1244 of file DQMStore.cc.

References data_, ExpressReco_HICollisions_FallBack::e, i, isSubdirectory(), pwd_, and query::result.

{
  MonitorElement proto(&pwd_, std::string());
  std::vector<std::string> result;
  MEMap::const_iterator e = data_.end();
  MEMap::const_iterator i = data_.lower_bound(proto);
  for ( ; i != e && isSubdirectory(pwd_, *i->data_.dirname); ++i)
    if (pwd_ == *i->data_.dirname)
      result.push_back(i->getName());

  return result;
}

QCriterion * DQMStore::getQCriterion ( const std::string & qtname ) const

get QCriterion corresponding to <qtname> (null pointer if QCriterion does not exist)

Definition at line 2363 of file DQMStore.cc.

References ExpressReco_HICollisions_FallBack::e, i, and qtests_.

{
  QCMap::const_iterator i = qtests_.find(qtname);
  QCMap::const_iterator e = qtests_.end();
  return (i == e ? 0 : i->second);
}

int DQMStore::getStatus ( const std::string & path = "" ) const

get "global" folder <path> status (one of:STATUS_OK, WARNING, ERROR, OTHER); returns most sever error, where ERROR > WARNING > OTHER > STATUS_OK; see Core/interface/QTestStatus.h for details on "OTHER"

Definition at line 2481 of file DQMStore.cc.

References clean, cleanTrailingSlashes(), data_, dqm::qstatus::ERROR, isSubdirectory(), dqm::qstatus::OTHER, ntuplemaker::status, dqm::qstatus::STATUS_OK, and dqm::qstatus::WARNING.

Referenced by QTestStatusChecker::checkGlobalStatus(), and SiStripInformationExtractor::printAlarmList().

{
  std::string clean;
  const std::string *cleaned = 0;
  cleanTrailingSlashes(path, clean, cleaned);

  int status = dqm::qstatus::STATUS_OK;
  MEMap::const_iterator mi = data_.begin();
  MEMap::const_iterator me = data_.end();
  for ( ; mi != me; ++mi)
  {
    if (! cleaned->empty() && ! isSubdirectory(*cleaned, *mi->data_.dirname))
      continue;

    if (mi->hasError())
      return dqm::qstatus::ERROR;
    else if (mi->hasWarning())
      status = dqm::qstatus::WARNING;
    else if (status < dqm::qstatus::WARNING
             && mi->hasOtherReport())
      status = dqm::qstatus::OTHER;
  }
  return status;
}

std::vector< std::string > DQMStore::getSubdirs ( void ) const

get list of subdirectories of current directory

Definition at line 1221 of file DQMStore.cc.

References dirs_, ExpressReco_HICollisions_FallBack::e, i, isSubdirectory(), pwd_, and query::result.

{
  std::vector<std::string> result;
  std::set<std::string>::const_iterator e = dirs_.end();
  std::set<std::string>::const_iterator i = dirs_.find(pwd_);

  // If we didn't find current directory, the tree is empty, so quit.
  if (i == e)
    return result;

  // Skip the current directory and then start looking for immediate
  // subdirectories in the dirs_ list.  Stop when we are no longer in
  // (direct or indirect) subdirectories of pwd_.  Note that we don't
  // "know" which order the set will sort A/B, A/B/C and A/D.
  while (++i != e && isSubdirectory(pwd_, *i))
    if (i->find('/', pwd_.size()+1) == std::string::npos)
      result.push_back(*i);

  return result;
}

void DQMStore::goUp ( void )

equivalent to "cd .."

Definition at line 248 of file DQMStore.cc.

References pos, pwd_, and setCurrentFolder().

{
  size_t pos = pwd_.rfind('/');
  if (pos == std::string::npos)
    setCurrentFolder("");
  else
    setCurrentFolder(pwd_.substr(0, pos));
}

MonitorElement* DQMStore::initialise	(	MonitorElement *	me,
		const std::string &	path
	)		`[private]`

Referenced by book().

DQMStore * DQMStore::instance ( void ) [static, private]

Definition at line 120 of file DQMStore.cc.

References gather_cfg::cout, DQMStore(), ExpressReco_HICollisions_FallBack::e, cmsRelvalreport::exit, s_instance, and cms::Exception::what().

{
  if (! s_instance)
  {
    try
    {
      DQMStore *bei = new DQMStore(edm::ParameterSet());
      assert (s_instance == bei);
    }
    catch(DQMError &e)
    {
      std::cout << e.what() << std::endl;
      exit(255);
    }
  }

  return s_instance;
}

bool DQMStore::isCollateME ( MonitorElement * me ) const [private]

Definition at line 2559 of file DQMStore.cc.

References MonitorElement::data_, DQMNet::CoreObject::dirname, isSubdirectory(), and s_collateDirName.

Referenced by extract().

{ return me && isSubdirectory(s_collateDirName, *me->data_.dirname); }

bool DQMStore::load	(	const std::string &	filename,
		OpenRunDirs	stripdirs = `StripRunDirs`,
		bool	fileMustExist = `true`
	)

public load root file <filename>, and copy MonitorElements; overwrite identical MonitorElements (default: true); set DQMStore.collateHistograms to true to sum several files note: by default this method strips off run dir structure

Definition at line 2213 of file DQMStore.cc.

References collateHistograms_, gather_cfg::cout, readFile(), and verbose_.

Referenced by DQMFileReader::beginJob(), and ReadMeFromFile::beginRun().

{
  bool overwrite = true;
  if (collateHistograms_) overwrite = false;
  if (verbose_) 
  {
    std::cout << "DQMStore::load: reading from file '" << filename << "'\n";
    if (collateHistograms_)
      std::cout << "DQMStore::load: in collate mode   " << "\n";
    else
      std::cout << "DQMStore::load: in overwrite mode   " << "\n";
  }
    
  return readFile(filename,overwrite,"","",stripdirs,fileMustExist);
     
}

void DQMStore::makeDirectory ( const std::string & path ) [private]

get folder corresponding to inpath wrt to root (create subdirs if necessary)

Definition at line 260 of file DQMStore.cc.

References dirs_, findObject(), AlCaRecoCosmics_cfg::name, raiseDQMError(), and cmsCodeRules::pickleFileParser::slash.

Referenced by DQMStore(), readDirectory(), and setCurrentFolder().

{
  std::string prev;
  std::string subdir;
  std::string name;
  prev.reserve(path.size());
  subdir.reserve(path.size());
  name.reserve(path.size());
  size_t prevname = 0;
  size_t slash = 0;

  while (true)
  {
    // Create this subdirectory component.
    subdir.clear();
    subdir.append(path, 0, slash);
    name.clear();
    name.append(subdir, prevname, std::string::npos);
    if (! prev.empty() && findObject(prev, name))
      raiseDQMError("DQMStore", "Attempt to create subdirectory '%s'"
                    " which already exists as a monitor element",
                    subdir.c_str());

    if (! dirs_.count(subdir))
      dirs_.insert(subdir);

    // Stop if we've reached the end (including possibly a trailing slash).
    if (slash+1 >= path.size())
      break;

    // Find the next slash, making sure we progress.  If reach the end,
    // process the last path component; the next loop round will terminate.
    prevname = slash ? slash+1 : slash;
    prev = subdir;
    if ((slash = path.find('/', ++slash)) == std::string::npos)
      slash = path.size();
  }
}

bool DQMStore::open	(	const std::string &	filename,
		bool	overwrite = `false`,
		const std::string &	onlypath = `""`,
		const std::string &	prepend = `""`,
		OpenRunDirs	stripdirs = `KeepRunDirs`,
		bool	fileMustExist = `true`
	)

public open/read root file <filename>, and copy MonitorElements; if flag=true, overwrite identical MonitorElements (default: false); if onlypath != "", read only selected directory if prepend !="", prepend string to path note: by default this method keeps the dir structure as in file and does not update monitor element references!

Definition at line 2198 of file DQMStore.cc.

References readFile().

Referenced by SiStripCalibLorentzAngle::algoBeginJob(), EcalBarrelMonitorClient::beginJob(), HcalMonitorClient::beginJob(), ElectronDqmAnalyzerBase::beginJob(), SiPixelDQMRocLevelAnalyzer::beginJob(), EcalEndcapMonitorClient::beginJob(), DQMFileReader::beginJob(), edmtest::DQMReferenceHistogramRootFileEventSetupAnalyzer::beginRun(), SiStripCommissioningOfflineClient::beginRun(), DQMFileLoader::endJob(), SiPixelHistoricInfoDQMClient::endRun(), ZDCMonitorClient::initialize(), SiStripOfflineDQM::openInputFile(), SiStripBadComponentsDQMService::openRequestedFile(), DQMHistoryServiceBase::openRequestedFile(), BuildTrackerMapPlugin::read(), PhotonOfflineClient::runClient(), PhotonPostprocessing::runPostprocessing(), ConversionPostprocessing::runPostprocessing(), and SiStripDQMProfileToTkMapConverter::SiStripDQMProfileToTkMapConverter().

{
  return readFile(filename,overwrite,onlypath,prepend,stripdirs,fileMustExist);
}

const DQMStore& DQMStore::operator= ( const DQMStore & ) [private]

const std::string & DQMStore::pwd ( void ) const

return pathname of current directory

Definition at line 209 of file DQMStore.cc.

References pwd_.

{ return pwd_; }

unsigned int DQMStore::readDirectory	(	TFile *	file,
		bool	overwrite,
		const std::string &	onlypath,
		const std::string &	prepend,
		const std::string &	curdir,
		OpenRunDirs	stripdirs
	)		`[private]`

read ROOT objects from file <file> in directory <onlypath>; return total # of ROOT objects read

Definition at line 2043 of file DQMStore.cc.

References prof2calltree::count, gather_cfg::cout, extract(), isSubdirectory(), combine::key, makeDirectory(), VarParsing::obj, pos, raiseDQMError(), s_collateDirName, s_monitorDirName, s_referenceDirName, createPayload::skip, cmsCodeRules::pickleFileParser::slash, StripRunDirs, and verbose_.

Referenced by readFile().

{
  unsigned int ntot = 0;
  unsigned int count = 0;

  if (! file->cd(curdir.c_str()))
    raiseDQMError("DQMStore", "Failed to process directory '%s' while"
                  " reading file '%s'", curdir.c_str(), file->GetName());

  // Figure out current directory name, but strip out the top
  // directory into which we dump everything.
  std::string dirpart = curdir;
  if (dirpart.compare(0, s_monitorDirName.size(), s_monitorDirName) == 0)
  {
    if (dirpart.size() == s_monitorDirName.size())
      dirpart.clear();
    else if (dirpart[s_monitorDirName.size()] == '/')
      dirpart.erase(0, s_monitorDirName.size()+1);
  }

  // See if we are going to skip this directory.
  bool skip = (! onlypath.empty() && ! isSubdirectory(onlypath, dirpart));
  
  if (prepend == s_collateDirName || 
      prepend == s_referenceDirName || 
      stripdirs == StripRunDirs )
  {
    // Remove Run # and RunSummary dirs
    // first look for Run summary, 
    // if that is found and erased, also erase Run dir
    size_t slash = dirpart.find('/');
    size_t pos = dirpart.find("/Run summary");
    if (slash != std::string::npos && pos !=std::string::npos) 
    {
      dirpart.erase(pos,12);
    
      pos = dirpart.find("Run ");
      size_t length = dirpart.find('/',pos+1)-pos+1;
      if (pos !=std::string::npos) 
        dirpart.erase(pos,length);
    }
  } 

  // If we are prepending, add it to the directory name, 
  // and suppress reading of already existing reference histograms
  if (prepend == s_collateDirName || 
      prepend == s_referenceDirName)
  {
    size_t slash = dirpart.find('/');
    // If we are reading reference, skip previous reference.
    if (slash == std::string::npos   // skip if Reference is toplevel folder, i.e. no slash
        && slash+1+s_referenceDirName.size() == dirpart.size()
        && dirpart.compare(slash+1, s_referenceDirName.size(), s_referenceDirName) == 0)
      return 0;

    slash = dirpart.find('/');    
    // Skip reading of EventInfo subdirectory.
    if (slash != std::string::npos
        && slash + 10 == dirpart.size()
        && dirpart.compare( slash+1 , 9 , "EventInfo") == 0) {
      if (verbose_)
        std::cout << "DQMStore::readDirectory: skipping '" << dirpart << "'\n";
      return 0;
    }

    // Add prefix.
    if (dirpart.empty())
      dirpart = prepend;
    else
      dirpart = prepend + '/' + dirpart;
  }
  else if (! prepend.empty())
  {
    if (dirpart.empty())
      dirpart = prepend;
    else
      dirpart = prepend + '/' + dirpart;
  }

  // Loop over the contents of this directory in the file.
  // Post-pone string object handling to happen after other
  // objects have been read in so we are guaranteed to have
  // histograms by the time we read in quality tests and tags.
  TKey *key;
  TIter next (gDirectory->GetListOfKeys());
  std::list<TObject *> delayed;
  while ((key = (TKey *) next()))
  {
    std::auto_ptr<TObject> obj(key->ReadObj());
    if (dynamic_cast<TDirectory *>(obj.get()))
    {
      std::string subdir;
      subdir.reserve(curdir.size() + strlen(obj->GetName()) + 2);
      subdir += curdir;
      if (! curdir.empty())
        subdir += '/';
      subdir += obj->GetName();

      ntot += readDirectory(file, overwrite, onlypath, prepend, subdir, stripdirs);
    }
    else if (skip)
      ;
    else if (dynamic_cast<TObjString *>(obj.get()))
    {
      delayed.push_back(obj.release());
    }
    else
    {
      if (verbose_ > 2)
        std::cout << "DQMStore: reading object '" << obj->GetName()
                  << "' of type '" << obj->IsA()->GetName()
                  << "' from '" << file->GetName()
                  << "' into '" << dirpart << "'\n";

      makeDirectory(dirpart);
      if (extract(obj.get(), dirpart, overwrite))
        ++count;
    }
  }

  while (! delayed.empty())
  {
    if (verbose_ > 2)
      std::cout << "DQMStore: reading object '" << delayed.front()->GetName()
                << "' of type '" << delayed.front()->IsA()->GetName()
                << "' from '" << file->GetName()
                << "' into '" << dirpart << "'\n";

    makeDirectory(dirpart);
    if (extract(delayed.front(), dirpart, overwrite))
      ++count;

    delete delayed.front();
    delayed.pop_front();
  }

  if (verbose_ > 1)
    std::cout << "DQMStore: read " << count << '/' << ntot
              << " objects from directory '" << dirpart << "'\n";

  return ntot + count;
}

bool DQMStore::readFile	(	const std::string &	filename,
		bool	overwrite = `false`,
		const std::string &	onlypath = `""`,
		const std::string &	prepend = `""`,
		OpenRunDirs	stripdirs = `StripRunDirs`,
		bool	fileMustExist = `true`
	)		`[private]`

private readFile <filename>, and copy MonitorElements; if flag=true, overwrite identical MonitorElements (default: false); if onlypath != "", read only selected directory if prepend !="", prepend string to path if StripRunDirs is set the run and run summary folders are erased.

Definition at line 2238 of file DQMStore.cc.

References gather_cfg::cout, data_, exception, f, n, raiseDQMError(), readDirectory(), and verbose_.

Referenced by DQMStore(), load(), and open().

{
  
  if (verbose_)
    std::cout << "DQMStore::readFile: reading from file '" << filename << "'\n";

  std::auto_ptr<TFile> f;

  try 
  {
    f.reset(TFile::Open(filename.c_str()));
    if (! f.get() || f->IsZombie())
      raiseDQMError("DQMStore", "Failed to open file '%s'", filename.c_str());
  }
  catch (std::exception &)
  {
    if (fileMustExist)
      throw;
    else
    {  
    if (verbose_)
      std::cout << "DQMStore::readFile: file '" << filename << "' does not exist, continuing\n";
    return false;
    }
  }

  unsigned n = readDirectory(f.get(), overwrite, onlypath, prepend, "", stripdirs);
  f->Close();

  MEMap::iterator mi = data_.begin();
  MEMap::iterator me = data_.end();
  for ( ; mi != me; ++mi)
    const_cast<MonitorElement &>(*mi).updateQReportStats();

  if (verbose_)
  {
    std::cout << "DQMStore::open: successfully read " << n
              << " objects from file '" << filename << "'";
    if (! onlypath.empty())
      std::cout << " from directory '" << onlypath << "'";
    if (! prepend.empty())
      std::cout << " into directory '" << prepend << "'";
    std::cout << std::endl;
  }
  return true;
}

void DQMStore::removeContents ( void )

erase all monitoring elements in current directory (not including subfolders);

Definition at line 2330 of file DQMStore.cc.

References pwd_.

{
  removeContents(pwd_);
}

void DQMStore::removeContents ( const std::string & dir )

remove all monitoring elements from directory;

Definition at line 2316 of file DQMStore.cc.

References data_, ExpressReco_HICollisions_FallBack::e, i, and isSubdirectory().

{
  MonitorElement proto(&dir, std::string());
  MEMap::iterator e = data_.end();
  MEMap::iterator i = data_.lower_bound(proto);
  while (i != e && isSubdirectory(dir, *i->data_.dirname))
    if (dir == *i->data_.dirname)
      data_.erase(i++);
    else
      ++i;
}

void DQMStore::removeElement ( const std::string & name )

erase monitoring element in current directory (opposite of book1D,2D,etc. action);

Definition at line 2338 of file DQMStore.cc.

References pwd_.

{
  removeElement(pwd_, name);
}

void DQMStore::removeElement	(	const std::string &	dir,
		const std::string &	name,
		bool	warning = `true`
	)

remove monitoring element from directory; if warning = true, print message if element does not exist

Definition at line 2346 of file DQMStore.cc.

References gather_cfg::cout, data_, pos, and warning.

{
  MonitorElement proto(&dir, name);
  MEMap::iterator pos = data_.find(proto);
  if (pos == data_.end() && warning)
    std::cout << "DQMStore: WARNING: attempt to remove non-existent"
              << " monitor element '" << name << "' in '" << dir << "'\n";
  else
    data_.erase(pos);
}

void DQMStore::reset ( void ) [private]

Invoke this method after flushing all recently changed monitoring. Clears updated flag on all recently updated MEs and calls their Reset() method for those that have resetMe = true.

Definition at line 1529 of file DQMStore.cc.

References data_, MonitorElement::Reset(), reset_, MonitorElement::resetMe(), and MonitorElement::resetUpdate().

Referenced by DQMStore(), and DQMService::flush().

{
  MEMap::iterator mi = data_.begin();
  MEMap::iterator me = data_.end();
  for ( ; mi != me; ++mi)
  {
    MonitorElement &me = const_cast<MonitorElement &>(*mi);
    if (mi->wasUpdated())
    {
      if (me.resetMe())
        me.Reset();
      me.resetUpdate();
    }
  }

  reset_ = true;
}

void DQMStore::rmdir ( const std::string & path )

delete directory and all contents; delete directory (all contents + subfolders);

Definition at line 2296 of file DQMStore.cc.

References clean, cleanTrailingSlashes(), data_, dirs_, ExpressReco_HICollisions_FallBack::e, i, and isSubdirectory().

{
  std::string clean;
  const std::string *cleaned = 0;
  cleanTrailingSlashes(path, clean, cleaned);
  MonitorElement proto(cleaned, std::string());

  MEMap::iterator e = data_.end();
  MEMap::iterator i = data_.lower_bound(proto);
  while (i != e && isSubdirectory(*cleaned, *i->data_.dirname))
    data_.erase(i++);

  std::set<std::string>::iterator de = dirs_.end();
  std::set<std::string>::iterator di = dirs_.lower_bound(*cleaned);
  while (di != de && isSubdirectory(*cleaned, *di))
    dirs_.erase(di++);
}

void DQMStore::runQTests ( void )

run quality tests (also finds updated contents in last monitoring cycle, including newly added content)

Definition at line 2460 of file DQMStore.cc.

References gather_cfg::cout, data_, isSubdirectory(), reset_, MonitorElement::runQTests(), s_referenceDirName, and verbose_.

Referenced by ZDCMonitorClient::analyze(), and ZDCMonitorClient::report().

{

  if (verbose_ > 0)
    std::cout << "DQMStore: running runQTests() with reset = "
              << ( reset_ ? "true" : "false" ) << std::endl;

  // Apply quality tests to each monitor element, skipping references.
  MEMap::iterator mi = data_.begin();
  MEMap::iterator me = data_.end();
  for ( ; mi != me; ++mi)
    if (! isSubdirectory(s_referenceDirName, *mi->data_.dirname))
      const_cast<MonitorElement &>(*mi).runQTests();

  reset_ = false;
}

void DQMStore::save	(	const std::string &	filename,
		const std::string &	path = `""`,
		const std::string &	pattern = `""`,
		const std::string &	rewrite = `""`,
		SaveReferenceTag	ref = `SaveWithReference`,
		int	minStatus = `dqm::qstatus::STATUS_OK`,
		const std::string &	fileupdate = `"RECREATE"`
	)

save directory with monitoring objects into root file <filename>; include quality test results with status >= minimum_status (defined in Core/interface/QTestStatus.h); if directory="", save full monitoring structure

Definition at line 1883 of file DQMStore.cc.

References cdInto(), gather_cfg::cout, data_, dirs_, MonitorElement::DQM_KIND_INT, MonitorElement::DQM_KIND_REAL, MonitorElement::DQM_KIND_STRING, DQMNet::DQM_PROP_TAGGED, ExpressReco_HICollisions_FallBack::e, f, dbtoweb::file, i, isSubdirectory(), funct::master(), max(), path(), raiseDQMError(), linker::replace(), s_monitorDirName, s_referenceDirName, SaveWithoutReference, SaveWithReference, SaveWithReferenceForQTest, ntuplemaker::status, and verbose_.

{
  std::set<std::string>::iterator di, de;
  MEMap::iterator mi, me = data_.end();
  DQMNet::QReports::const_iterator qi, qe;
  int nme=0;

  // TFile flushes to disk with fsync() on every TDirectory written to the
  // file.  This makes DQM file saving painfully slow, and ironically makes
  // it _more_ likely the file saving gets interrupted and corrupts the file.
  // The utility class below simply ignores the flush synchronisation.
  class TFileNoSync : public TFile
  {
  public:
    TFileNoSync(const char *file, const char *opt) : TFile(file, opt) {}
    virtual Int_t SysSync(Int_t) { return 0; }
  };

  // open output file, on 1st save recreate, later update
  if (verbose_)
    std::cout << "\n DQMStore: Opening TFile '" << filename 
              << "' with option '" << fileupdate <<"'\n";

  TFileNoSync f(filename.c_str(), fileupdate.c_str()); // open file
  if(f.IsZombie())
    raiseDQMError("DQMStore", "Failed to create/update file '%s'", filename.c_str());
  f.cd();
  
  // Construct a regular expression from the pattern string.
  std::auto_ptr<lat::Regexp> rxpat;
  if (! pattern.empty())
    rxpat.reset(new lat::Regexp(pattern.c_str()));

  // Prepare a path for the reference object selection.
  std::string refpath;
  refpath.reserve(s_referenceDirName.size() + path.size() + 2);
  refpath += s_referenceDirName;
  if (! path.empty())
  {
    refpath += '/';
    refpath += path;
  }

  // Loop over the directory structure.
  for (di = dirs_.begin(), de = dirs_.end(); di != de; ++di)
  {
    // Check if we should process this directory.  We process the
    // requested part of the object tree, including references.
    if (! path.empty()
        && ! isSubdirectory(path, *di)
        && ! isSubdirectory(refpath, *di))
      continue;
    
    // Loop over monitor elements in this directory.
    MonitorElement proto(&*di, std::string());
    mi = data_.lower_bound(proto);
    for ( ; mi != me && isSubdirectory(*di, *mi->data_.dirname); ++mi)
    {
      // Skip if it isn't a direct child.
      if (*di != *mi->data_.dirname)
        continue;

      // Handle reference histograms, with three distinct cases:
      // 1) Skip all references entirely on saving.
      // 2) Blanket saving of all references.
      // 3) Save only references for monitor elements with qtests.
      // The latter two are affected by "path" sub-tree selection,
      // i.e. references are saved only in the selected tree part.
      if (isSubdirectory(refpath, *mi->data_.dirname))
      {
        if (ref == SaveWithoutReference)
          // Skip the reference entirely.
          continue;
        else if (ref == SaveWithReference)
          // Save all references regardless of qtests.
          ;
        else if (ref == SaveWithReferenceForQTest)
        {
          // Save only references for monitor elements with qtests
          // with an optional cut on minimum quality test result.
          int status = -1;
          std::string mname(mi->getFullname(), s_referenceDirName.size()+1, std::string::npos);
          MonitorElement *master = get(mname);
          if (master)
            for (size_t i = 0, e = master->data_.qreports.size(); i != e; ++i)
              status = std::max(status, master->data_.qreports[i].code);

          if (! master || status < minStatus)
          {
            if (verbose_ > 1)
              std::cout << "DQMStore::save: skipping monitor element '"
                        << mi->data_.objname << "' while saving, status is "
                        << status << ", required minimum status is "
                        << minStatus << std::endl;
            continue;
          }
        }
      }

      if (verbose_ > 1)
        std::cout << "DQMStore::save: saving monitor element '"
                  << mi->data_.objname << "'\n";
      nme++; // count saved histograms

      // Create the directory.
      gDirectory->cd("/");
      if (di->empty())
        cdInto(s_monitorDirName);
      else if (rxpat.get())
        cdInto(s_monitorDirName + '/' + lat::StringOps::replace(*di, *rxpat, rewrite));
      else
        cdInto(s_monitorDirName + '/' + *di);

      // Save the object.
      switch (mi->kind())
      {
      case MonitorElement::DQM_KIND_INT:
      case MonitorElement::DQM_KIND_REAL:
      case MonitorElement::DQM_KIND_STRING:
        TObjString(mi->tagString().c_str()).Write();
        break;

      default:
        mi->object_->Write();
        break;
      }

      // Save quality reports if this is not in reference section.
      if (! isSubdirectory(s_referenceDirName, *mi->data_.dirname))
      {
        qi = mi->data_.qreports.begin();
        qe = mi->data_.qreports.end();
        for ( ; qi != qe; ++qi)
          TObjString(mi->qualityTagString(*qi).c_str()).Write();
      }

      // Save tag if any
      if (mi->data_.flags & DQMNet::DQM_PROP_TAGGED)
        TObjString(mi->tagLabelString().c_str()).Write();
    }
  }

  f.Close();

  // Maybe make some noise.
  if (verbose_)
    std::cout << "DQMStore::save: successfully wrote " << nme 
              << " objects from path '" << path  
              << "' into DQM file '" << filename << "'\n";
}

void DQMStore::setAccumulate	(	MonitorElement *	me,
		bool	flag
	)		`[private]`

if true, will accumulate ME contents (over many periods) until method is called with flag = false again

Definition at line 2529 of file DQMStore.cc.

References MonitorElement::setAccumulate().

{
  if (me)
    me->setAccumulate(flag);
}

void DQMStore::setCurrentFolder ( const std::string & fullpath )

set the last directory in fullpath as the current directory(create if needed); to be invoked by user to specify directories for monitoring objects before booking; commands book1D (etc) & removeElement(name) imply elements in this directory!;

Definition at line 237 of file DQMStore.cc.

References clean, cleanTrailingSlashes(), makeDirectory(), and pwd_.

{
  std::string clean;
  const std::string *cleaned = 0;
  cleanTrailingSlashes(fullpath, clean, cleaned);
  makeDirectory(*cleaned);
  pwd_ = *cleaned;
}

void DQMStore::setVerbose ( unsigned level )

set verbose level (0 turns all non-error messages off)

Definition at line 201 of file DQMStore.cc.

Referenced by L1Scalers::beginJob(), ElectronDqmAnalyzerBase::beginJob(), EgammaBasicClusters::beginJob(), EgammaSuperClusters::beginJob(), RPCDqmClient::beginJob(), PiZeroAnalyzer::beginJob(), TopTrigAnalyzer::beginRun(), HeavyFlavorValidation::beginRun(), SiStripCommissioningOfflineClient::beginRun(), BPAGTrigAnalyzer::beginRun(), OfflineDQMMuonTrigAnalyzer::beginRun(), ReadMeFromFile::beginRun(), SiStripCommissioningSource::beginRun(), BxTiming::BxTiming(), ConversionPostprocessing::ConversionPostprocessing(), EgHLTOfflineClient::EgHLTOfflineClient(), EgHLTOfflineSource::EgHLTOfflineSource(), FourVectorHLT::FourVectorHLT(), FourVectorHLTOffline::FourVectorHLTOffline(), FourVectorHLTOnline::FourVectorHLTOnline(), FourVectorHLTriggerOffline::FourVectorHLTriggerOffline(), GlobalDigisAnalyzer::GlobalDigisAnalyzer(), GlobalDigisHistogrammer::GlobalDigisHistogrammer(), GlobalHitsAnalyzer::GlobalHitsAnalyzer(), GlobalHitsHistogrammer::GlobalHitsHistogrammer(), GlobalHitsProdHistStripper::GlobalHitsProdHistStripper(), GlobalRecHitsAnalyzer::GlobalRecHitsAnalyzer(), GlobalRecHitsHistogrammer::GlobalRecHitsHistogrammer(), HcalSimHitStudy::HcalSimHitStudy(), HLTJetMETDQMSource::HLTJetMETDQMSource(), HLTMon::HLTMon(), HLTMonBitSummary::HLTMonBitSummary(), HLTMonMuonClient::HLTMonMuonClient(), HLTMuonCertSummary::HLTMuonCertSummary(), HLTMuonMatchAndPlot::HLTMuonMatchAndPlot(), HLTMuonValidator::HLTMuonValidator(), HLTOverallSummary::HLTOverallSummary(), HLTScalers::HLTScalers(), HLTScalersClient::HLTScalersClient(), HLXMonitor::HLXMonitor(), JetMETDQMOfflineClient::JetMETDQMOfflineClient(), JetMETHLTOfflineClient::JetMETHLTOfflineClient(), JetMETHLTOfflineSource::JetMETHLTOfflineSource(), L1ExtraDQM::L1ExtraDQM(), L1GtHwValidation::L1GtHwValidation(), L1TCompare::L1TCompare(), L1TCSCTF::L1TCSCTF(), L1TCSCTPG::L1TCSCTPG(), L1TdeRCT::L1TdeRCT(), L1TDTTF::L1TDTTF(), L1TDTTPG::L1TDTTPG(), L1TECALTPG::L1TECALTPG(), L1TGCT::L1TGCT(), L1TGMT::L1TGMT(), L1TGT::L1TGT(), L1TRCT::L1TRCT(), L1TRPCTF::L1TRPCTF(), L1TRPCTPG::L1TRPCTPG(), L1TScalersSCAL::L1TScalersSCAL(), MixCollectionValidation::MixCollectionValidation(), MuonDTDigis::MuonDTDigis(), MuonSimHitsValidAnalyzer::MuonSimHitsValidAnalyzer(), SiStripBadComponentsDQMService::openRequestedFile(), PhotonDataCertification::PhotonDataCertification(), PhotonOfflineClient::PhotonOfflineClient(), PhotonPostprocessing::PhotonPostprocessing(), CommissioningHistograms::remove(), SiStripDQMProfileToTkMapConverter::SiStripDQMProfileToTkMapConverter(), SiStripMonitorMuonHLT::SiStripMonitorMuonHLT(), TriggerValidator::TriggerValidator(), TrigResRateMon::TrigResRateMon(), and ZdcSimHitStudy::ZdcSimHitStudy().

{ return; }

void DQMStore::showDirStructure ( void ) const

Definition at line 2539 of file DQMStore.cc.

References cmsMakeMELists::contents, filterCSVwithJSON::copy, gather_cfg::cout, and getContents().

Referenced by HcalCoarsePedestalClient::beginJob(), HLTMuonDQMSource::beginJob(), RPCTTUMonitor::beginJob(), HcalDeadCellClient::beginJob(), GlobalTest::beginJob(), HcalNZSClient::beginJob(), HcalDetDiagTimingClient::beginJob(), EgammaBasicClusters::beginJob(), EgammaSuperClusters::beginJob(), HcalBeamClient::beginJob(), MuonTrackAnalyzer::beginJob(), HcalTrigPrimClient::beginJob(), TestSuite::beginJob(), HcalDetDiagNoiseMonitorClient::beginJob(), HcalDetDiagPedestalClient::beginJob(), HcalDigiClient::beginJob(), HcalRawDataClient::beginJob(), HcalBaseDQClient::beginJob(), DQMSourceExample::beginJob(), HcalHotCellClient::beginJob(), MuonTrackResidualAnalyzer::beginJob(), HcalDetDiagLEDClient::beginJob(), HcalRecHitClient::beginJob(), PiZeroAnalyzer::beginJob(), EcalBarrelMonitorDbModule::EcalBarrelMonitorDbModule(), EcalEndcapMonitorDbModule::EcalEndcapMonitorDbModule(), RCTMonitor::endJob(), TrackEfficiencyMonitor::endJob(), BTagValidator::endJob(), TrackingMonitor::endJob(), DataCertificationJetMET::endJob(), DQMFileLoader::endJob(), SiStripMonitorTrack::endJob(), DQMHistAdder::endJob(), TrackSplittingMonitor::endJob(), LaserAlignmentT0ProducerDQM::endJob(), TopValidation::endJob(), HLTHiggsBits::endJob(), DataCertificationJetMET::endLuminosityBlock(), HLTScalersClient::endLuminosityBlock(), DataCertificationJetMET::endRun(), SiStripMonitorRawData::endRun(), SiStripMonitorQuality::endRun(), GlobalDigisAnalyzer::GlobalDigisAnalyzer(), GlobalDigisHistogrammer::GlobalDigisHistogrammer(), GlobalHitsAnalyzer::GlobalHitsAnalyzer(), GlobalHitsHistogrammer::GlobalHitsHistogrammer(), GlobalHitsProdHistStripper::GlobalHitsProdHistStripper(), GlobalRecHitsAnalyzer::GlobalRecHitsAnalyzer(), GlobalRecHitsHistogrammer::GlobalRecHitsHistogrammer(), HcalSimHitStudy::HcalSimHitStudy(), ZDCMonitorClient::initialize(), LaserDQM::initMonitors(), MixCollectionValidation::MixCollectionValidation(), MuonDTDigis::MuonDTDigis(), MuonSimHitsValidAnalyzer::MuonSimHitsValidAnalyzer(), HLXMonitor::SetupHists(), HistoProviderDQM::show(), and ZdcSimHitStudy::ZdcSimHitStudy().

{
  std::vector<std::string> contents;
  getContents(contents);

  std::cout << " ------------------------------------------------------------\n"
            << "                    Directory structure:                     \n"
            << " ------------------------------------------------------------\n";

  std::copy(contents.begin(), contents.end(),
            std::ostream_iterator<std::string>(std::cout, "\n"));

  std::cout << " ------------------------------------------------------------\n";
}

void DQMStore::softReset ( MonitorElement * me )

reset contents (does not erase contents permanently) (makes copy of current contents; will be subtracted from future contents)

Definition at line 2512 of file DQMStore.cc.

References MonitorElement::softReset().

Referenced by TrackingMonitor::beginLuminosityBlock(), TrackAnalyzer::doSoftReset(), HLXMonitor::FillHistograms(), HLXMonitor::ResetAll(), resetME(), EcalBarrelMonitorClient::softReset(), and EcalEndcapMonitorClient::softReset().

{
  if (me)
    me->softReset();
}

void DQMStore::tag	(	MonitorElement *	me,
		unsigned int	myTag
	)

tag ME as <myTag> (myTag > 0)

Definition at line 1156 of file DQMStore.cc.

References MonitorElement::data_, DQMNet::DQM_PROP_TAGGED, DQMNet::CoreObject::flags, MonitorElement::getFullname(), raiseDQMError(), and DQMNet::CoreObject::tag.

Referenced by ConverterTester::beginJob(), DQMSourceExample::beginJob(), SiStripBaseCondObjDQM::bookCumulMEs(), RPCMonitorDigi::bookDetUnitME(), SiStripMonitorTrack::bookModMEs(), SiStripBaseCondObjDQM::bookProfileMEs(), SiStripBaseCondObjDQM::bookSummaryCumulMEs(), SiStripBaseCondObjDQM::bookSummaryMEs(), SiStripBaseCondObjDQM::bookSummaryProfileMEs(), SiStripMonitorPedestals::createMEs(), SiStripMonitorCluster::createModuleMEs(), SiStripMonitorDigi::createModuleMEs(), RPCDqmClient::endRun(), extract(), get(), getContents(), EDMtoMEConverter::getData(), SiStripMonitorQuality::getQualityME(), GlobalHitsTester::GlobalHitsTester(), EBTimingTask::setup(), EBTestPulseTask::setup(), EBIntegrityTask::setup(), EEPedestalOnlineTask::setup(), EBStatusFlagsTask::setup(), EcalBarrelMonitorModule::setup(), EBPedestalTask::setup(), EELaserTask::setup(), EBOccupancyTask::setup(), EEStatusFlagsTask::setup(), EEIntegrityTask::setup(), EBTriggerTowerTask::setup(), EcalEndcapMonitorModule::setup(), EBLaserTask::setup(), EETriggerTowerTask::setup(), EETimingTask::setup(), EEOccupancyTask::setup(), EBPedestalOnlineTask::setup(), EETestPulseTask::setup(), EEPedestalTask::setup(), EELedTask::setup(), tag(), tagAllContents(), and tagContents().

{
  if (! myTag)
    raiseDQMError("DQMStore", "Attempt to tag monitor element '%s'"
                  " with a zero tag", me->getFullname().c_str());
  if ((me->data_.flags & DQMNet::DQM_PROP_TAGGED) && myTag != me->data_.tag)
    raiseDQMError("DQMStore", "Attempt to tag monitor element '%s'"
                  " twice with multiple tags", me->getFullname().c_str());

  me->data_.tag = myTag;
  me->data_.flags |= DQMNet::DQM_PROP_TAGGED;
}

void DQMStore::tag	(	const std::string &	path,
		unsigned int	myTag
	)

tag ME specified by full pathname (e.g. "my/long/dir/my_histo")

Definition at line 1171 of file DQMStore.cc.

References dir, findObject(), AlCaRecoCosmics_cfg::name, raiseDQMError(), splitPath(), and tag().

{
  std::string dir;
  std::string name;
  splitPath(dir, name, path);

  if (MonitorElement *me = findObject(dir, name))
    tag(me, myTag);
  else
    raiseDQMError("DQMStore", "Attempt to tag non-existent monitor element"
                  " '%s' with tag %u", path.c_str(), myTag);

}

void DQMStore::tagAllContents	(	const std::string &	path,
		unsigned int	myTag
	)

tag all children of folder, including all subfolders and their children; path must be an exact path name

Definition at line 1199 of file DQMStore.cc.

References clean, cleanTrailingSlashes(), data_, ExpressReco_HICollisions_FallBack::e, i, isSubdirectory(), and tag().

{
  std::string clean;
  const std::string *cleaned = 0;
  cleanTrailingSlashes(path, clean, cleaned);
  MonitorElement proto(cleaned, std::string());

  // FIXME: WILDCARDS? Old one supported them, but nobody seemed to use them.
  MEMap::iterator e = data_.end();
  MEMap::iterator i = data_.lower_bound(proto);
  while (i != e && isSubdirectory(*cleaned, *i->data_.dirname))
  {
    tag(const_cast<MonitorElement *>(&*i), myTag);
    ++i;
  }
}

void DQMStore::tagContents	(	const std::string &	path,
		unsigned int	myTag
	)

tag all children of folder (does NOT include subfolders)

Definition at line 1187 of file DQMStore.cc.

References data_, ExpressReco_HICollisions_FallBack::e, i, and tag().

Referenced by HLTMuonDQMSource::beginJob(), DQMSourceExample::beginJob(), and HLXMonitor::SetupHists().

{
  MonitorElement proto(&path, std::string());
  MEMap::iterator e = data_.end();
  MEMap::iterator i = data_.lower_bound(proto);
  for ( ; i != e && path == *i->data_.dirname; ++i)
    tag(const_cast<MonitorElement *>(&*i), myTag);
}

void DQMStore::useQTest	(	const std::string &	dir,
		const std::string &	qtname
	)

attach quality test <qtname> to directory contents (need exact pathname without wildcards, e.g. A/B/C);

Definition at line 2395 of file DQMStore.cc.

References clean, cleanTrailingSlashes(), raiseDQMError(), s_safe, and useQTestByMatch().

Referenced by createMeanValueTest(), createXRangeTest(), and createYRangeTest().

{
  // Clean the path
  std::string clean;
  const std::string *cleaned = 0;
  cleanTrailingSlashes(dir, clean, cleaned);

  // Validate the path.
  if (cleaned->find_first_not_of(s_safe) != std::string::npos)
    raiseDQMError("DQMStore", "Monitor element path name '%s'"
                  " uses unacceptable characters", cleaned->c_str());

  // Redirect to the pattern match version.
  useQTestByMatch(*cleaned + "/*", qtname);
}

int DQMStore::useQTestByMatch	(	const std::string &	pattern,
		const std::string &	qtname
	)

attach quality test <qc> to monitor elements matching <pattern>.

Definition at line 2413 of file DQMStore.cc.

References MonitorElement::addQReport(), data_, ExpressReco_HICollisions_FallBack::e, getQCriterion(), mergePath(), path(), qtestspecs_, and raiseDQMError().

Referenced by QTestHandle::attachTests(), and useQTest().

{
  QCriterion *qc = getQCriterion(qtname);
  if (! qc)
    raiseDQMError("DQMStore", "Cannot apply non-existent quality test '%s'",
                  qtname.c_str());

  // Clean the path
  lat::Regexp *rx = 0;
  try
  {
    rx = new lat::Regexp(pattern, 0, lat::Regexp::Wildcard);
    rx->study();
  }
  catch (lat::Error &e)
  {
    delete rx;
    raiseDQMError("DQMStore", "Invalid wildcard pattern '%s' in quality"
                  " test specification", pattern.c_str());
  }

  // Record the test for future reference.
  QTestSpec qts(rx, qc);
  qtestspecs_.push_back(qts);

  // Apply the quality test.
  MEMap::iterator mi = data_.begin();
  MEMap::iterator me = data_.end();
  std::string path;
  int cases = 0;
  for ( ; mi != me; ++mi)
  {
    path.clear();
    mergePath(path, *mi->data_.dirname, mi->data_.objname);
    if (rx->match(path))
    {
      ++cases;
      const_cast<MonitorElement &>(*mi).addQReport(qts.second);
    }
  }

  //return the number of matched cases
  return cases;
}

Friends And Related Function Documentation

friend class DQMNet [friend]

Definition at line 433 of file DQMStore.h.

friend class DQMOldReceiver [friend]

Definition at line 431 of file DQMStore.h.

friend class DQMService [friend]

Definition at line 432 of file DQMStore.h.

friend class DQMStoreExample [friend]

Definition at line 434 of file DQMStore.h.

friend class edm::DQMHttpSource [friend]

Definition at line 430 of file DQMStore.h.

Member Data Documentation

bool DQMStore::collateHistograms_ [private]

Definition at line 419 of file DQMStore.h.

Referenced by book(), bookFloat(), bookInt(), bookString(), DQMStore(), extract(), and load().

MEMap DQMStore::data_ [private]

Definition at line 423 of file DQMStore.h.

Referenced by book(), containsAnyMonitorable(), findObject(), DQMService::flush(), get(), getAllContents(), getAllTags(), getContents(), getMatchingContents(), getMEs(), getStatus(), readFile(), removeContents(), removeElement(), reset(), rmdir(), runQTests(), save(), tagAllContents(), tagContents(), and useQTestByMatch().

std::set<std::string> DQMStore::dirs_ [private]

Definition at line 424 of file DQMStore.h.

Referenced by book(), dirExists(), getAllTags(), getContents(), getSubdirs(), makeDirectory(), rmdir(), and save().

DQMStore::pwd_ [private]

Current directory.

Definition at line 422 of file DQMStore.h.

Referenced by book1D(), book1DD(), book1S(), book2D(), book2DD(), book2S(), book3D(), bookFloat(), bookInt(), bookProfile(), bookProfile2D(), bookString(), getMEs(), getSubdirs(), goUp(), pwd(), removeContents(), removeElement(), and setCurrentFolder().

DQMStore::qalgos_ [private]

Set of all the available quality test algorithms.

Definition at line 427 of file DQMStore.h.

Referenced by createQTest(), and DQMStore().

DQMStore::qtests_ [private]

All the quality tests.

Definition at line 426 of file DQMStore.h.

Referenced by createQTest(), getQCriterion(), and ~DQMStore().

QTestSpecs DQMStore::qtestspecs_ [private]

Definition at line 428 of file DQMStore.h.

Referenced by book(), useQTestByMatch(), and ~DQMStore().

DQMStore::readSelectedDirectory_ [private]

If non-empty, read from file only selected directory.

Definition at line 420 of file DQMStore.h.

DQMStore::reset_ [private]

Flag used to print out a warning when calling quality tests. twice without having called reset() in between; to be reset in DQMOldReceiver::runQualityTests.

Definition at line 418 of file DQMStore.h.

Referenced by reset(), and runQTests().

DQMStore::verbose_ [private]

Universal verbose flag for DQM.

Definition at line 416 of file DQMStore.h.

Referenced by book(), DQMStore(), extract(), load(), readDirectory(), readFile(), runQTests(), and save().