DQMStore Class Reference

#include <DQMStore.h>

Classes
class	IBooker
class	IGetter

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. More...
MonitorElement *	book1D (const std::string &name, const std::string &title, int nchX, double lowX, double highX)
	Book 1D histogram. More...
MonitorElement *	book1D (const char *name, const char *title, int nchX, const float *xbinsize)
	Book 1D variable bin histogram. More...
MonitorElement *	book1D (const std::string &name, const std::string &title, int nchX, const float *xbinsize)
	Book 1D variable bin histogram. More...
MonitorElement *	book1D (const char *name, TH1F *h)
	Book 1D histogram by cloning an existing histogram. More...
MonitorElement *	book1D (const std::string &name, TH1F *h)
	Book 1D histogram by cloning an existing histogram. More...
MonitorElement *	book1DD (const char *name, const char *title, int nchX, double lowX, double highX)
	Book 1S histogram. More...
MonitorElement *	book1DD (const std::string &name, const std::string &title, int nchX, double lowX, double highX)
	Book 1S histogram. More...
MonitorElement *	book1DD (const char *name, const char *title, int nchX, const float *xbinsize)
MonitorElement *	book1DD (const std::string &name, const std::string &title, int nchX, const float *xbinsize)
MonitorElement *	book1DD (const char *name, TH1D *h)
	Book 1D double histogram by cloning an existing histogram. More...
MonitorElement *	book1DD (const std::string &name, TH1D *h)
	Book 1D double histogram by cloning an existing histogram. More...
MonitorElement *	book1S (const char *name, const char *title, int nchX, double lowX, double highX)
	Book 1S histogram. More...
MonitorElement *	book1S (const std::string &name, const std::string &title, int nchX, double lowX, double highX)
	Book 1S histogram. More...
MonitorElement *	book1S (const char *name, const char *title, int nchX, const float *xbinsize)
MonitorElement *	book1S (const std::string &name, const std::string &title, int nchX, const float *xbinsize)
MonitorElement *	book1S (const char *name, TH1S *h)
	Book 1S histogram by cloning an existing histogram. More...
MonitorElement *	book1S (const std::string &name, TH1S *h)
	Book 1S histogram by cloning an existing histogram. More...
MonitorElement *	book2D (const char *name, const char *title, int nchX, double lowX, double highX, int nchY, double lowY, double highY)
	Book 2D histogram. More...
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. More...
MonitorElement *	book2D (const char *name, const char *title, int nchX, const float *xbinsize, int nchY, const float *ybinsize)
	Book 2D variable bin histogram. More...
MonitorElement *	book2D (const std::string &name, const std::string &title, int nchX, const float *xbinsize, int nchY, const float *ybinsize)
	Book 2D variable bin histogram. More...
MonitorElement *	book2D (const char *name, TH2F *h)
	Book 2D histogram by cloning an existing histogram. More...
MonitorElement *	book2D (const std::string &name, TH2F *h)
	Book 2D histogram by cloning an existing histogram. More...
MonitorElement *	book2DD (const char *name, const char *title, int nchX, double lowX, double highX, int nchY, double lowY, double highY)
	Book 2D double histogram. More...
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. More...
MonitorElement *	book2DD (const char *name, const char *title, int nchX, const float *xbinsize, int nchY, const float *ybinsize)
MonitorElement *	book2DD (const std::string &name, const std::string &title, int nchX, const float *xbinsize, int nchY, const float *ybinsize)
MonitorElement *	book2DD (const char *name, TH2D *h)
	Book 2DS histogram by cloning an existing histogram. More...
MonitorElement *	book2DD (const std::string &name, TH2D *h)
	Book 2DS histogram by cloning an existing histogram. More...
MonitorElement *	book2S (const char *name, const char *title, int nchX, double lowX, double highX, int nchY, double lowY, double highY)
	Book 2S histogram. More...
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. More...
MonitorElement *	book2S (const char *name, const char *title, int nchX, const float *xbinsize, int nchY, const float *ybinsize)
MonitorElement *	book2S (const std::string &name, const std::string &title, int nchX, const float *xbinsize, int nchY, const float *ybinsize)
MonitorElement *	book2S (const char *name, TH2S *h)
	Book 2DS histogram by cloning an existing histogram. More...
MonitorElement *	book2S (const std::string &name, TH2S *h)
	Book 2DS histogram by cloning an existing histogram. More...
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. More...
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. More...
MonitorElement *	book3D (const char *name, TH3F *h)
	Book 3D histogram by cloning an existing histogram. More...
MonitorElement *	book3D (const std::string &name, TH3F *h)
	Book 3D histogram by cloning an existing histogram. More...
MonitorElement *	bookFloat (const char *name)
	Book float. More...
MonitorElement *	bookFloat (const std::string &name)
	Book float. More...
MonitorElement *	bookInt (const char *name)
	Book int. More...
MonitorElement *	bookInt (const std::string &name)
	Book int. More...
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 std::string &name, const std::string &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, const double *xbinsize, int nchY, double lowY, double highY, const char *option="s")
MonitorElement *	bookProfile (const std::string &name, const std::string &title, int nchX, const double *xbinsize, int nchY, double lowY, double highY, const char *option="s")
MonitorElement *	bookProfile (const char *name, const char *title, int nchX, const double *xbinsize, double lowY, double highY, const char *option="s")
MonitorElement *	bookProfile (const std::string &name, const std::string &title, int nchX, const double *xbinsize, double lowY, double highY, const char *option="s")
MonitorElement *	bookProfile (const char *name, TProfile *h)
	Book TProfile by cloning an existing profile. More...
MonitorElement *	bookProfile (const std::string &name, TProfile *h)
	Book TProfile by cloning an existing profile. More...
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 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 *	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. More...
MonitorElement *	bookProfile2D (const std::string &name, TProfile2D *h)
	Book TProfile2D by cloning an existing profile. More...
MonitorElement *	bookString (const char *name, const char *value)
	Book string. More...
MonitorElement *	bookString (const std::string &name, const std::string &value)
	Book string. More...
template<typename iFunc >
void	bookTransaction (iFunc f, uint32_t run, uint32_t streamId, uint32_t moduleId)
void	cd (void)
	go to top directory (ie. root) More...
void	cd (const std::string &subdir)
	cd to subdirectory (if there) More...
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 More...
void	disableSoftReset (MonitorElement *me)
	DQMStore (const edm::ParameterSet &pset, edm::ActivityRegistry &)
	DQMStore (const edm::ParameterSet &pset)
MonitorElement *	get (const std::string &path) const
	get ME from full pathname (e.g. "my/long/dir/my_histo") More...
std::vector< MonitorElement * >	get (unsigned int tag) const
	get all MonitorElements tagged as <tag> More...
std::vector< MonitorElement * >	getAllContents (const std::string &path, uint32_t runNumber=0, uint32_t lumi=0) const
void	getAllTags (std::vector< std::string > &into) const
std::vector< MonitorElement * >	getContents (const std::string &path) const
std::vector< MonitorElement * >	getContents (const std::string &path, unsigned int tag) const
	same as above for tagged MonitorElements More...
void	getContents (std::vector< std::string > &into, bool showContents=true) 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 More...
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 .." More...
bool	isCollate (void) const
bool	load (const std::string &filename, OpenRunDirs stripdirs=StripRunDirs, bool fileMustExist=true)
template<typename iFunc >
void	meBookerGetter (iFunc f)
template<typename iFunc >
void	meGetter (iFunc f)
void	mergeAndResetMEsLuminositySummaryCache (uint32_t run, uint32_t lumi, uint32_t streamId, uint32_t moduleId)
void	mergeAndResetMEsRunSummaryCache (uint32_t run, uint32_t streamId, uint32_t moduleId)
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); More...
void	removeContents (const std::string &dir)
	remove all monitoring elements from directory; More...
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="", const uint32_t run=0, const uint32_t lumi=0, SaveReferenceTag ref=SaveWithReference, int minStatus=dqm::qstatus::STATUS_OK, const std::string &fileupdate="RECREATE", const bool resetMEsAfterWriting=false)
void	savePB (const std::string &filename, const std::string &path="", const uint32_t run=0, const uint32_t lumi=0, const bool resetMEsAfterWriting=false)
void	scaleElements (void)
void	setCurrentFolder (const std::string &fullpath)
void	setVerbose (unsigned level)
void	showDirStructure (void) const
void	softReset (MonitorElement *me)
void	tag (MonitorElement *me, unsigned int myTag)
void	tag (const std::string &path, unsigned int myTag)
	tag ME specified by full pathname (e.g. "my/long/dir/my_histo") More...
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) More...
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>. More...
	~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< fastmatch *, 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. More...
MonitorElement *	book1DD (const std::string &dir, const std::string &name, TH1D *h)
	Book 1D histogram based on TH1D. More...
MonitorElement *	book1S (const std::string &dir, const std::string &name, TH1S *h)
	Book 1D histogram based on TH1S. More...
MonitorElement *	book2D (const std::string &dir, const std::string &name, TH2F *h)
	Book 2D histogram based on TH2F. More...
MonitorElement *	book2DD (const std::string &dir, const std::string &name, TH2D *h)
	Book 2D histogram based on TH2D. More...
MonitorElement *	book2S (const std::string &dir, const std::string &name, TH2S *h)
	Book 2D histogram based on TH2S. More...
MonitorElement *	book3D (const std::string &dir, const std::string &name, TH3F *h)
	Book 3D histogram based on TH3F. More...
MonitorElement *	bookFloat (const std::string &dir, const std::string &name)
	Book float. More...
MonitorElement *	bookInt (const std::string &dir, const std::string &name)
	Book int. More...
MonitorElement *	bookProfile (const std::string &dir, const std::string &name, TProfile *h)
	Book profile histogram based on TProfile. More...
MonitorElement *	bookProfile2D (const std::string &folder, const std::string &name, TProfile2D *h)
	Book 2D profile histogram based on TProfile2D. More...
MonitorElement *	bookString (const std::string &dir, const std::string &name, const std::string &value)
	Book string. More...
bool	cdInto (const std::string &path) const
	DQMStore (const DQMStore &)
bool	extract (TObject *obj, const std::string &dir, bool overwrite, bool collateHistograms)
TObject *	extractNextObject (TBufferFile &) const
MonitorElement *	findObject (const std::string &dir, const std::string &name, const uint32_t run=0, const uint32_t lumi=0, const uint32_t streamId=0, const uint32_t moduleId=0) const
void	forceReset (void)
void	get_info (const dqmstorepb::ROOTFilePB_Histo &, std::string &dirname, std::string &objname, TObject **obj)
MonitorElement *	initialise (MonitorElement *me, const std::string &path)
void	initializeFrom (const edm::ParameterSet &)
bool	isCollateME (MonitorElement *me) const
void	makeDirectory (const std::string &path)
void	markForDeletion (uint32_t run, uint32_t lumi)
const DQMStore &	operator= (const DQMStore &)
void	print_trace (const std::string &dir, const std::string &name)
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)
bool	readFilePB (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, unsigned verbose)
static void	collate1D (MonitorElement *me, TH1F *h, unsigned verbose)
static void	collate1DD (MonitorElement *me, TH1D *h, unsigned verbose)
static void	collate1S (MonitorElement *me, TH1S *h, unsigned verbose)
static void	collate2D (MonitorElement *me, TH2F *h, unsigned verbose)
static void	collate2DD (MonitorElement *me, TH2D *h, unsigned verbose)
static void	collate2S (MonitorElement *me, TH2S *h, unsigned verbose)
static void	collate3D (MonitorElement *me, TH3F *h, unsigned verbose)
static void	collateProfile (MonitorElement *me, TProfile *h, unsigned verbose)
static void	collateProfile2D (MonitorElement *me, TProfile2D *h, unsigned verbose)

Private Attributes
std::mutex	book_mutex_
bool	collateHistograms_
MEMap	data_
std::set< std::string >	dirs_
bool	enableMultiThread_
bool	forceResetOnBeginLumi_
IBooker *	ibooker_
IGetter *	igetter_
bool	LSbasedMode_
uint32_t	moduleId_
std::string	pwd_
QAMap	qalgos_
QCMap	qtests_
QTestSpecs	qtestspecs_
std::string	readSelectedDirectory_
bool	reset_
uint32_t	run_
double	scaleFlag_
std::ofstream *	stream_
uint32_t	streamId_
unsigned	verbose_
unsigned	verboseQT_

Friends
class	DQMArchiver
class	DQMFileSaver
class	DQMNet
class	DQMRootOutputModule
class	DQMRootSource
class	DQMService
class	DQMStoreExample
class	edm::DQMHttpSource
class	MEtoEDMConverter

Detailed Description

Definition at line 75 of file DQMStore.h.

Member Typedef Documentation

typedef std::set<MonitorElement> DQMStore::MEMap

private

Definition at line 690 of file DQMStore.h.

typedef std::map<std::string, QCriterion *(*)(const std::string &)> DQMStore::QAMap

private

Definition at line 692 of file DQMStore.h.

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

private

Definition at line 691 of file DQMStore.h.

typedef std::pair<fastmatch *, QCriterion *> DQMStore::QTestSpec

private

Definition at line 688 of file DQMStore.h.

typedef std::list<QTestSpec> DQMStore::QTestSpecs

private

Definition at line 689 of file DQMStore.h.

Member Enumeration Documentation

enum DQMStore::OpenRunDirs

Enumerator
KeepRunDirs
StripRunDirs

Definition at line 84 of file DQMStore.h.

  {
    KeepRunDirs,
    StripRunDirs
  };

enum DQMStore::SaveReferenceTag

Enumerator
SaveWithoutReference
SaveWithReference
SaveWithReferenceForQTest

Definition at line 78 of file DQMStore.h.

  {
    SaveWithoutReference,
    SaveWithReference,
    SaveWithReferenceForQTest
  };

Constructor & Destructor Documentation

DQMStore::DQMStore	(	const edm::ParameterSet &	pset,
		edm::ActivityRegistry &	ar
	)

Definition at line 464 of file DQMStore.cc.

References edm::signalslot::Signal< T >::connect(), enableMultiThread_, forceReset(), forceResetOnBeginLumi_, edm::ParameterSet::getUntrackedParameter(), ibooker_, igetter_, initializeFrom(), edm::service::SystemBounds::maxNumberOfStreams(), edm::ActivityRegistry::preallocateSignal_, edm::ActivityRegistry::watchPostSourceLumi(), and edm::ActivityRegistry::watchPostSourceRun().

  : verbose_ (1),
    verboseQT_ (1),
    reset_ (false),
    collateHistograms_ (false),
    enableMultiThread_(false),
    forceResetOnBeginLumi_(false),
    readSelectedDirectory_ (""),
    run_(0),
    streamId_(0),
    moduleId_(0),
    stream_(nullptr),
    pwd_ (""),
    ibooker_(0),
    igetter_(0)
{
  if (!ibooker_)
    ibooker_ = new DQMStore::IBooker(this);
  if (!igetter_)
    igetter_ = new DQMStore::IGetter(this);
  initializeFrom(pset);

  if(pset.getUntrackedParameter<bool>("forceResetOnBeginRun",false)) {
    ar.watchPostSourceRun(this,&DQMStore::forceReset);
  }
  ar.preallocateSignal_.connect([this](edm::service::SystemBounds const& iBounds) {
      if(iBounds.maxNumberOfStreams() > 1 ) {
    enableMultiThread_ = true;
      }
    });
  if(pset.getUntrackedParameter<bool>("forceResetOnBeginLumi",false) && enableMultiThread_ == false) {
    forceResetOnBeginLumi_ = true;
    ar.watchPostSourceLumi(this,&DQMStore::forceReset);
  }
}

DQMStore::DQMStore

(

const edm::ParameterSet &

pset

)

Definition at line 500 of file DQMStore.cc.

References ibooker_, igetter_, and initializeFrom().

  : verbose_ (1),
    verboseQT_ (1),
    reset_ (false),
    collateHistograms_ (false),
    enableMultiThread_(false),
    readSelectedDirectory_ (""),
    run_(0),
    streamId_(0),
    moduleId_(0),
    stream_(nullptr),
    pwd_ (""),
    ibooker_(0),
    igetter_(0)
{
  if (!ibooker_)
    ibooker_ = new DQMStore::IBooker(this);
  if (!igetter_)
    igetter_ = new DQMStore::IGetter(this);
  initializeFrom(pset);
}

DQMStore::~DQMStore

(

void

)

Definition at line 522 of file DQMStore.cc.

References alignCSCRings::e, citk::for(), i, if(), qtests_, qtestspecs_, and stream_.

{
  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 (stream_)
    stream_->close();
  delete stream_;
}

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 830 of file DQMStore.cc.

References assert(), gather_cfg::cout, data_, dirs_, findObject(), mergePath(), moduleId_, mergeVDriftHistosByStation::name, cmsHarvester::path, print_trace(), run_, streamId_, AlCaHLTBitMon_QueryRunRegistry::string, and verbose_.

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

{
  assert(name.find('/') == std::string::npos);
  if (verbose_ > 3)
    print_trace(dir, name);

  // Check if the request monitor element already exists.
  if (MonitorElement *me = findObject(dir, name, run_, 0, streamId_, moduleId_))
  {
    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 proto(&*dirs_.find(dir), name, run_, streamId_, moduleId_);
    return &const_cast<MonitorElement &>(*data_.insert(proto).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 761 of file DQMStore.cc.

References assert(), collateHistograms_, gather_cfg::cout, data_, dir, dirs_, DQMNet::DQM_PROP_HAS_REFERENCE, findObject(), h, initialise(), class-composition::kind, mergePath(), moduleId_, mergeVDriftHistosByStation::name, cmsHarvester::path, print_trace(), qtestspecs_, MonitorElement::Reset(), run_, s_referenceDirName, streamId_, AlCaHLTBitMon_QueryRunRegistry::string, and verbose_.

{
  assert(name.find('/') == std::string::npos);
  if (verbose_ > 3)
    print_trace(dir, name);
  std::string path;
  mergePath(path, dir, name);

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

  // Check if the request monitor element already exists.
  MonitorElement *me = findObject(dir, name, run_, 0, streamId_, moduleId_);
  if (me)
  {
    if (collateHistograms_)
    {
      collate(me, h, verbose_);
      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, verbose_);
      delete h;
      return me;
    }
  }
  else
  {
    // Create and initialise core object.
    assert(dirs_.count(dir));
    MonitorElement proto(&*dirs_.find(dir), name, run_, streamId_, moduleId_);
    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 (findObject(refdir, name))
    {
      me->data_.flags |= DQMNet::DQM_PROP_HAS_REFERENCE;
    }
    // Return the monitor element.
    return me;
  }
}

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

Book 1D histogram.

Definition at line 975 of file DQMStore.cc.

References pwd_.

Referenced by DQMFEDIntegrityClient::beginJob(), EgammaBasicClusters::beginJob(), EgammaSuperClusters::beginJob(), ConverterTester::beginJob(), SimplePhotonAnalyzer::beginJob(), StripValidationPlots::beginJob(), APVValidationPlots::beginJob(), MuonAlignment::beginJob(), ValidationHcalIsoTrackAlCaReco::beginJob(), MCEmbeddingValidationAnalyzer::beginJob(), RPCBxTest::beginRun(), DQMProvInfo::beginRun(), MuonAlignmentSummary::beginRun(), MEtoMEComparitor::book(), DQMStore::IBooker::book1D(), book1D(), SiStripBaseCondObjDQM::bookCumulMEs(), TrackerOfflineValidationSummary::bookHarvestingHists(), PixelVTXMonitor::bookHistograms(), DQMLumiMonitor::bookHistograms(), MCEmbeddingValidationAnalyzer::plotEntryTypeEvtWeight::bookHistograms(), MCEmbeddingValidationAnalyzer::plotEntryTypeMuonRadCorrUncertainty::bookHistograms(), MCEmbeddingValidationAnalyzer::plotEntryTypeL1ETM::bookHistograms(), MCEmbeddingValidationAnalyzer::leptonDistributionT< T >::bookHistograms(), MCEmbeddingValidationAnalyzer::electronDistributionExtra::bookHistograms(), MCEmbeddingValidationAnalyzer::tauDistributionExtra::bookHistograms(), MCEmbeddingValidationAnalyzer::leptonEfficiencyT< T >::bookHistograms(), MCEmbeddingValidationAnalyzer::leptonL1TriggerEfficiencyT1T2< T1, T2 >::bookHistograms(), MCEmbeddingValidationAnalyzer::l1ExtraObjectDistributionT< T >::bookHistograms(), MCEmbeddingValidationAnalyzer::metDistributionType::bookHistograms(), MCEmbeddingValidationAnalyzer::metL1TriggerEfficiencyType::bookHistograms(), SiStripBaseCondObjDQM::bookProfileMEs(), SiStripBaseCondObjDQM::bookSummaryCumulMEs(), dqmRegisterHistogram(), HarvestingAnalyzer::endJob(), HLTScalersClient::endLuminosityBlock(), DQMDcsInfoClient::endRun(), TauDQMHistEffProducer::endRun(), GlobalHitsProdHistStripper::endRun(), extract(), SiStripQualityDQM::fillGrandSummaryMEs(), EgHLTOfflineClient::FillHLTvsOfflineHist(), SiStripSummaryCreator::getSummaryME(), HEff1DHit::HEff1DHit(), HEff2DHit::HEff2DHit(), HEff4DHit::HEff4DHit(), HLTScalersClient::HLTScalersClient(), HRes1DHit::HRes1DHit(), HRes2DHit::HRes2DHit(), HRes4DHit::HRes4DHit(), SiStripBadAPVandHotStripAlgorithmFromClusterOccupancy::initializeDQMHistograms(), LaserDQM::initMonitors(), L1ScalersClient::L1ScalersClient(), EgHLTOfflineClient::makeEffMonElem2Leg(), EgHLTOfflineClient::makeEffMonElemFromPassAndAll(), EgHLTOfflineClient::makeEffMonElemFromPassAndFail(), EgHLTOfflineClient::makeEffMonElemFromPassAndFailAndTagTag(), and MonitorElementsDb::MonitorElementsDb().

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

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

Book 1D histogram.

Definition at line 983 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,
		const float *	xbinsize
	)

Book 1D variable bin histogram.

Definition at line 1023 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,
		const float *	xbinsize
	)

Book 1D variable bin histogram.

Definition at line 1031 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 1039 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 1046 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 &  dir, const std::string &  name, TH1F *  h  )

private

Book 1D histogram based on TH1F.

Definition at line 954 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 1007 of file DQMStore.cc.

References pwd_.

Referenced by MEtoMEComparitor::book(), DQMStore::IBooker::book1DD(), book1DD(), and extract().

{
  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 1015 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 char *	name,
		const char *	title,
		int	nchX,
		const float *	xbinsize
	)

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

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

Book 1D double histogram by cloning an existing histogram.

Definition at line 1067 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 1074 of file DQMStore.cc.

References book1DD(), and pwd_.

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

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

private

Book 1D histogram based on TH1D.

Definition at line 968 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::book1S	(	const char *	name,
		const char *	title,
		int	nchX,
		double	lowX,
		double	highX
	)

Book 1S histogram.

Definition at line 991 of file DQMStore.cc.

References pwd_.

Referenced by MEtoMEComparitor::book(), DQMStore::IBooker::book1S(), book1S(), dqmRegisterHistogram(), and extract().

{
  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 999 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,
		const float *	xbinsize
	)

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

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

Book 1S histogram by cloning an existing histogram.

Definition at line 1053 of file DQMStore.cc.

References book1S(), and pwd_.

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

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

Book 1S histogram by cloning an existing histogram.

Definition at line 1060 of file DQMStore.cc.

References book1S(), and pwd_.

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

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

private

Book 1D histogram based on TH1S.

Definition at line 961 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 1103 of file DQMStore.cc.

References pwd_.

Referenced by DQMFEDIntegrityClient::beginJob(), EgammaBasicClusters::beginJob(), EgammaSuperClusters::beginJob(), ConverterTester::beginJob(), APVValidationPlots::beginJob(), StripValidationPlots::beginJob(), HcalDCSInfo::beginJob(), MuonAlignment::beginJob(), ValidationHcalIsoTrackAlCaReco::beginJob(), MCEmbeddingValidationAnalyzer::beginJob(), DQMProvInfo::beginRun(), ZDCMonitorClient::beginRun(), MuonAlignmentSummary::beginRun(), DQMStore::IBooker::book2D(), book2D(), MCEmbeddingValidationAnalyzer::plotEntryTypeL1ETM::bookHistograms(), SiStripCertificationInfo::bookSiStripCertificationMEs(), SiStripQualityChecker::bookStatus(), dqmRegisterHistogram(), DQMDcsInfoClient::endRun(), extract(), EgHLTOfflineSummaryClient::getEgHLTSumHist_(), HRes1DHit::HRes1DHit(), HRes2DHit::HRes2DHit(), HRes4DHit::HRes4DHit(), SiStripBadAPVandHotStripAlgorithmFromClusterOccupancy::initializeDQMHistograms(), L1ScalersClient::L1ScalersClient(), and MonitorElementsDb::MonitorElementsDb().

{
  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 1114 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,
		const float *	xbinsize,
		int	nchY,
		const float *	ybinsize
	)

Book 2D variable bin histogram.

Definition at line 1169 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,
		const float *	xbinsize,
		int	nchY,
		const float *	ybinsize
	)

Book 2D variable bin histogram.

Definition at line 1178 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 1187 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 1194 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 1082 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 1147 of file DQMStore.cc.

References pwd_.

Referenced by AcceptanceHistoProducer::beginJob(), DQMStore::IBooker::book2DD(), book2DD(), and extract().

{
  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 1158 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,
		const float *	xbinsize,
		int	nchY,
		const float *	ybinsize
	)

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

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

Book 2DS histogram by cloning an existing histogram.

Definition at line 1215 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 1222 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 1096 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 1125 of file DQMStore.cc.

References pwd_.

Referenced by DQMStore::IBooker::book2S(), book2S(), dqmRegisterHistogram(), and extract().

{
  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 1136 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,
		const float *	xbinsize,
		int	nchY,
		const float *	ybinsize
	)

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

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

Book 2DS histogram by cloning an existing histogram.

Definition at line 1201 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 1208 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 1089 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 1237 of file DQMStore.cc.

References pwd_.

Referenced by ConverterTester::beginJob(), DQMStore::IBooker::book3D(), book3D(), dqmRegisterHistogram(), and extract().

{
  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 1250 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 1263 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 1270 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 1230 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 char *

name

)

Book float.

Definition at line 912 of file DQMStore.cc.

References pwd_.

Referenced by DQMFEDIntegrityClient::beginJob(), ConverterTester::beginJob(), HcalDCSInfo::beginJob(), DQMDaqInfo::beginJob(), ZDCMonitorClient::beginRun(), DQMProvInfo::beginRun(), DQMStore::IBooker::bookFloat(), bookFloat(), SiStripCertificationInfo::bookSiStripCertificationMEs(), SiStripQualityChecker::bookStatus(), SiStripDaqInfo::bookStatus(), SiStripDcsInfo::bookStatus(), DQMDcsInfoClient::endRun(), extract(), EgHLTOfflineSummaryClient::runClient_(), and SubTaskSummaryStatus::WriteThreshold().

{ return bookFloat(pwd_, name); }

MonitorElement * DQMStore::bookFloat

(

const std::string &

name

)

Book float.

Definition at line 917 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 895 of file DQMStore.cc.

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

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

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

MonitorElement * DQMStore::bookInt

(

const char *

name

)

Book int.

Definition at line 882 of file DQMStore.cc.

References pwd_.

Referenced by SiStripDcsInfo::addBadModules(), ConverterTester::beginJob(), DQMProvInfo::beginRun(), CalibrationScanTask::book(), CalibrationTask::book(), FineDelayTask::book(), DQMStore::IBooker::bookInt(), bookInt(), extract(), SiStripQualityChecker::fillFaultyModuleStatus(), SiStripDaqInfo::findExcludedModule(), and DQMProvInfo::makeProvInfo().

{ return bookInt(pwd_, name); }

MonitorElement * DQMStore::bookInt

(

const std::string &

name

)

Book int.

Definition at line 887 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 865 of file DQMStore.cc.

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

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

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

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 1289 of file DQMStore.cc.

References pwd_.

Referenced by ConverterTester::beginJob(), StripValidationPlots::beginJob(), SiStripLAProfileBooker::beginRun(), DQMLumiMonitor::bookHistograms(), DQMStore::IBooker::bookProfile(), bookProfile(), SiStripBaseCondObjDQM::bookSummaryMEs(), SiStripBaseCondObjDQM::bookSummaryProfileMEs(), dqmRegisterHistogram(), extract(), SiStripBadAPVandHotStripAlgorithmFromClusterOccupancy::initializeDQMHistograms(), and MonitorElementsDb::MonitorElementsDb().

{
  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 1304 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 1319 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 1334 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,
		const 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 1349 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,
		const 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 1364 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,
		const 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 1379 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,
		const 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 1394 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,
		TProfile *	h
	)

Book TProfile by cloning an existing profile.

Definition at line 1407 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 1414 of file DQMStore.cc.

References bookProfile(), and pwd_.

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

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

private

Book profile histogram based on TProfile.

Definition at line 1278 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::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 1433 of file DQMStore.cc.

References pwd_.

Referenced by ConverterTester::beginJob(), DQMLumiMonitor::bookHistograms(), DQMStore::IBooker::bookProfile2D(), bookProfile2D(), TkHistoMap::createTkHistoMap(), dqmRegisterHistogram(), extract(), and MonitorElementsDb::MonitorElementsDb().

{
  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 1450 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 1467 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 1484 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 1499 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 1506 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 1422 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 char *	name,
		const char *	value
	)

Book string.

Definition at line 941 of file DQMStore.cc.

References pwd_.

Referenced by DQMFileReader::beginJob(), ConverterTester::beginJob(), DQMDcsInfoClient::beginRun(), DQMStore::IBooker::bookString(), bookString(), extract(), DQMProvInfo::makeHLTKeyInfo(), and DQMProvInfo::makeProvInfo().

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

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

Book string.

Definition at line 946 of file DQMStore.cc.

References bookString(), and pwd_.

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

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

private

Book string.

Definition at line 925 of file DQMStore.cc.

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

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

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

template<typename iFunc >

void DQMStore::bookTransaction ( iFunc  f, uint32_t  run, uint32_t  streamId, uint32_t  moduleId  )

inline

Definition at line 241 of file DQMStore.h.

References book_mutex_, enableMultiThread_, f, ibooker_, moduleId_, DTTTrigCorrFirst::run, run_, and streamId_.

Referenced by DQMEDAnalyzer::beginRun(), and thread_unsafe::DQMEDAnalyzer::beginRun().

                                  {
    std::lock_guard<std::mutex> guard(book_mutex_);
    /* If enableMultiThread is not enabled we do not set run_,
       streamId_ and moduleId_ to 0, since we rely on their default
       initialization in DQMStore constructor. */
    if (enableMultiThread_) {
      run_ = run;
      streamId_ = streamId;
      moduleId_ = moduleId;
    }
    f(*ibooker_);

    /* Initialize to 0 the run_, streamId_ and moduleId_ variables
       in case we run in mixed conditions with DQMEDAnalyzers and
       legacy modules */
    if (enableMultiThread_) {
      run_ = 0;
      streamId_ = 0;
      moduleId_ = 0;
    }
  }

void DQMStore::cd

(

void

)

go to top directory (ie. root)

Definition at line 665 of file DQMStore.cc.

References setCurrentFolder().

Referenced by SiStripDcsInfo::addBadModules(), DQMFileReader::beginJob(), DQMDcsInfoClient::beginRun(), DQMProvInfo::beginRun(), SiStripCertificationInfo::bookSiStripCertificationMEs(), SiStripQualityChecker::bookStatus(), SiStripDaqInfo::bookStatus(), SiStripDcsInfo::bookStatus(), DQMStore::IBooker::cd(), SiStripTrackerMapCreator::createForOffline(), SiStripSummaryCreator::createSummary(), SiStripActionExecutor::createSummary(), SiStripActionExecutor::createSummaryOffline(), APVValidationPlots::endJob(), StripValidationPlots::endJob(), SiStripOfflineDQM::endJob(), DQMDcsInfoClient::endRun(), SiStripBadAPVandHotStripAlgorithmFromClusterOccupancy::extractBadAPVSandStrips(), SiStripQualityChecker::fillDetectorStatus(), SiStripQualityChecker::fillDetectorStatusAtLumi(), SiStripQualityChecker::fillFaultyModuleStatus(), SiStripSummaryCreator::fillGrandSummaryHistos(), SiStripCertificationInfo::fillSiStripCertificationMEs(), SiStripCertificationInfo::fillSiStripCertificationMEsAtLumi(), SiStripQualityChecker::fillSubDetStatus(), SiStripSummaryCreator::fillSummaryHistos(), SiStripDaqInfo::findExcludedModule(), dqm_interfaces.DQMcommunicator::get_root_objects_list_recursive(), dqm_interfaces.DQMcommunicator::get_root_objects_names_list_recursive(), dqm_interfaces.DQMcommunicator::get_root_objects_recursive(), SiStripTrackerMapCreator::getDetectorFlagAndComment(), SiStripUtility::getModuleFolderList(), SiStripSummaryCreator::getSummaryME(), SiStripUtility::getTopFolderPath(), SiStripUtility::goToDir(), DQMProvInfo::makeHLTKeyInfo(), DQMProvInfo::makeProvInfo(), SiStripInformationExtractor::printAlarmList(), SiStripActionExecutor::printFaultyModuleList(), SiStripInformationExtractor::printNonGeomHistoList(), SiStripInformationExtractor::printSummaryHistoList(), readFilePB(), ZDCMonitorClient::removeAllME(), SiStripTrackerMapCreator::setTkMapFromHistogram(), and dqm_interfaces.DirWalkerFile::walk().

{ setCurrentFolder(""); }

void DQMStore::cd

(

const std::string &

subdir

)

cd to subdirectory (if there)

Definition at line 670 of file DQMStore.cc.

References clean, cleanTrailingSlashes(), dirExists(), raiseDQMError(), setCurrentFolder(), and AlCaHLTBitMon_QueryRunRegistry::string.

Referenced by dqm_interfaces.DQMcommunicator::get_root_objects_list_recursive(), dqm_interfaces.DQMcommunicator::get_root_objects_names_list_recursive(), dqm_interfaces.DQMcommunicator::get_root_objects_recursive(), and dqm_interfaces.DirWalkerFile::walk().

{
  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 2396 of file DQMStore.cc.

References assert(), end, python.connectstrParser::o, raiseDQMError(), dqm_diff::start, and AlCaHLTBitMon_QueryRunRegistry::string.

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, unsigned  verbose  )

staticprivate

Definition at line 1515 of file DQMStore.cc.

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

Referenced by collate1D(), collate1DD(), collate1S(), collate2D(), collate2DD(), collate2S(), collate3D(), collateProfile(), collateProfile2D(), utils.BinToBin::do_test(), and utils.BinToBin1percent::do_test().

{
  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()
      || !MonitorElement::CheckBinLabels((TAxis*)me->getTH1()->GetXaxis(),(TAxis*)h->GetXaxis())
      || !MonitorElement::CheckBinLabels((TAxis*)me->getTH1()->GetYaxis(),(TAxis*)h->GetYaxis())
      || !MonitorElement::CheckBinLabels((TAxis*)me->getTH1()->GetZaxis(),(TAxis*)h->GetZaxis()) )
  {
    if(verbose > 0)
      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, unsigned  verbose  )

staticprivate

Definition at line 1542 of file DQMStore.cc.

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

Referenced by book1D(), and extract().

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

void DQMStore::collate1DD ( MonitorElement *  me, TH1D *  h, unsigned  verbose  )

staticprivate

Definition at line 1556 of file DQMStore.cc.

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

Referenced by book1DD(), and extract().

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

void DQMStore::collate1S ( MonitorElement *  me, TH1S *  h, unsigned  verbose  )

staticprivate

Definition at line 1549 of file DQMStore.cc.

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

Referenced by book1S(), and extract().

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

void DQMStore::collate2D ( MonitorElement *  me, TH2F *  h, unsigned  verbose  )

staticprivate

Definition at line 1563 of file DQMStore.cc.

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

Referenced by book2D(), and extract().

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

void DQMStore::collate2DD ( MonitorElement *  me, TH2D *  h, unsigned  verbose  )

staticprivate

Definition at line 1577 of file DQMStore.cc.

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

Referenced by book2DD(), and extract().

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

void DQMStore::collate2S ( MonitorElement *  me, TH2S *  h, unsigned  verbose  )

staticprivate

Definition at line 1570 of file DQMStore.cc.

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

Referenced by book2S(), and extract().

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

void DQMStore::collate3D ( MonitorElement *  me, TH3F *  h, unsigned  verbose  )

staticprivate

Definition at line 1584 of file DQMStore.cc.

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

Referenced by book3D(), and extract().

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

void DQMStore::collateProfile ( MonitorElement *  me, TProfile *  h, unsigned  verbose  )

staticprivate

Definition at line 1591 of file DQMStore.cc.

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

Referenced by bookProfile(), and extract().

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

void DQMStore::collateProfile2D ( MonitorElement *  me, TProfile2D *  h, unsigned  verbose  )

staticprivate

Definition at line 1601 of file DQMStore.cc.

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

Referenced by bookProfile2D(), and extract().

{
  if (checkBinningMatches(me,h,verbose))
  {
    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 1719 of file DQMStore.cc.

References data_, alignCSCRings::e, i, isSubdirectory(), and AlCaHLTBitMon_QueryRunRegistry::string.

{
  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 3206 of file DQMStore.cc.

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

Referenced by createH2CompTest(), createMeanValueTest(), createXRangeTest(), createYRangeTest(), QTestConfigure::EnableCheckVarianceTest(), QTestConfigure::EnableComp2RefChi2Test(), QTestConfigure::EnableComp2RefEqualHTest(), QTestConfigure::EnableComp2RefKolmogorovTest(), QTestConfigure::EnableCompareLastFilledBinTest(), QTestConfigure::EnableCompareToMedianTest(), QTestConfigure::EnableContentsWithinExpectedTest(), QTestConfigure::EnableDeadChannelTest(), QTestConfigure::EnableMeanWithinExpectedTest(), QTestConfigure::EnableNoisyChannelTest(), QTestConfigure::EnableXRangeTest(), and QTestConfigure::EnableYRangeTest().

{
  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 753 of file DQMStore.cc.

References dirs_.

Referenced by cd(), SiStripActionExecutor::createSummary(), TauDQMHistEffProducer::endRun(), SiStripQualityChecker::fillDetectorStatus(), SiStripQualityChecker::fillFaultyModuleStatus(), SiStripDaqInfo::findExcludedModule(), SiStripTrackerMapCreator::getDetectorFlagAndComment(), SiStripUtility::getTopFolderPath(), SiStripActionExecutor::printFaultyModuleList(), ZDCMonitorClient::removeAllME(), scaleElements(), and SiStripTrackerMapCreator::setTkMapFromHistogram().

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

void DQMStore::disableSoftReset

(

MonitorElement *

me

)

Definition at line 3340 of file DQMStore.cc.

References MonitorElement::disableSoftReset().

Referenced by ecaldqm::MESet::recoverStats(), and TrackAnalyzer::undoSoftReset().

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

bool DQMStore::extract ( TObject *  obj, const std::string &  dir, bool  overwrite, bool  collateHistograms  )

private

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

Definition at line 2100 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(), class-composition::kind, diffTwoXMLs::label, contentValuesFiles::m, autoMagneticFieldProducer_cfi::master, DQMNet::QValue::message, gen::n, MonitorElement::object_, DQMNet::QValue::qtname, DQMNet::QValue::qtresult, alignCSCRings::s, s_referenceDirName, s_rxmeqr1(), s_rxmeqr2(), s_rxmeval(), MonitorElement::setEfficiencyFlag(), AlCaHLTBitMon_QueryRunRegistry::string, tag(), relativeConstraints::value, and verbose_.

Referenced by BeautifulSoup.PageElement::_invert(), BeautifulSoup.Tag::decompose(), readDirectory(), and readFilePB().

{
  // 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, verbose_);
    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, verbose_);
    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, verbose_);
    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, verbose_);
    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, verbose_);
    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, verbose_);
    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, verbose_);
    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, verbose_);
    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, verbose_);
    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 == "e")
    {
      MonitorElement *me = findObject(dir, label);
      if (! me)
      {
        std::cout << "*** DQMStore: WARNING: no monitor element '"
                  << label << "' in directory '"
                  << dir << "' to be marked as efficiency plot.\n";
        return false;
      }
      me->setEfficiencyFlag();
    }
    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, collateHistograms_);
  }
  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;
}

TObject * DQMStore::extractNextObject ( TBufferFile &  buf ) const

inlineprivate

Extract the next serialised ROOT object from @a buf. Returns null

if there are no more objects in the buffer, or a null pointer was serialised at this location.

Definition at line 3018 of file DQMStore.cc.

Referenced by get_info().

                                                                   {
  if (buf.Length() == buf.BufferSize())
    return 0;
  buf.InitMap();
  void *ptr = buf.ReadObjectAny(0);
  return reinterpret_cast<TObject *>(ptr);
}

MonitorElement * DQMStore::findObject ( const std::string &  dir, const std::string &  name, const uint32_t  run = 0, const uint32_t  lumi = 0, const uint32_t  streamId = 0, const uint32_t  moduleId = 0  ) const

private

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

Definition at line 1859 of file DQMStore.cc.

References MonitorElement::data_, data_, dir, DQMNet::CoreObject::dirname, fjr2json::lumi, DQMNet::CoreObject::lumi, DQMNet::CoreObject::moduleId, mergeVDriftHistosByStation::name, DQMNet::CoreObject::objname, raiseDQMError(), DTTTrigCorrFirst::run, DQMNet::CoreObject::run, s_safe, and DQMNet::CoreObject::streamId.

Referenced by book(), bookFloat(), bookInt(), bookString(), extract(), makeDirectory(), readFilePB(), 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;
  proto.data_.run      = run;
  proto.data_.lumi     = lumi;
  proto.data_.streamId = streamId;
  proto.data_.moduleId = moduleId;

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

void DQMStore::forceReset ( void  )

private

Invoke this method after flushing all recently changed monitoring. Clears updated flag on all MEs and calls their Reset() method.

Definition at line 2040 of file DQMStore.cc.

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

Referenced by DQMStore().

{
  MEMap::iterator mi = data_.begin();
  MEMap::iterator me = data_.end();
  for ( ; mi != me; ++mi)
  {
    if (forceResetOnBeginLumi_ && ((*mi).getLumiFlag() == false))
      continue;
    MonitorElement &me = const_cast<MonitorElement &>(*mi);
    me.Reset();
    me.resetUpdate();
  }

  reset_ = true;
}

MonitorElement * DQMStore::get

(

const std::string &

path

)

const

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

Definition at line 1729 of file DQMStore.cc.

References data_, dir, mergeVDriftHistosByStation::name, splitPath(), and AlCaHLTBitMon_QueryRunRegistry::string.

Referenced by Options.Options::__getitem__(), betterConfigParser.BetterConfigParser::__updateDict(), SiStripDcsInfo::addBadModules(), TrackerOfflineValidationSummary::associateModuleHistsWithTree(), RPCBxTest::beginRun(), ZDCMonitorClient::beginRun(), CalibrationScanTask::book(), CalibrationTask::book(), rrapi.RRApi::columns(), rrapi.RRApi::count(), createH2CompTest(), createH2ContentTest(), EgHLTOfflineClient::createHLTvsOfflineHists(), EgHLTOfflineClient::createLooseTightTrigEff(), EgHLTOfflineClient::createN1EffHists(), SiStripActionExecutor::createShiftReport(), EgHLTOfflineClient::createSingleEffHists(), EgHLTOfflineClient::createTrigTagProbeEffHists(), EgHLTOfflineClient::createTrigTagProbeEffHists2Leg(), EgHLTOfflineClient::createTrigTagProbeEffHistsNewAlgo(), rrapi.RRApi::data(), dqmCopyRecursively(), HarvestingAnalyzer::endJob(), MuonAlignment::endJob(), DQMDcsInfoClient::endLuminosityBlock(), SiStripMonitorDigi::endLuminosityBlock(), L1ScalersClient::endLuminosityBlock(), HLTScalersClient::endLuminosityBlock(), DQMDcsInfoClient::endRun(), TauDQMHistEffProducer::endRun(), MuonAlignmentSummary::endRun(), TauDQMHistPlotter::endRun(), ZDCMonitorClient::errorSummary(), SiStripQualityChecker::fillDetectorStatusAtLumi(), SiStripQualityChecker::fillFaultyModuleStatus(), DQMFEDIntegrityClient::fillHistograms(), EgHLTOfflineClient::FillHLTvsOfflineHist(), SiStripCertificationInfo::fillSiStripCertificationMEs(), SiStripCertificationInfo::fillSiStripCertificationMEsAtLumi(), PFDQMEventSelector::filter(), SiStripDaqInfo::findExcludedModule(), getAnyHisto(), betterConfigParser.BetterConfigParser::getCompares(), SiStripTrackerMapCreator::getDetectorFlagAndComment(), EgHLTOfflineSummaryClient::getEgHLTSumHist_(), betterConfigParser.BetterConfigParser::getGeneral(), getHisto(), getHisto2(), getHistoTH3F(), getHistoTProfile(), getHistoTProfile2D(), SiStripQualityChecker::getModuleStatus(), betterConfigParser.BetterConfigParser::getResultingSection(), getTH1F(), getTH2F(), getTH3F(), getTProfile(), getTProfile2D(), htmlErrors(), TkHistoMap::loadTkHistoMap(), EgHLTOfflineClient::makeEffMonElem2Leg(), EgHLTOfflineClient::makeEffMonElemFromPassAndAll(), EgHLTOfflineClient::makeEffMonElemFromPassAndFail(), EgHLTOfflineClient::makeEffMonElemFromPassAndFailAndTagTag(), SiStripHistoPlotter::makePlot(), SiStripInformationExtractor::plotHistosFromLayout(), SiStripActionExecutor::printShiftHistoParameters(), QTestStatusChecker::processAlarms(), rrapi.RRApi::report(), rrapi.RRApi::reports(), resetME(), EgHLTOfflineSummaryClient::runClient_(), rrapi.RRApi::tables(), rrapi.RRApi::tags(), rrapi.RRApi::templates(), rrapi.RRApi::workspaces(), and SubTaskSummaryStatus::WriteThreshold().

{
  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 1742 of file DQMStore.cc.

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

Referenced by Options.Options::__getitem__(), betterConfigParser.BetterConfigParser::__updateDict(), rrapi.RRApi::columns(), rrapi.RRApi::count(), rrapi.RRApi::data(), betterConfigParser.BetterConfigParser::getCompares(), betterConfigParser.BetterConfigParser::getGeneral(), betterConfigParser.BetterConfigParser::getResultingSection(), rrapi.RRApi::report(), rrapi.RRApi::reports(), rrapi.RRApi::tables(), rrapi.RRApi::tags(), rrapi.RRApi::templates(), and rrapi.RRApi::workspaces().

{
  // 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;
}

void DQMStore::get_info ( const dqmstorepb::ROOTFilePB_Histo &  h, std::string &  dirname, std::string &  objname, TObject **  obj  )

private

Definition at line 3026 of file DQMStore.cc.

References extractNextObject(), dqmstorepb::ROOTFilePB_Histo::full_pathname(), raiseDQMError(), dqmstorepb::ROOTFilePB_Histo::size(), pickleFileParser::slash, and dqmstorepb::ROOTFilePB_Histo::streamed_histo().

Referenced by readFilePB().

                                        {

  size_t slash = h.full_pathname().rfind('/');
  size_t dirpos = (slash == std::string::npos ? 0 : slash);
  size_t namepos = (slash == std::string::npos ? 0 : slash+1);
  dirname.assign(h.full_pathname(), 0, dirpos);
  objname.assign(h.full_pathname(), namepos, std::string::npos);
  TBufferFile buf(TBufferFile::kRead, h.size(),
                  (void*)h.streamed_histo().data(),
                  kFALSE);
  buf.Reset();
  *obj = extractNextObject(buf);
  if (!*obj) {
    raiseDQMError("DQMStore", "Error reading element:'%s'" , h.full_pathname().c_str());
  }
}

std::vector< MonitorElement * > DQMStore::getAllContents	(	const std::string &	path,
		uint32_t	runNumber = 0,
		uint32_t	lumi = 0
	)		const

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

Definition at line 1942 of file DQMStore.cc.

References assert(), clean, cleanTrailingSlashes(), data_, alignCSCRings::e, i, isSubdirectory(), or, query::result, MonitorElement::setLumi(), and AlCaHLTBitMon_QueryRunRegistry::string.

Referenced by SiStripCalibLorentzAngle::algoBeginJob(), edmtest::DQMReferenceHistogramRootFileEventSetupAnalyzer::beginRun(), SiStripQualityHotStripIdentifierRoot::bookHistos(), DQMHistoryServiceBase::createSummary(), StatisticsFilter::filter(), DQMRootOutputModule::writeLuminosityBlock(), and DQMRootOutputModule::writeRun().

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

  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 (runNumber != 0) {
      if (i->data_.run > runNumber // TODO[rovere]: pleonastic? first we encounter local ME of the same run ...
          || i->data_.streamId != 0
          || i->data_.moduleId != 0)
        break;
    }
    if (lumi != 0) {
      if (i->data_.lumi > lumi
          || i->data_.streamId != 0
          || i->data_.moduleId != 0)
        break;
    }
    if (runNumber != 0 or lumi !=0) {
      assert(i->data_.streamId == 0);
      assert(i->data_.moduleId == 0);
    }
    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 1889 of file DQMStore.cc.

References data_, dirs_, DQMNet::DQM_PROP_TAGGED, isSubdirectory(), contentValuesFiles::m, contentValuesCheck::nfound, and AlCaHLTBitMon_QueryRunRegistry::string.

{
  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

)

const

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

Definition at line 1758 of file DQMStore.cc.

References clean, cleanTrailingSlashes(), data_, alignCSCRings::e, i, isSubdirectory(), query::result, and AlCaHLTBitMon_QueryRunRegistry::string.

Referenced by SiStripSummaryCreator::fillGrandSummaryHistos(), SiStripCertificationInfo::fillSiStripCertificationMEs(), SiStripQualityChecker::fillSubDetStatus(), SiStripSummaryCreator::fillSummaryHistos(), QTestStatusChecker::fullPathNames(), DQMStore::IGetter::getContents(), SiStripSummaryCreator::getSummaryME(), SiStripHistoPlotter::makeCondDBPlots(), SiStripInformationExtractor::printAlarmList(), SiStripActionExecutor::printFaultyModuleList(), SiStripInformationExtractor::printNonGeomHistoList(), SiStripInformationExtractor::printSummaryHistoList(), SiStripTrackerMapCreator::setTkMapFromHistogram(), and showDirStructure().

{
  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::getContents	(	const std::string &	path,
		unsigned int	tag
	)		const

same as above for tagged MonitorElements

Definition at line 1777 of file DQMStore.cc.

References clean, cleanTrailingSlashes(), data_, DQMNet::DQM_PROP_TAGGED, alignCSCRings::e, i, isSubdirectory(), query::result, AlCaHLTBitMon_QueryRunRegistry::string, 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 1801 of file DQMStore.cc.

References data_, dirs_, isSubdirectory(), contentValuesFiles::m, contentValuesCheck::nfound, and AlCaHLTBitMon_QueryRunRegistry::string.

{
  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::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 1980 of file DQMStore.cc.

References data_, alignCSCRings::e, i, mergePath(), cmsHarvester::path, raiseDQMError(), query::result, corrVsCorr::rx, and AlCaHLTBitMon_QueryRunRegistry::string.

Referenced by 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 1703 of file DQMStore.cc.

References data_, alignCSCRings::e, i, isSubdirectory(), pwd_, query::result, and AlCaHLTBitMon_QueryRunRegistry::string.

Referenced by CalibrationScanTask::book(), CalibrationTask::book(), and dqmCopyRecursively().

{
  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 3195 of file DQMStore.cc.

References alignCSCRings::e, i, and qtests_.

Referenced by createH2CompTest(), createH2ContentTest(), createMeanValueTest(), createXRangeTest(), createYRangeTest(), QTestConfigure::EnableCheckVarianceTest(), QTestConfigure::EnableComp2RefChi2Test(), QTestConfigure::EnableComp2RefEqualHTest(), QTestConfigure::EnableComp2RefKolmogorovTest(), QTestConfigure::EnableCompareLastFilledBinTest(), QTestConfigure::EnableCompareToMedianTest(), QTestConfigure::EnableContentsWithinExpectedTest(), QTestConfigure::EnableDeadChannelTest(), QTestConfigure::EnableMeanWithinExpectedTest(), QTestConfigure::EnableNoisyChannelTest(), QTestConfigure::EnableXRangeTest(), QTestConfigure::EnableYRangeTest(), and useQTestByMatch().

{
  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 3301 of file DQMStore.cc.

References clean, cleanTrailingSlashes(), data_, dqm::qstatus::ERROR, isSubdirectory(), dqm::qstatus::OTHER, ntuplemaker::status, dqm::qstatus::STATUS_OK, AlCaHLTBitMon_QueryRunRegistry::string, 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 1680 of file DQMStore.cc.

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

Referenced by SiStripSummaryCreator::createSummary(), dqmCopyRecursively(), TauDQMFileLoader::endRun(), SiStripSummaryCreator::fillGrandSummaryHistos(), SiStripQualityChecker::fillSubDetStatus(), SiStripSummaryCreator::fillSummaryHistos(), SiStripUtility::getModuleFolderList(), SiStripSummaryCreator::getSummaryME(), SiStripUtility::goToDir(), SiStripInformationExtractor::printAlarmList(), SiStripInformationExtractor::printNonGeomHistoList(), SiStripInformationExtractor::printSummaryHistoList(), and SiStripTrackerMapCreator::setTkMapFromHistogram().

{
  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 699 of file DQMStore.cc.

References pwd_, and setCurrentFolder().

Referenced by SiStripSummaryCreator::createSummary(), SiStripSummaryCreator::fillGrandSummaryHistos(), SiStripSummaryCreator::fillSummaryHistos(), SiStripUtility::getModuleFolderList(), SiStripSummaryCreator::getSummaryME(), SiStripUtility::goToDir(), SiStripInformationExtractor::printAlarmList(), SiStripInformationExtractor::printNonGeomHistoList(), and SiStripInformationExtractor::printSummaryHistoList().

{
  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().

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

private

Definition at line 536 of file DQMStore.cc.

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

Referenced by DQMStore().

                                                    {
  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";

  enableMultiThread_ = pset.getUntrackedParameter<bool>("enableMultiThread", false);
  if (enableMultiThread_)
    std::cout << "DQMStore: MultiThread option is enabled\n";

  LSbasedMode_ = pset.getUntrackedParameter<bool>("LSbasedMode", false);
   if (LSbasedMode_)
     std::cout << "DQMStore: LSbasedMode option 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_);
  initQCriterion<CompareLastFilledBin>(qalgos_);
  initQCriterion<CheckVariance>(qalgos_);

  scaleFlag_ = pset.getUntrackedParameter<double>("ScalingFlag", 0.0);
  if (verbose_ > 0)
    std::cout << "DQMStore: Scaling Flag set to " << scaleFlag_ << std::endl;
}

bool DQMStore::isCollate

(

void

)

const

Definition at line 3379 of file DQMStore.cc.

References collateHistograms_.

{
  return collateHistograms_;
}

bool DQMStore::isCollateME ( MonitorElement *  me ) const

private

Definition at line 3388 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 2936 of file DQMStore.cc.

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

Referenced by DQMFileReader::beginJob().

{
  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";
  }

  if (!s_rxpbfile.match(filename, 0, 0))
    return readFile(filename, overwrite, "", "", stripdirs, fileMustExist);
  else
    return readFilePB(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 712 of file DQMStore.cc.

References dirs_, findObject(), mergeVDriftHistosByStation::name, raiseDQMError(), pickleFileParser::slash, and AlCaHLTBitMon_QueryRunRegistry::string.

Referenced by initializeFrom(), 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();
  }
}

void DQMStore::markForDeletion ( uint32_t  run, uint32_t  lumi  )

private

Mark a set of histograms for deletion based on run, lumi and path

Definition at line 2061 of file DQMStore.cc.

References gather_cfg::cout, data_, alignCSCRings::e, enableMultiThread_, i, MonitorElement::setLumi(), AlCaHLTBitMon_QueryRunRegistry::string, and verbose_.

{

  std::string null_str("");
  MonitorElement proto(&null_str, null_str, run, 0, 0);
  if (enableMultiThread_)
    proto.setLumi(lumi);

  std::set<MonitorElement>::const_iterator e = data_.end();
  std::set<MonitorElement>::const_iterator i = data_.lower_bound(proto);
  
  while (i != e) {
    if (i->data_.streamId != 0 ||
    i->data_.moduleId != 0)
      break;
    if ((i->data_.lumi != lumi) && enableMultiThread_)
      break;
    if (i->data_.run != run)
      break;
    
    const_cast<MonitorElement*>(&*i)->markToDelete();  
    
    if (verbose_ > 1)
      std::cout << "DQMStore::markForDeletion: marked monitor element '"
        << *i->data_.dirname << "/" << i->data_.objname << "'"
        << "flags " << i->data_.flags << "\n";

    ++i;
  }
}

template<typename iFunc >

void DQMStore::meBookerGetter ( iFunc  f )

inline

Definition at line 271 of file DQMStore.h.

References f, ibooker_, and igetter_.

Referenced by DQMEDHarvester::endJob(), and DQMEDHarvester::endLuminosityBlock().

                               {
    f(*ibooker_, *igetter_);
  }

template<typename iFunc >

void DQMStore::meGetter ( iFunc  f )

inline

Definition at line 280 of file DQMStore.h.

References f, and igetter_.

                         {
    f(*igetter_);
  }

void DQMStore::mergeAndResetMEsLuminositySummaryCache	(	uint32_t	run,
		uint32_t	lumi,
		uint32_t	streamId,
		uint32_t	moduleId
	)

Definition at line 398 of file DQMStore.cc.

References assert(), book_mutex_, gather_cfg::cout, data_, MonitorElement::DQM_KIND_TH1F, alignCSCRings::e, MonitorElement::globalize(), i, LSbasedMode_, HcalObjRepresent::Reset(), MonitorElement::setLumi(), AlCaHLTBitMon_QueryRunRegistry::string, groupFilesInBlocks::temp, and verbose_.

Referenced by DQMEDAnalyzer::endLuminosityBlockSummary(), and FastTimerService::postStreamEndLumi().

                                                 {
  if (verbose_ > 1)
    std::cout << "DQMStore::mergeAndResetMEsLuminositySummaryCache - Merging objects from run: "
              << run <<     " lumi: " << lumi
              << ", stream: " << streamId
              << " module: " << moduleId << std::endl;
  std::string null_str("");
  MonitorElement proto(&null_str, null_str, run, streamId, moduleId);
  std::set<MonitorElement>::const_iterator e = data_.end();
  std::set<MonitorElement>::const_iterator i = data_.lower_bound(proto);

  while (i != e) {
    if (i->data_.run != run
        || i->data_.streamId != streamId
        || i->data_.moduleId != moduleId)
      break;

    // Handle LS-based histograms only.
    if (not (i->getLumiFlag() || LSbasedMode_)) {
      ++i;
      continue;
    }

    MonitorElement global_me(*i);
    global_me.globalize();
    global_me.setLumi(lumi);
    // Since this accesses the data, the operation must be
    // be locked.
    std::lock_guard<std::mutex> guard(book_mutex_);
    std::set<MonitorElement>::const_iterator me = data_.find(global_me);
    if (me != data_.end()) {
      if (verbose_ > 1)
          std::cout << "Found global Object, using it --> " << me->getFullname() << std::endl;

      //don't take any action if the ME is an INT || FLOAT || STRING
      if (me->kind() >= MonitorElement::DQM_KIND_TH1F)
        me->getTH1()->Add(i->getTH1());
    } else {
      if (verbose_ > 1)
        std::cout << "No global Object found. " << std::endl;
      std::pair<std::set<MonitorElement>::const_iterator, bool> gme;
      gme = data_.insert(global_me);
      assert(gme.second);
    }
    // make the ME reusable for the next LS
    const_cast<MonitorElement*>(&*i)->Reset();
    ++i;
    
    // check and remove the global lumi based histo belonging to the previous LSs
    // if properly flagged as DQMNet::DQM_PROP_MARKTODELETE
    global_me.setLumi(1);
    std::set<MonitorElement>::const_iterator i_lumi = data_.lower_bound(global_me);
    while (i_lumi->data_.lumi != lumi) {
      auto temp = i_lumi++;
      if (i_lumi->getFullname() == i->getFullname() &&  i_lumi->markedToDelete())
    {
      data_.erase(temp);
    }
    }
  }
}

void DQMStore::mergeAndResetMEsRunSummaryCache	(	uint32_t	run,
		uint32_t	streamId,
		uint32_t	moduleId
	)

Function to transfer the local copies of histograms from each stream into the global ROOT Object. Since this involves de-facto a booking action in the case in which the global object is not yet there, the function requires the acquisition of the central lock into the DQMStore. In case we book the global object for the first time, no Add action is needed since the ROOT histograms is cloned starting from the local one.

Definition at line 343 of file DQMStore.cc.

References assert(), book_mutex_, gather_cfg::cout, data_, MonitorElement::DQM_KIND_TH1F, alignCSCRings::e, MonitorElement::globalize(), i, LSbasedMode_, AlCaHLTBitMon_QueryRunRegistry::string, and verbose_.

Referenced by DQMEDAnalyzer::endRunSummary(), and FastTimerService::postStreamEndRun().

                                                                  {
  if (verbose_ > 1)
    std::cout << "DQMStore::mergeAndResetMEsRunSummaryCache - Merging objects from run: "
              << run
              << ", stream: " << streamId
              << " module: " << moduleId << std::endl;

  if (LSbasedMode_) {
    return;
  }

  std::string null_str("");
  MonitorElement proto(&null_str, null_str, run, streamId, moduleId);
  std::set<MonitorElement>::const_iterator e = data_.end();
  std::set<MonitorElement>::const_iterator i = data_.lower_bound(proto);
  while (i != e) {
    if (i->data_.run != run
        || i->data_.streamId != streamId
        || i->data_.moduleId != moduleId)
      break;

    // Handle Run-based histograms only.
    if (i->getLumiFlag() || LSbasedMode_) {
      ++i;
      continue;
    }

    MonitorElement global_me(*i);
    global_me.globalize();
    // Since this accesses the data, the operation must be
    // be locked.
    std::lock_guard<std::mutex> guard(book_mutex_);
    std::set<MonitorElement>::const_iterator me = data_.find(global_me);
    if (me != data_.end()) {
      if (verbose_ > 1)
          std::cout << "Found global Object, using it --> " << me->getFullname() << std::endl;

      //don't take any action if the ME is an INT || FLOAT || STRING
      if(me->kind() >= MonitorElement::DQM_KIND_TH1F)
        me->getTH1()->Add(i->getTH1());

    } else {
      if (verbose_ > 1)
        std::cout << "No global Object found. " << std::endl;
      std::pair<std::set<MonitorElement>::const_iterator, bool> gme;
      gme = data_.insert(global_me);
      assert(gme.second);
    }
    // TODO(rovere): eventually reset the local object and mark it as reusable??
    ++i;
  }
}

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 2921 of file DQMStore.cc.

References readFile().

Referenced by SiStripCalibLorentzAngle::algoBeginJob(), DQMFileReader::beginJob(), edmtest::DQMReferenceHistogramRootFileEventSetupAnalyzer::beginRun(), EcalCondDBWriter::EcalCondDBWriter(), TauDQMFileLoader::endRun(), Vispa.Plugins.ConfigEditor.ConfigEditorTabController.ConfigEditorTabController::importConfig(), ZDCMonitorClient::initialize(), PFDQMEventSelector::openInputFile(), SiStripOfflineDQM::openInputFile(), DQMHistoryServiceBase::openRequestedFile(), BuildTrackerMapPlugin::read(), readFilePB(), savePB(), and StatisticsFilter::StatisticsFilter().

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

const DQMStore& DQMStore::operator= ( const DQMStore &  )

private

void DQMStore::print_trace ( const std::string &  dir, const std::string &  name  )

private

Definition at line 596 of file DQMStore.cc.

References i, contentValuesFiles::m, alignCSCRings::r, s_rxtrace(), findQualityFiles::size, stream_, and verbose_.

Referenced by book().

{
  // the access to the member stream_ is implicitely protected against
  // concurrency problems because the print_trace method is always called behind
  // a lock (see bookTransaction).
  if (!stream_)
    stream_ = new std::ofstream("histogramBookingBT.log");
  
  void *array[10];
  size_t size;
  char **strings;
  int r=0;
  lat::RegexpMatch m;
  m.reset();

  size = backtrace (array, 10);
  strings = backtrace_symbols (array, size);

  if ((size > 4)
      &&s_rxtrace.match(strings[4], 0, 0, &m))
  {
    char * demangled = abi::__cxa_demangle(m.matchString(strings[4], 2).c_str(), 0, 0, &r);
    *stream_ << "\"" << dir << "/"
           << name << "\" "
           << (r ? m.matchString(strings[4], 2) : demangled) << " "
           << m.matchString(strings[4], 1) << "\n";
    free(demangled);
  }
  else
    *stream_ << "Skipping "<< dir << "/" << name
           << " with stack size " << size << "\n";
  /* In this case print the full stack trace, up to main or to the
   * maximum stack size, i.e. 10. */
  if (verbose_ > 4)
  {
    size_t i;
    m.reset();

    for (i = 0; i < size; i++)
      if (s_rxtrace.match(strings[i], 0, 0, &m))
      {
        char * demangled = abi::__cxa_demangle(m.matchString(strings[i], 2).c_str(), 0, 0, &r);
        *stream_ << "\t\t" << i << "/" << size << " "
               << (r ? m.matchString(strings[i], 2) : demangled) << " "
               << m.matchString(strings[i], 1) << std::endl;
        free (demangled);
      }
  }
  free (strings);
}

const std::string & DQMStore::pwd

(

void

)

const

return pathname of current directory

Definition at line 660 of file DQMStore.cc.

References pwd_.

Referenced by SiStripDcsInfo::addBadModules(), CalibrationScanTask::book(), FineDelayTask::book(), LatencyTask::book(), CalibrationTask::book(), SiStripTrackerMapCreator::createForOffline(), SiStripSummaryCreator::createSummary(), SiStripQualityChecker::fillDetectorStatus(), SiStripQualityChecker::fillDetectorStatusAtLumi(), SiStripQualityChecker::fillFaultyModuleStatus(), SiStripSummaryCreator::fillGrandSummaryHistos(), SiStripCertificationInfo::fillSiStripCertificationMEs(), SiStripSummaryCreator::fillSummaryHistos(), SiStripDaqInfo::findExcludedModule(), SiStripUtility::getModuleFolderList(), SiStripQualityChecker::getModuleStatus(), SiStripSummaryCreator::getSummaryME(), SiStripUtility::getTopFolderPath(), SiStripUtility::goToDir(), SiStripInformationExtractor::printAlarmList(), SiStripActionExecutor::printFaultyModuleList(), SiStripInformationExtractor::printNonGeomHistoList(), SiStripInformationExtractor::printSummaryHistoList(), SiStripTrackerMapCreator::setTkMapFromHistogram(), and SubTaskSummaryStatus::WriteThreshold().

{ 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 2766 of file DQMStore.cc.

References collateHistograms_, prof2calltree::count, gather_cfg::cout, extract(), isSubdirectory(), relval_steps::key, makeDirectory(), GetRecoTauVFromDQM_MC_cff::next, getGTfromDQMFile::obj, raiseDQMError(), s_collateDirName, s_monitorDirName, s_referenceDirName, runGlobalFakeInputProducer::skip, pickleFileParser::slash, AlCaHLTBitMon_QueryRunRegistry::string, 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, collateHistograms_))
        ++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, collateHistograms_))
      ++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 2963 of file DQMStore.cc.

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

Referenced by initializeFrom(), load(), Vispa.Plugins.EventBrowser.EventBrowserTabController.EventBrowserTabController::navigate(), Vispa.Main.TabController.TabController::open(), open(), and Vispa.Main.TabController.TabController::refresh().

{

  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;
}

bool DQMStore::readFilePB ( const std::string &  filename, bool  overwrite = false, const std::string &  path = "", const std::string &  prepend = "", OpenRunDirs  stripdirs = StripRunDirs, bool  fileMustExist = true  )

private

Definition at line 3047 of file DQMStore.cc.

References cd(), gather_cfg::cout, MonitorElement::data_, DQMNet::DQM_PROP_LUMI, extract(), groupFilesInBlocks::fin, findObject(), DQMNet::CoreObject::flags, dqmstorepb::ROOTFilePB_Histo::flags(), get_info(), h, dqmstorepb::ROOTFilePB::histo(), dqmstorepb::ROOTFilePB::histo_size(), i, input, NULL, getGTfromDQMFile::obj, open(), cmsHarvester::path, raiseDQMError(), setCurrentFolder(), AlCaHLTBitMon_QueryRunRegistry::string, and verbose_.

Referenced by load().

{
  using google::protobuf::io::FileInputStream;
  using google::protobuf::io::FileOutputStream;
  using google::protobuf::io::GzipInputStream;
  using google::protobuf::io::GzipOutputStream;
  using google::protobuf::io::CodedInputStream;
  using google::protobuf::io::ArrayInputStream;

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

  int filedescriptor;
  if ((filedescriptor = ::open(filename.c_str(), O_RDONLY)) == -1) {
    if (fileMustExist)
      raiseDQMError("DQMStore", "Failed to open file '%s'", filename.c_str());
    else
      if (verbose_)
        std::cout << "DQMStore::readFile: file '" << filename << "' does not exist, continuing\n";
    return false;
  }

  dqmstorepb::ROOTFilePB dqmstore_message;
  FileInputStream fin(filedescriptor);
  GzipInputStream input(&fin);
  CodedInputStream input_coded(&input);
  input_coded.SetTotalBytesLimit(1024*1024*1024, -1);
  if (!dqmstore_message.ParseFromCodedStream(&input_coded)) {
    raiseDQMError("DQMStore", "Fatal parsing file '%s'", filename.c_str());
    return false;
  }
  ::close(filedescriptor);

  for (int i = 0; i < dqmstore_message.histo_size(); i++) {
    std::string path;
    std::string objname;

    TObject *obj = NULL;
    const dqmstorepb::ROOTFilePB::Histo &h = dqmstore_message.histo(i);
    get_info(h, path, objname, &obj);

    setCurrentFolder(path);
    if (obj)
    {
      /* Before calling the extract() check if histogram exists:
       * if it does - flags for the given monitor are already set (and merged)
       * else - set the flags after the histogram is created.
       */
      MonitorElement *me = findObject(path, objname);

      /* Run histograms should be collated and not overwritten,
       * Lumi histograms should be overwritten (and collate flag is not checked)
       */
      bool overwrite = h.flags() & DQMNet::DQM_PROP_LUMI;
      bool collate = !(h.flags() & DQMNet::DQM_PROP_LUMI);
      extract(static_cast<TObject *>(obj), path, overwrite, collate);

      if (me == nullptr) {
        me = findObject(path, objname);
        me->data_.flags = h.flags();
      }

      delete obj;
    }
  }

  cd();
  return true;
}

void DQMStore::removeContents

(

void

)

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

Definition at line 3162 of file DQMStore.cc.

References pwd_.

Referenced by ZDCMonitorClient::removeAllME().

{
  removeContents(pwd_);
}

void DQMStore::removeContents

(

const std::string &

dir

)

remove all monitoring elements from directory;

Definition at line 3148 of file DQMStore.cc.

References data_, alignCSCRings::e, i, isSubdirectory(), and AlCaHLTBitMon_QueryRunRegistry::string.

{
  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 3170 of file DQMStore.cc.

References pwd_.

Referenced by RPCBxTest::beginRun(), ZDCMonitorClient::beginRun(), MonitorElementsDb::endJob(), DQMDcsInfoClient::endRun(), TrackerOfflineValidationSummary::fillTree(), DQMStore::IGetter::removeElement(), and SubTaskSummaryStatus::WriteThreshold().

{
  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 3178 of file DQMStore.cc.

References gather_cfg::cout, and data_.

{
  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 2016 of file DQMStore.cc.

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

Referenced by DQMService::flushStandalone(), and initializeFrom().

{
  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 3128 of file DQMStore.cc.

References clean, cleanTrailingSlashes(), data_, dirs_, alignCSCRings::e, i, isSubdirectory(), and AlCaHLTBitMon_QueryRunRegistry::string.

Referenced by dqmCopyRecursively(), and ZDCMonitorClient::removeAllME().

{
  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 3280 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 = "",
		const uint32_t	run = 0,
		const uint32_t	lumi = 0,
		SaveReferenceTag	ref = SaveWithReference,
		int	minStatus = dqm::qstatus::STATUS_OK,
		const std::string &	fileupdate = "RECREATE",
		const bool	resetMEsAfterWriting = false
	)

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 2566 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_EFFICIENCY_PLOT, DQMNet::DQM_PROP_TAGGED, alignCSCRings::e, enableMultiThread_, f, mergeVDriftHistosByStation::file, i, isSubdirectory(), fjr2json::lumi, autoMagneticFieldProducer_cfi::master, bookConverter::max, cmsHarvester::path, raiseDQMError(), python.rootplot.root2matplotlib::replace(), HcalObjRepresent::Reset(), s_monitorDirName, s_referenceDirName, SaveWithoutReference, SaveWithReference, SaveWithReferenceForQTest, MonitorElement::setLumi(), ntuplemaker::status, AlCaHLTBitMon_QueryRunRegistry::string, and verbose_.

Referenced by Vispa.Main.TabController.TabController::allowClose(), CalibrationScanTask::checkAndSave(), CalibrationTask::checkAndSave(), Vispa.Main.TabController.TabController::checkModificationTimestamp(), TauDQMSimpleFileSaver::endJob(), TrackingTruthValid::endJob(), SiPixelDigiValid::endJob(), SiStripDigiValid::endJob(), SiStripMonitorFilter::endJob(), SiStripMonitorHLT::endJob(), MonitorLTC::endJob(), EgammaBasicClusters::endJob(), EgammaSuperClusters::endJob(), LaserDQM::endJob(), MonitorTrackResiduals::endJob(), SiStripLAProfileBooker::endJob(), SiStripMonitorDigi::endJob(), dEdxAnalyzer::endJob(), TrackerHitAnalyzer::endJob(), TrackEfficiencyMonitor::endJob(), TrackSplittingMonitor::endJob(), APVValidationPlots::endJob(), StripValidationPlots::endJob(), LogMessageMonitor::endJob(), SiStripOfflineDQM::endJob(), MuonAlignment::endJob(), ValidationHcalIsoTrackAlCaReco::endJob(), SiStripMonitorQuality::endRun(), SiStripMonitorRawData::endRun(), SiStripMonitorPedestals::endRun(), SiStripBadAPVandHotStripAlgorithmFromClusterOccupancy::extractBadAPVSandStrips(), TkHistoMap::save(), EcalDigisValidation::~EcalDigisValidation(), GlobalHitsProdHistStripper::~GlobalHitsProdHistStripper(), and SiPixelTrackingRecHitsValid::~SiPixelTrackingRecHitsValid().

{
  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) override { 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(), run, 0, 0);
    if (enableMultiThread_)
      proto.setLumi(lumi);

    mi = data_.lower_bound(proto);
    for ( ; mi != me && isSubdirectory(*di, *mi->data_.dirname); ++mi)
    {
      if (verbose_ > 1)
        std::cout << "DQMStore::save: Run: " << (*mi).run()
                  << " Lumi: " << (*mi).lumi()
                  << " LumiFlag: " << (*mi).getLumiFlag()
                  << " streamId: " << (*mi).streamId()
                  << " moduleId: " << (*mi).moduleId()
                  << " fullpathname: " << (*mi).getFullname() << std::endl;

      // Upper bound in the loop over the MEs
      if (enableMultiThread_ && ((*mi).lumi() != lumi))
        break;

      // Skip if it isn't a direct child.
      if (*di != *mi->data_.dirname) {
    if (verbose_ > 1)
      std::cout << "DQMStore::save: isn't a direct child. Skipping" << std::endl;
        continue;
      }
      
      // Keep backward compatibility with the old way of
      // booking/handlind MonitorElements into the DQMStore. If run is
      // 0 it means that a booking happened w/ the old non-threadsafe
      // style, and we have to ignore the streamId and moduleId as a
      // consequence.

      if (run != 0 && (mi->data_.streamId !=0 || mi->data_.moduleId !=0)) {
        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 efficiency tag, if any
      if (mi->data_.flags & DQMNet::DQM_PROP_EFFICIENCY_PLOT)
        TObjString(mi->effLabelString().c_str()).Write();

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

      //reset the ME just written to make it available for the next LS (online)
      if (resetMEsAfterWriting)
    const_cast<MonitorElement*>(&*mi)->Reset();
    }
  }

  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::savePB	(	const std::string &	filename,
		const std::string &	path = "",
		const uint32_t	run = 0,
		const uint32_t	lumi = 0,
		const bool	resetMEsAfterWriting = false
	)

Definition at line 2438 of file DQMStore.cc.

References dqmstorepb::ROOTFilePB::add_histo(), gather_cfg::cout, data_, deleteObject(), dirs_, MonitorElement::DQM_KIND_TH1F, enableMultiThread_, isSubdirectory(), fjr2json::lumi, open(), AlCaHLTBitMon_ParallelJobs::options, HcalObjRepresent::Reset(), dqmstorepb::ROOTFilePB_Histo::set_flags(), dqmstorepb::ROOTFilePB_Histo::set_full_pathname(), dqmstorepb::ROOTFilePB_Histo::set_size(), dqmstorepb::ROOTFilePB_Histo::set_streamed_histo(), MonitorElement::setLumi(), AlCaHLTBitMon_QueryRunRegistry::string, and verbose_.

{
  using google::protobuf::io::FileOutputStream;
  using google::protobuf::io::GzipOutputStream;
  using google::protobuf::io::StringOutputStream;

  std::set<std::string>::iterator di, de;
  MEMap::iterator mi, me = data_.end();
  dqmstorepb::ROOTFilePB dqmstore_message;
  int nme = 0;

  if (verbose_)
    std::cout << "\n DQMStore: Opening PBFile '"
              << filename << "'"<< std::endl;

  // 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))
      continue;

    // Loop over monitor elements in this directory.
    MonitorElement proto(&*di, std::string(), run, 0, 0);
    if (enableMultiThread_)
      proto.setLumi(lumi);

    mi = data_.lower_bound(proto);
    for ( ; mi != me && isSubdirectory(*di, *mi->data_.dirname); ++mi)
    {
      if (verbose_ > 1)
        std::cout << "Run: " << (*mi).run()
                  << " Lumi: " << (*mi).lumi()
                  << " LumiFlag: " << (*mi).getLumiFlag()
                  << " streamId: " << (*mi).streamId()
                  << " moduleId: " << (*mi).moduleId()
                  << " fullpathname: " << (*mi).getFullname() << std::endl;

      // Upper bound in the loop over the MEs
      if (enableMultiThread_ && ((*mi).lumi() != lumi))
    break;

      // Skip if it isn't a direct child.
      if (*di != *mi->data_.dirname)
        continue;

      // Keep backward compatibility with the old way of
      // booking/handlind MonitorElements into the DQMStore. If run is
      // 0 it means that a booking happened w/ the old non-threadsafe
      // style, and we have to ignore the streamId and moduleId as a
      // consequence.

      if (run != 0 && (mi->data_.streamId !=0 || mi->data_.moduleId !=0))
        continue;

      if (verbose_ > 1)
        std::cout << "DQMStore::savePB: saving monitor element '"
        << *mi->data_.dirname << "/" << mi->data_.objname << "'"
        << "flags " << mi->data_.flags << "\n";

      nme++;
      dqmstorepb::ROOTFilePB::Histo* me = dqmstore_message.add_histo();
      me->set_full_pathname((*mi->data_.dirname) + '/' + mi->data_.objname);
      me->set_flags(mi->data_.flags);

      TObject *toWrite = nullptr;
      bool deleteObject = false;

      if (mi->kind() < MonitorElement::DQM_KIND_TH1F) {
        toWrite = new TObjString(mi->tagString().c_str());
        deleteObject = true;
      } else {
        toWrite = mi->object_;
      }

      TBufferFile buffer(TBufferFile::kWrite);
      buffer.WriteObject(toWrite);
      me->set_size(buffer.Length());
      me->set_streamed_histo((const void*)buffer.Buffer(),
                             buffer.Length());

      if (deleteObject) {
        delete toWrite;
      }

      //reset the ME just written to make it available for the next LS (online)
      if (resetMEsAfterWriting)
    const_cast<MonitorElement*>(&*mi)->Reset();
    }
  }

  int filedescriptor = ::open(filename.c_str(),
                              O_WRONLY | O_CREAT | O_TRUNC,
                              S_IRUSR | S_IWUSR |
                              S_IRGRP | S_IWGRP |
                              S_IROTH);
  FileOutputStream file_stream(filedescriptor);
  GzipOutputStream::Options options;
  options.format = GzipOutputStream::GZIP;
  options.compression_level = 6;
  GzipOutputStream gzip_stream(&file_stream,
                               options);
  dqmstore_message.SerializeToZeroCopyStream(&gzip_stream);

  // we need to flush it before we close the fd
  gzip_stream.Close();
  file_stream.Close();
  ::close(filedescriptor);

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

void DQMStore::scaleElements

(

void

)

Invoke this method after flushing all recently changed monitoring. Clears updated flag on all MEs and calls their Reset() method.

Definition at line 3396 of file DQMStore.cc.

References gather_cfg::cout, data_, dirExists(), MonitorElement::DQM_KIND_INT, MonitorElement::DQM_KIND_REAL, MonitorElement::DQM_KIND_TH1D, MonitorElement::DQM_KIND_TH1F, MonitorElement::DQM_KIND_TH1S, MonitorElement::DQM_KIND_TH2D, MonitorElement::DQM_KIND_TH2F, MonitorElement::DQM_KIND_TH2S, MonitorElement::DQM_KIND_TH3F, MonitorElement::DQM_KIND_TPROFILE, MonitorElement::DQM_KIND_TPROFILE2D, patZpeak::events, MonitorElement::getFloatValue(), MonitorElement::getFullname(), MonitorElement::getIntValue(), MonitorElement::getTH1D(), MonitorElement::getTH1F(), MonitorElement::getTH1S(), MonitorElement::getTH2D(), MonitorElement::getTH2F(), MonitorElement::getTH2S(), MonitorElement::getTH3F(), MonitorElement::getTProfile(), MonitorElement::getTProfile2D(), MonitorElement::kind(), scaleFlag_, and verbose_.

{
  if (scaleFlag_ == 0.0) return;
  if (verbose_ > 0)
    std::cout << " =========== " << " ScaleFlag " << scaleFlag_ << std::endl;
  double factor = scaleFlag_;
  int events = 1;
  if (dirExists("Info/EventInfo")) {
    if ( scaleFlag_ == -1.0) {
      MonitorElement * scale_me = get("Info/EventInfo/ScaleFactor");
      if (scale_me && scale_me->kind()==MonitorElement::DQM_KIND_REAL) factor = scale_me->getFloatValue();
    }
    MonitorElement * event_me = get("Info/EventInfo/processedEvents");
    if (event_me && event_me->kind()==MonitorElement::DQM_KIND_INT) events = event_me->getIntValue();
  }
  factor = factor/(events*1.0);

  MEMap::iterator mi = data_.begin();
  MEMap::iterator me = data_.end();
  for ( ; mi != me; ++mi)
  {
    MonitorElement &me = const_cast<MonitorElement &>(*mi);
    switch (me.kind())
      {
      case MonitorElement::DQM_KIND_TH1F:
        {
          me.getTH1F()->Scale(factor);
          break;
        }
      case MonitorElement::DQM_KIND_TH1S:
        {
          me.getTH1S()->Scale(factor);
          break;
        }
      case MonitorElement::DQM_KIND_TH1D:
        {
          me.getTH1D()->Scale(factor);
          break;
        }
      case MonitorElement::DQM_KIND_TH2F:
        {
          me.getTH2F()->Scale(factor);
          break;
        }
      case MonitorElement::DQM_KIND_TH2S:
        {
          me.getTH2S()->Scale(factor);
          break;
        }
      case MonitorElement::DQM_KIND_TH2D:
        {
          me.getTH2D()->Scale(factor);
          break;
        }
      case MonitorElement::DQM_KIND_TH3F:
        {
          me.getTH3F()->Scale(factor);
          break;
        }
      case MonitorElement::DQM_KIND_TPROFILE:
        {
          me.getTProfile()->Scale(factor);
          break;
        }
      case MonitorElement::DQM_KIND_TPROFILE2D:
        {
          me.getTProfile2D()->Scale(factor);
          break;
        }
      default:
        if (verbose_ > 0)
          std::cout << " The DQM object '" << me.getFullname() << "' is not scalable object " << std::endl;
        continue;
      }
  }
}

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 3349 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 688 of file DQMStore.cc.

References clean, cleanTrailingSlashes(), makeDirectory(), pwd_, and AlCaHLTBitMon_QueryRunRegistry::string.

Referenced by SiStripDcsInfo::addBadModules(), DQMFileReader::beginJob(), DQMFEDIntegrityClient::beginJob(), L1ScalersClient::beginJob(), EgammaBasicClusters::beginJob(), EgammaSuperClusters::beginJob(), AcceptanceHistoProducer::beginJob(), ConverterTester::beginJob(), APVValidationPlots::beginJob(), StripValidationPlots::beginJob(), DQMDaqInfo::beginJob(), HcalDCSInfo::beginJob(), MuonAlignment::beginJob(), ValidationHcalIsoTrackAlCaReco::beginJob(), HLTScalersClient::beginJob(), MCEmbeddingValidationAnalyzer::beginJob(), RPCBxTest::beginRun(), DQMDcsInfoClient::beginRun(), ZDCMonitorClient::beginRun(), DQMProvInfo::beginRun(), MuonAlignmentSummary::beginRun(), CalibrationTask::book(), FineDelayTask::book(), LatencyTask::book(), CalibrationScanTask::book(), MEtoMEComparitor::book(), TrackerOfflineValidationSummary::bookHarvestingHists(), PixelVTXMonitor::bookHistograms(), DQMLumiMonitor::bookHistograms(), MCEmbeddingValidationAnalyzer::plotEntryTypeEvtWeight::bookHistograms(), MCEmbeddingValidationAnalyzer::plotEntryTypeMuonRadCorrUncertainty::bookHistograms(), MCEmbeddingValidationAnalyzer::plotEntryTypeL1ETM::bookHistograms(), MCEmbeddingValidationAnalyzer::leptonDistributionT< T >::bookHistograms(), MCEmbeddingValidationAnalyzer::electronDistributionExtra::bookHistograms(), MCEmbeddingValidationAnalyzer::tauDistributionExtra::bookHistograms(), MCEmbeddingValidationAnalyzer::leptonEfficiencyT< T >::bookHistograms(), MCEmbeddingValidationAnalyzer::leptonL1TriggerEfficiencyT1T2< T1, T2 >::bookHistograms(), MCEmbeddingValidationAnalyzer::l1ExtraObjectDistributionT< T >::bookHistograms(), MCEmbeddingValidationAnalyzer::metDistributionType::bookHistograms(), MCEmbeddingValidationAnalyzer::metL1TriggerEfficiencyType::bookHistograms(), SiStripCertificationInfo::bookSiStripCertificationMEs(), SiStripQualityChecker::bookStatus(), SiStripDaqInfo::bookStatus(), SiStripDcsInfo::bookStatus(), cd(), dqmCopyRecursively(), EgHLTOfflineClient::EgHLTOfflineClient(), HarvestingAnalyzer::endJob(), HLTScalersClient::endLuminosityBlock(), DQMDcsInfoClient::endRun(), TauDQMHistEffProducer::endRun(), TauDQMFileLoader::endRun(), GlobalHitsProdHistStripper::endRun(), SiStripQualityChecker::fillFaultyModuleStatus(), SiStripQualityDQM::fillGrandSummaryMEs(), TrackerOfflineValidationSummary::fillTree(), SiStripDaqInfo::findExcludedModule(), TkHistoMap::folderDefinition(), EgHLTOfflineSummaryClient::getEgHLTSumHist_(), goUp(), HEff1DHit::HEff1DHit(), HEff2DHit::HEff2DHit(), HEff4DHit::HEff4DHit(), HLTScalersClient::HLTScalersClient(), HRes1DHit::HRes1DHit(), HRes2DHit::HRes2DHit(), HRes4DHit::HRes4DHit(), SiStripBadAPVandHotStripAlgorithmFromClusterOccupancy::initializeDQMHistograms(), LaserDQM::initMonitors(), L1ScalersClient::L1ScalersClient(), DQMProvInfo::makeHLTKeyInfo(), DQMProvInfo::makeProvInfo(), MonitorElementsDb::MonitorElementsDb(), readFilePB(), EgHLTOfflineSummaryClient::runClient_(), EgHLTOfflineClient::runClient_(), SiStripFolderOrganizer::setDetectorFolder(), SiPixelFolderOrganizer::setFedFolder(), SiStripFolderOrganizer::setLayerFolder(), SiPixelFolderOrganizer::setModuleFolder(), SiStripFolderOrganizer::setSiStripControlFolder(), SiStripFolderOrganizer::setSiStripFolder(), SiStripFolderOrganizer::setSiStripTopControlFolder(), and SubTaskSummaryStatus::WriteThreshold().

{
  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 652 of file DQMStore.cc.

Referenced by EgammaBasicClusters::beginJob(), EgammaSuperClusters::beginJob(), TrackerHitAnalyzer::bookHistograms(), EgHLTOfflineClient::EgHLTOfflineClient(), GlobalHitsProdHistStripper::GlobalHitsProdHistStripper(), and HLTScalersClient::HLTScalersClient().

{ return; }

void DQMStore::showDirStructure

(

void

)

const

Definition at line 3359 of file DQMStore.cc.

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

Referenced by EgammaBasicClusters::beginJob(), EgammaSuperClusters::beginJob(), TrackerHitAnalyzer::bookHistograms(), EcalBarrelMonitorDbModule::EcalBarrelMonitorDbModule(), dEdxAnalyzer::endJob(), TrackEfficiencyMonitor::endJob(), TrackSplittingMonitor::endJob(), LogMessageMonitor::endJob(), HLTScalersClient::endLuminosityBlock(), TauDQMFileLoader::endRun(), GlobalHitsProdHistStripper::GlobalHitsProdHistStripper(), ZDCMonitorClient::initialize(), and LaserDQM::initMonitors().

{
  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 3332 of file DQMStore.cc.

References MonitorElement::softReset().

Referenced by TrackAnalyzer::doSoftReset(), resetME(), and ecaldqm::MESet::softReset().

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

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

tag ME as <myTag> (myTag > 0)

Definition at line 1615 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(), SiStripBaseCondObjDQM::bookCumulMEs(), SiStripBaseCondObjDQM::bookProfileMEs(), SiStripBaseCondObjDQM::bookSummaryCumulMEs(), SiStripBaseCondObjDQM::bookSummaryMEs(), SiStripBaseCondObjDQM::bookSummaryProfileMEs(), extract(), get(), getContents(), Inspector.Inspector::SetTag(), 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 1630 of file DQMStore.cc.

References dir, findObject(), mergeVDriftHistosByStation::name, raiseDQMError(), splitPath(), AlCaHLTBitMon_QueryRunRegistry::string, and tag().

Referenced by Inspector.Inspector::SetTag().

{
  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 1658 of file DQMStore.cc.

References clean, cleanTrailingSlashes(), data_, alignCSCRings::e, i, isSubdirectory(), AlCaHLTBitMon_QueryRunRegistry::string, 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 1646 of file DQMStore.cc.

References data_, alignCSCRings::e, i, AlCaHLTBitMon_QueryRunRegistry::string, and tag().

{
  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 3227 of file DQMStore.cc.

References clean, cleanTrailingSlashes(), raiseDQMError(), s_safe, AlCaHLTBitMon_QueryRunRegistry::string, 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 3245 of file DQMStore.cc.

References MonitorElement::addQReport(), data_, getQCriterion(), mergePath(), cmsHarvester::path, qtestspecs_, raiseDQMError(), and AlCaHLTBitMon_QueryRunRegistry::string.

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

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

  fastmatch * fm = new fastmatch( pattern );

  // Record the test for future reference.
  QTestSpec qts(fm, 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 (fm->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 DQMArchiver

friend

Definition at line 723 of file DQMStore.h.

friend class DQMFileSaver

friend

Definition at line 727 of file DQMStore.h.

friend class DQMNet

friend

Definition at line 722 of file DQMStore.h.

friend class DQMRootOutputModule

friend

Definition at line 725 of file DQMStore.h.

friend class DQMRootSource

friend

Definition at line 726 of file DQMStore.h.

friend class DQMService

friend

Definition at line 721 of file DQMStore.h.

friend class DQMStoreExample

friend

Definition at line 724 of file DQMStore.h.

friend class edm::DQMHttpSource

friend

Definition at line 720 of file DQMStore.h.

friend class MEtoEDMConverter

friend

Definition at line 728 of file DQMStore.h.

Member Data Documentation

std::mutex DQMStore::book_mutex_

private

Definition at line 716 of file DQMStore.h.

Referenced by bookTransaction(), mergeAndResetMEsLuminositySummaryCache(), and mergeAndResetMEsRunSummaryCache().

bool DQMStore::collateHistograms_

private

Definition at line 698 of file DQMStore.h.

Referenced by book(), bookFloat(), bookInt(), bookString(), extract(), initializeFrom(), isCollate(), load(), and readDirectory().

MEMap DQMStore::data_

private

Definition at line 709 of file DQMStore.h.

Referenced by book(), containsAnyMonitorable(), findObject(), DQMService::flushStandalone(), forceReset(), get(), getAllContents(), getAllTags(), getContents(), getMatchingContents(), getMEs(), getStatus(), markForDeletion(), mergeAndResetMEsLuminositySummaryCache(), mergeAndResetMEsRunSummaryCache(), readFile(), removeContents(), removeElement(), reset(), rmdir(), runQTests(), save(), savePB(), scaleElements(), tagAllContents(), tagContents(), and useQTestByMatch().

std::set<std::string> DQMStore::dirs_

private

Definition at line 710 of file DQMStore.h.

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

bool DQMStore::enableMultiThread_

private

Definition at line 699 of file DQMStore.h.

Referenced by DQMRootOutputModule::beginJob(), bookTransaction(), DQMStore(), initializeFrom(), markForDeletion(), save(), and savePB().

bool DQMStore::forceResetOnBeginLumi_

private

Definition at line 701 of file DQMStore.h.

Referenced by DQMStore(), and forceReset().

IBooker* DQMStore::ibooker_

private

Definition at line 717 of file DQMStore.h.

Referenced by bookTransaction(), DQMStore(), and meBookerGetter().

IGetter* DQMStore::igetter_

private

Definition at line 718 of file DQMStore.h.

Referenced by DQMStore(), meBookerGetter(), and meGetter().

bool DQMStore::LSbasedMode_

private

Definition at line 700 of file DQMStore.h.

Referenced by initializeFrom(), mergeAndResetMEsLuminositySummaryCache(), and mergeAndResetMEsRunSummaryCache().

uint32_t DQMStore::moduleId_

private

Definition at line 705 of file DQMStore.h.

Referenced by book(), bookFloat(), bookInt(), bookString(), and bookTransaction().

DQMStore::pwd_

private

Current directory.

Definition at line 708 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 713 of file DQMStore.h.

Referenced by createQTest(), and initializeFrom().

DQMStore::qtests_

private

All the quality tests.

Definition at line 712 of file DQMStore.h.

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

QTestSpecs DQMStore::qtestspecs_

private

Definition at line 714 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 702 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 696 of file DQMStore.h.

Referenced by forceReset(), reset(), and runQTests().

uint32_t DQMStore::run_

private

Definition at line 703 of file DQMStore.h.

Referenced by book(), bookFloat(), bookInt(), bookString(), and bookTransaction().

double DQMStore::scaleFlag_

private

Definition at line 697 of file DQMStore.h.

Referenced by initializeFrom(), and scaleElements().

std::ofstream* DQMStore::stream_

private

Definition at line 706 of file DQMStore.h.

Referenced by print_trace(), and ~DQMStore().

uint32_t DQMStore::streamId_

private

Definition at line 704 of file DQMStore.h.

Referenced by book(), bookFloat(), bookInt(), bookString(), and bookTransaction().

DQMStore::verbose_

private

Universal verbose flag for DQM.

Definition at line 694 of file DQMStore.h.

Referenced by book(), extract(), initializeFrom(), load(), markForDeletion(), mergeAndResetMEsLuminositySummaryCache(), mergeAndResetMEsRunSummaryCache(), print_trace(), readDirectory(), readFile(), readFilePB(), runQTests(), save(), savePB(), and scaleElements().

DQMStore::verboseQT_

private

Verbose flag for xml-based QTests.

Definition at line 695 of file DQMStore.h.

Referenced by createQTest(), and initializeFrom().