CommissioningHistograms Class Reference

#include <CommissioningHistograms.h>

Inheritance diagram for CommissioningHistograms:

Classes
class	Histo

Public Types
typedef std::map< uint32_t, CommissioningAnalysis * >	Analyses
typedef Analyses::iterator	Analysis
typedef dqm::harvesting::DQMStore	DQMStore
typedef SummaryPlotFactory< CommissioningAnalysis * >	Factory
typedef std::map< uint32_t, uint32_t >	FedToFecMap
typedef std::vector< Histo * >	Histos
typedef std::map< uint32_t, Histos >	HistosMap
typedef dqm::harvesting::MonitorElement	MonitorElement

Public Member Functions
	CommissioningHistograms (const edm::ParameterSet &pset, DQMStore *const, const sistrip::RunType &)
	CommissioningHistograms ()
virtual void	configure (const edm::ParameterSet &, const edm::EventSetup &)
void	createCollations (const std::vector< std::string > &)
virtual void	createSummaryHisto (const sistrip::Monitorable &, const sistrip::Presentation &, const std::string &top_level_dir, const sistrip::Granularity &)
void	extractHistograms (const std::vector< std::string > &)
virtual void	histoAnalysis (bool debug)
virtual void	printAnalyses ()
virtual void	printSummary ()
void	remove (std::string pattern="")
void	save (std::string &filename, uint32_t run_number=0, std::string partitionName="")
virtual	~CommissioningHistograms ()

Static Public Member Functions
static void	copyCustomInformation (DQMStore *const, const std::vector< std::string > &)
static uint32_t	runNumber (DQMStore *const, const std::vector< std::string > &)
static sistrip::RunType	runType (DQMStore *const, const std::vector< std::string > &)

Protected Member Functions
DQMStore *const	bei () const
void	clearHistosMap ()
Analyses &	data (bool getMaskedData=false)
Factory *const	factory ()
TH1 *	histogram (const sistrip::Monitorable &, const sistrip::Presentation &, const sistrip::View &, const std::string &directory, const uint32_t &xbins, const float &xlow=1. *sistrip::invalid_, const float &xhigh=1. *sistrip::invalid_)
const HistosMap &	histos () const
const FedToFecMap &	mapping () const
void	printHistosMap ()
const edm::ParameterSet &	pset () const
const sistrip::RunType &	task () const

Protected Attributes
std::unique_ptr< Factory >	factory_

Private Attributes
DQMStore *	bei_
std::vector< uint32_t >	ccuVector_
Analyses	data_
Analyses	dataWithMask_
bool	dataWithMaskCached_
std::vector< uint32_t >	fecMaskVector_
std::vector< uint32_t >	fedMaskVector_
HistosMap	histos_
std::vector< uint32_t >	i2cChanVector_
std::vector< uint32_t >	lldChanVector_
FedToFecMap	mapping_
bool	mask_
edm::ParameterSet	pset_
std::vector< uint32_t >	ringVector_
sistrip::RunType	task_

Detailed Description

Definition at line 23 of file CommissioningHistograms.h.

Member Typedef Documentation

Analyses

typedef std::map<uint32_t, CommissioningAnalysis*> CommissioningHistograms::Analyses

Definition at line 56 of file CommissioningHistograms.h.

Analysis

typedef Analyses::iterator CommissioningHistograms::Analysis

Definition at line 58 of file CommissioningHistograms.h.

DQMStore

typedef dqm::harvesting::DQMStore CommissioningHistograms::DQMStore

Definition at line 27 of file CommissioningHistograms.h.

Factory

typedef SummaryPlotFactory<CommissioningAnalysis*> CommissioningHistograms::Factory

Definition at line 60 of file CommissioningHistograms.h.

FedToFecMap

typedef std::map<uint32_t, uint32_t> CommissioningHistograms::FedToFecMap

Definition at line 66 of file CommissioningHistograms.h.

Histos

typedef std::vector<Histo*> CommissioningHistograms::Histos

Definition at line 62 of file CommissioningHistograms.h.

HistosMap

typedef std::map<uint32_t, Histos> CommissioningHistograms::HistosMap

Definition at line 64 of file CommissioningHistograms.h.

MonitorElement

typedef dqm::harvesting::MonitorElement CommissioningHistograms::MonitorElement

Definition at line 26 of file CommissioningHistograms.h.

Constructor & Destructor Documentation

CommissioningHistograms() [1/2]

CommissioningHistograms::CommissioningHistograms	(	const edm::ParameterSet &	pset,
		DQMStore * const	bei,
		const sistrip::RunType &	task
	)

Definition at line 16 of file CommissioningHistograms.cc.

References bei_, clearHistosMap(), LogTrace, and sistrip::mlDqmClient_.

    : factory_(nullptr),
      task_(task),
      bei_(bei),
      data_(),
      histos_(),
      pset_(pset),
      mask_(pset.existsAs<bool>("vetoModules") ? pset.getParameter<bool>("vetoModules") : true),
      fedMaskVector_(pset.existsAs<std::vector<uint32_t> >("fedMaskVector")
                         ? pset.getParameter<std::vector<uint32_t> >("fedMaskVector")
                         : std::vector<uint32_t>()),
      fecMaskVector_(pset.existsAs<std::vector<uint32_t> >("fecMaskVector")
                         ? pset.getParameter<std::vector<uint32_t> >("fecMaskVector")
                         : std::vector<uint32_t>()),
      ringVector_(pset.existsAs<std::vector<uint32_t> >("ringVector")
                      ? pset.getParameter<std::vector<uint32_t> >("ringVector")
                      : std::vector<uint32_t>()),
      ccuVector_(pset.existsAs<std::vector<uint32_t> >("ccuVector")
                     ? pset.getParameter<std::vector<uint32_t> >("ccuVector")
                     : std::vector<uint32_t>()),
      i2cChanVector_(pset.existsAs<std::vector<uint32_t> >("i2cChanVector")
                         ? pset.getParameter<std::vector<uint32_t> >("i2cChanVector")
                         : std::vector<uint32_t>()),
      lldChanVector_(pset.existsAs<std::vector<uint32_t> >("lldChanVector")
                         ? pset.getParameter<std::vector<uint32_t> >("lldChanVector")
                         : std::vector<uint32_t>()),
      dataWithMask_(),
      dataWithMaskCached_(false) {
  LogTrace(mlDqmClient_) << "[" << __PRETTY_FUNCTION__ << "]"
                         << " Constructing object...";

  // DQMStore
  if (!bei_) {
    edm::LogError(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                << " NULL pointer to DQMStore!";
  }

  clearHistosMap();
}

CommissioningHistograms() [2/2]

CommissioningHistograms::CommissioningHistograms

(

)

Definition at line 60 of file CommissioningHistograms.cc.

References LogTrace, and sistrip::mlDqmClient_.

    : factory_(nullptr),
      task_(sistrip::UNDEFINED_RUN_TYPE),
      bei_(nullptr),
      data_(),
      histos_(),
      mask_(true),
      dataWithMask_(),
      dataWithMaskCached_(false) {
  LogTrace(mlDqmClient_) << "[" << __PRETTY_FUNCTION__ << "]"
                         << " Constructing object...";
}

~CommissioningHistograms()

CommissioningHistograms::~CommissioningHistograms ( )

virtual

Definition at line 75 of file CommissioningHistograms.cc.

References clearHistosMap(), LogTrace, and sistrip::mlDqmClient_.

                                                  {
  LogTrace(mlDqmClient_) << "[" << __PRETTY_FUNCTION__ << "]"
                         << " Destructing object...";
  clearHistosMap();
  //@@ do not delete BEI ptrs!
}

Member Function Documentation

bei()

CommissioningHistograms::DQMStore *const CommissioningHistograms::bei ( ) const

inlineprotected

Definition at line 159 of file CommissioningHistograms.h.

References bei_.

Referenced by copyCustomInformation(), runNumber(), runType(), SamplingHistograms::SamplingHistograms(), and CalibrationHistograms::save().

{ return bei_; }

clearHistosMap()

void CommissioningHistograms::clearHistosMap ( )

protected

Definition at line 541 of file CommissioningHistograms.cc.

References histos_, LogTrace, and sistrip::mlDqmClient_.

Referenced by CommissioningHistograms(), and ~CommissioningHistograms().

                                             {
  LogTrace(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                         << " Clearing histogram map...";
  HistosMap::iterator ihistos = histos_.begin();
  for (; ihistos != histos_.end(); ihistos++) {
    Histos::iterator ihisto = ihistos->second.begin();
    for (; ihisto != ihistos->second.end(); ihisto++) {
      if (*ihisto) {
        delete *ihisto;
      }
    }
    ihistos->second.clear();
  }
  histos_.clear();
}

configure()

virtual void CommissioningHistograms::configure ( const edm::ParameterSet &  , const edm::EventSetup &    )

inlinevirtual

Reimplemented in CommissioningHistosUsingDb, FineDelayHistosUsingDb, LatencyHistosUsingDb, and SamplingHistograms.

Definition at line 37 of file CommissioningHistograms.h.

Referenced by SiStripCommissioningOfflineDbClient::createHistos(), and SiStripCommissioningOfflineClient::createHistos().

{}

copyCustomInformation()

void CommissioningHistograms::copyCustomInformation ( DQMStore * const  bei, const std::vector< std::string > &  contents  )

static

Extracts custom information from list of MonitorElements.

Definition at line 234 of file CommissioningHistograms.cc.

References bei(), dqm::implementation::IBooker::bookInt(), relmon_rootfiles_spy::contents, sistrip::dir_, HcalObjRepresent::Fill(), dqm::implementation::IGetter::get(), dqm::implementation::IGetter::getContents(), MonitorElementData::INT, sistrip::mlDqmClient_, castor_dqm_sourceclient_file_cfg::path, dqm::implementation::DQMStore::setCurrentFolder(), pickleFileParser::slash, AlCaHLTBitMon_QueryRunRegistry::string, and runGCPTkAlMap::title.

Referenced by SiStripCommissioningOfflineClient::beginRun().

                                                                                                             {
  // Check if histograms present
  if (contents.empty()) {
    edm::LogWarning(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                  << " Found no histograms!";
    return;
  }

  // Iterate through added contents
  std::vector<std::string>::const_iterator istr = contents.begin();
  while (istr != contents.end()) {
    // Extract source directory path
    std::string source_dir = istr->substr(0, istr->find(":"));

    // Generate corresponding client path (removing trailing "/")
    SiStripFecKey path(source_dir);
    std::string client_dir = path.path();
    std::string slash = client_dir.substr(client_dir.size() - 1, 1);
    if (slash == sistrip::dir_) {
      client_dir = client_dir.substr(0, client_dir.size() - 1);
    }

    // Iterate though MonitorElements from source directory
    std::vector<MonitorElement*> me_list = bei->getContents(source_dir);
    std::vector<MonitorElement*>::iterator ime = me_list.begin();
    for (; ime != me_list.end(); ime++) {
      if (!(*ime)) {
        edm::LogWarning(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                      << " NULL pointer to MonitorElement!";
        continue;
      }
      // Search for calchan, isha or vfs
      if ((*ime)->kind() == MonitorElement::Kind::INT) {
        std::string title = (*ime)->getName();
        std::string::size_type pos = title.find("calchan");
        if (pos == std::string::npos)
          pos = title.find("isha");
        if (pos == std::string::npos)
          pos = title.find("vfs");
        if (pos != std::string::npos) {
          int value = (*ime)->getIntValue();
          if (value >= 0) {
            edm::LogVerbatim(mlDqmClient_)
                << "[CommissioningHistograms::" << __func__ << "]"
                << " Found \"" << title.substr(pos, std::string::npos) << "\" with value \"" << value << "\"";
            if (!(bei->get(client_dir + "/" + title.substr(pos, std::string::npos)))) {
              bei->setCurrentFolder(client_dir);
              bei->bookInt(title.substr(pos, std::string::npos))->Fill(value);
              edm::LogVerbatim(mlDqmClient_)
                  << "[CommissioningHistograms::" << __func__ << "]"
                  << " Booked \"" << title.substr(pos, std::string::npos) << "\" in directory \"" << client_dir << "\"";
            }
          }
        }
      }
    }
    istr++;
  }
}

createCollations()

void CommissioningHistograms::createCollations

(

const std::vector< std::string > &

)

createSummaryHisto()

void CommissioningHistograms::createSummaryHisto ( const sistrip::Monitorable &  mon, const sistrip::Presentation &  pres, const std::string &  top_level_dir, const sistrip::Granularity &  gran  )

virtual

Reimplemented in FedCablingHistograms, and FedTimingHistograms.

Definition at line 559 of file CommissioningHistograms.cc.

References data(), DeadROC_duringRun::dir, relativeConstraints::empty, factory(), sistrip::FED_ADC_RANGE, SummaryPlotFactory< T >::fill(), sistrip::HISTO_1D, histoAnalysis(), histogram(), SummaryPlotFactory< T >::init(), LogTrace, sistrip::mlDqmClient_, LaserDQM_cfi::mon, edmLumisInFiles::summary, sistrip::UNKNOWN_VIEW, SiStripEnumsAndStrings::view(), and fw3dlego::xbins.

Referenced by SiStripCommissioningOfflineClient::beginRun().

                                                                                 {
  LogTrace(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]";

  // Check view
  sistrip::View view = SiStripEnumsAndStrings::view(dir);
  if (view == sistrip::UNKNOWN_VIEW) {
    return;
  }

  // Analyze histograms
  if (data().empty()) {
    histoAnalysis(false);
  }

  // Check
  if (data().empty()) {
    edm::LogError(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                << " No analyses generated!";
    return;
  }

  // Extract data to be histogrammed
  uint32_t xbins = factory()->init(mon, pres, view, dir, gran, data());

  // Only create histograms if entries are found!
  if (!xbins) {
    return;
  }

  // Create summary histogram (if it doesn't already exist)
  TH1* summary = nullptr;
  if (pres != sistrip::HISTO_1D) {
    summary = histogram(mon, pres, view, dir, xbins);
  } else {
    summary = histogram(mon, pres, view, dir, sistrip::FED_ADC_RANGE, 0., sistrip::FED_ADC_RANGE * 1.);
  }

  // Fill histogram with data
  factory()->fill(*summary);
}

data()

CommissioningHistograms::Analyses & CommissioningHistograms::data ( bool  getMaskedData = false )

protected

Definition at line 718 of file CommissioningHistograms.cc.

References conversion_template_cfg::anal, SiStripFecKey::ccuAddr(), SiStripFecKey::ccuChan(), ccuVector_, data_, dataWithMask_, dataWithMaskCached_, fecMaskVector_, SiStripFecKey::fecRing(), SiStripFecKey::fecSlot(), SiStripFedKey::fedId(), fedMaskVector_, mps_fire::i, i2cChanVector_, SiStripFecKey::lldChan(), lldChanVector_, mask_, and ringVector_.

Referenced by FastFedCablingHistosUsingDb::addDcuDetIds(), CommissioningHistosUsingDb::addDcuDetIds(), FineDelayHistosUsingDb::computeDelays(), FastFedCablingHistosUsingDb::connections(), CommissioningHistosUsingDb::createAnalyses(), createSummaryHisto(), DaqScopeModeHistograms::histoAnalysis(), PedestalsHistograms::histoAnalysis(), CalibrationHistograms::histoAnalysis(), PedsFullNoiseHistograms::histoAnalysis(), FastFedCablingHistograms::histoAnalysis(), PedsOnlyHistograms::histoAnalysis(), NoiseHistograms::histoAnalysis(), VpspScanHistograms::histoAnalysis(), ApvTimingHistograms::histoAnalysis(), OptoScanHistograms::histoAnalysis(), SamplingHistograms::histoAnalysis(), OptoScanHistograms::printAnalyses(), PedestalsHistograms::printAnalyses(), FastFedCablingHistograms::printAnalyses(), DaqScopeModeHistograms::printAnalyses(), PedsFullNoiseHistograms::printAnalyses(), PedsOnlyHistograms::printAnalyses(), VpspScanHistograms::printAnalyses(), NoiseHistograms::printAnalyses(), CalibrationHistograms::printAnalyses(), printAnalyses(), FastFedCablingHistograms::printSummary(), printSummary(), CalibrationHistograms::save(), DaqScopeModeHistosUsingDb::update(), PedsOnlyHistosUsingDb::update(), PedsFullNoiseHistosUsingDb::update(), OptoScanHistosUsingDb::update(), VpspScanHistosUsingDb::update(), PedestalsHistosUsingDb::update(), ApvTimingHistosUsingDb::update(), NoiseHistosUsingDb::update(), FastFedCablingHistosUsingDb::update(), LatencyHistosUsingDb::update(), and CalibrationHistosUsingDb::update().

                                                                                 {
  if (!getMaskedData)
    return data_;
  else {
    if (dataWithMaskCached_)
      return dataWithMask_;
    else {
      Analyses::iterator ianal = data_.begin();
      Analyses::iterator janal = data_.end();
      for (; ianal != janal; ++ianal) {
        CommissioningAnalysis* anal = ianal->second;
        SiStripFedKey fedkey = anal->fedKey();
        SiStripFecKey feckey = anal->fecKey();
        bool maskThisAnal_ = false;
        for (std::size_t i = 0; i < fedMaskVector_.size(); i++) {
          if (fedkey.fedId() == fedMaskVector_[i])
            maskThisAnal_ = true;
        }
        for (std::size_t i = 0; i < fecMaskVector_.size(); i++) {
          if (fecMaskVector_.size() != ringVector_.size() || fecMaskVector_.size() != ccuVector_.size() ||
              fecMaskVector_.size() != i2cChanVector_.size() || fecMaskVector_.size() != lldChanVector_.size()) {
            continue;
          }
          if (feckey.fecSlot() == fecMaskVector_[i] && feckey.fecRing() == ringVector_[i] &&
              feckey.ccuAddr() == ccuVector_[i] && feckey.ccuChan() == i2cChanVector_[i] &&
              feckey.lldChan() == lldChanVector_[i]) {
            maskThisAnal_ = true;
          }
        }
        if (mask_ && !maskThisAnal_)
          dataWithMask_[ianal->first] = ianal->second;
        else if (!mask_ && maskThisAnal_)
          dataWithMask_[ianal->first] = ianal->second;
      }
      dataWithMaskCached_ = true;
      return dataWithMask_;
    }
  }
}

extractHistograms()

void CommissioningHistograms::extractHistograms

(

const std::vector< std::string > &

contents

)

Definition at line 297 of file CommissioningHistograms.cc.

References sistrip::APV, bei_, sistrip::collate_, relmon_rootfiles_spy::contents, sistrip::CONTROL_VIEW, sistrip::DETECTOR_VIEW, sistrip::dir_, dqm::implementation::IGetter::get(), dqm::implementation::IGetter::getContents(), timingPdfMaker::histo, histos_, sistrip::invalid32_, sistrip::invalid_, crabWrapper::key, SiStripKey::key(), SiStripFecKey::lldChan(), LogTrace, mapping_, sistrip::mlDqmClient_, castor_dqm_sourceclient_file_cfg::path, sistrip::READOUT_VIEW, edm::second(), pickleFileParser::slash, contentValuesCheck::ss, AlCaHLTBitMon_QueryRunRegistry::string, groupFilesInBlocks::temp, runGCPTkAlMap::title, sistrip::UNDEFINED_GRAN, sistrip::undefinedView_, sistrip::UNKNOWN_GRAN, and SiStripEnumsAndStrings::view().

Referenced by SiStripCommissioningOfflineClient::beginRun().

                                                                                    {
  LogTrace(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                         << " Extracting available histograms...";

  // Check pointer
  if (!bei_) {
    edm::LogError(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                << " NULL pointer to DQMStore!";
    return;
  }

  // Check list of histograms
  if (contents.empty()) {
    edm::LogError(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                << " Empty contents vector!";
    return;
  }

  // Iterate through list of histograms
  std::vector<std::string>::const_iterator idir;
  for (idir = contents.begin(); idir != contents.end(); idir++) {
    // Ignore "DQM source" directories if looking in client file
    if (idir->find(sistrip::collate_) == std::string::npos) {
      continue;
    }

    // Extract source directory path
    std::string source_dir = idir->substr(0, idir->find(":"));

    // Extract view and create key
    sistrip::View view = SiStripEnumsAndStrings::view(source_dir);
    SiStripKey path;
    if (view == sistrip::CONTROL_VIEW) {
      path = SiStripFecKey(source_dir);
    } else if (view == sistrip::READOUT_VIEW) {
      path = SiStripFedKey(source_dir);
    } else if (view == sistrip::DETECTOR_VIEW) {
      path = SiStripDetKey(source_dir);
    } else {
      path = SiStripKey();
    }

    // Check path is valid
    if (path.granularity() == sistrip::UNKNOWN_GRAN || path.granularity() == sistrip::UNDEFINED_GRAN) {
      continue;
    }

    // Generate corresponding client path (removing trailing "/")
    std::string client_dir(sistrip::undefinedView_);
    if (view == sistrip::CONTROL_VIEW) {
      client_dir = SiStripFecKey(path.key()).path();
    } else if (view == sistrip::READOUT_VIEW) {
      client_dir = SiStripFedKey(path.key()).path();
    } else if (view == sistrip::DETECTOR_VIEW) {
      client_dir = SiStripDetKey(path.key()).path();
    } else {
      client_dir = SiStripKey(path.key()).path();
    }
    std::string slash = client_dir.substr(client_dir.size() - 1, 1);
    if (slash == sistrip::dir_) {
      client_dir = client_dir.substr(0, client_dir.size() - 1);
    }
    client_dir = std::string(sistrip::collate_) + sistrip::dir_ + client_dir;

    // Retrieve MonitorElements from source directory
    std::vector<MonitorElement*> me_list = bei_->getContents(source_dir);

    // Iterate though MonitorElements and create CMEs
    std::vector<MonitorElement*>::iterator ime = me_list.begin();
    for (; ime != me_list.end(); ime++) {
      // Retrieve histogram title
      SiStripHistoTitle title((*ime)->getName());

      // Check histogram type
      //if ( title.histoType() != sistrip::EXPERT_HISTO ) { continue; }

      // Check granularity
      uint16_t channel = sistrip::invalid_;
      if (title.granularity() == sistrip::APV) {
        channel = SiStripFecKey::lldChan(title.channel());
      } else if (title.granularity() == sistrip::UNKNOWN_GRAN || title.granularity() == sistrip::UNDEFINED_GRAN) {
        std::stringstream ss;
        ss << "[CommissioningHistograms::" << __func__ << "]"
           << " Unexpected granularity for histogram title: " << std::endl
           << title << " found in path " << std::endl
           << path;
        edm::LogError(mlDqmClient_) << ss.str();
      } else {
        channel = title.channel();
      }

      // Build key
      uint32_t key = sistrip::invalid32_;

      if (view == sistrip::CONTROL_VIEW) {
        // for all runs except cabling
        SiStripFecKey temp(path.key());
        key = SiStripFecKey(temp.fecCrate(), temp.fecSlot(), temp.fecRing(), temp.ccuAddr(), temp.ccuChan(), channel)
                  .key();
        mapping_[title.keyValue()] = key;

      } else if (view == sistrip::READOUT_VIEW) {
        // for cabling run
        key = SiStripFedKey(path.key()).key();
        uint32_t temp = SiStripFecKey(sistrip::invalid_,
                                      sistrip::invalid_,
                                      sistrip::invalid_,
                                      sistrip::invalid_,
                                      sistrip::invalid_,
                                      channel)
                            .key();  // just record lld channel
        mapping_[title.keyValue()] = temp;

      } else if (view == sistrip::DETECTOR_VIEW) {
        SiStripDetKey temp(path.key());
        key = SiStripDetKey(temp.partition()).key();
        mapping_[title.keyValue()] = key;

      } else {
        key = SiStripKey(path.key()).key();
      }

      // Find CME in histos map
      Histo* histo = nullptr;
      HistosMap::iterator ihistos = histos_.find(key);
      if (ihistos != histos_.end()) {
        Histos::iterator ihis = ihistos->second.begin();
        while (!histo && ihis < ihistos->second.end()) {
          if ((*ime)->getName() == (*ihis)->title_) {
            histo = *ihis;
          }
          ihis++;
        }
      }

      // Create CollateME if it doesn't exist
      if (!histo) {
        histos_[key].push_back(new Histo());
        histo = histos_[key].back();
        histo->title_ = (*ime)->getName();

        // If histogram present in client directory, add to map
        if (source_dir.find(sistrip::collate_) != std::string::npos) {
          histo->me_ = bei_->get(client_dir + "/" + (*ime)->getName());
          if (!histo->me_) {
            edm::LogError(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                        << " NULL pointer to MonitorElement!";
          }
        }
      }
    }
  }

  //printHistosMap();

  edm::LogVerbatim(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                 << " Found histograms for " << histos_.size()
                                 << " structures in cached histogram map!";
}

factory()

CommissioningHistograms::Factory *const CommissioningHistograms::factory ( )

inlineprotected

Definition at line 160 of file CommissioningHistograms.h.

References factory_.

Referenced by createSummaryHisto().

{ return factory_.get(); }

histoAnalysis()

void CommissioningHistograms::histoAnalysis ( bool  debug )

virtual

Reimplemented in FedCablingHistograms, FedTimingHistograms, SamplingHistograms, ApvTimingHistograms, CalibrationHistograms, DaqScopeModeHistograms, FastFedCablingHistograms, NoiseHistograms, OptoScanHistograms, PedestalsHistograms, PedsFullNoiseHistograms, PedsOnlyHistograms, and VpspScanHistograms.

Definition at line 459 of file CommissioningHistograms.cc.

References LogTrace, and sistrip::mlDqmClient_.

Referenced by SiStripCommissioningOfflineClient::beginRun(), and createSummaryHisto().

                                                      {
  LogTrace(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                         << " (Derived) implementation to come...";
}

histogram()

TH1 * CommissioningHistograms::histogram ( const sistrip::Monitorable &  mon, const sistrip::Presentation &  pres, const sistrip::View &  view, const std::string &  directory, const uint32_t &  xbins, const float &  xlow = 1. * sistrip::invalid_, const float &  xhigh = 1. * sistrip::invalid_  )

protected

Definition at line 656 of file CommissioningHistograms.cc.

References bei_, dqm::implementation::IBooker::book1D(), dqm::implementation::IBooker::book2D(), dqm::implementation::IBooker::bookProfile(), sistrip::collate_, sistrip::dir_, createBeamHaloJobs::directory, extract(), sistrip::FED_ADC_RANGE, dqm::implementation::IGetter::get(), LaserClient_cfi::high, sistrip::HISTO_1D, sistrip::HISTO_2D_SCATTER, sistrip::HISTO_2D_SUM, LogTrace, hlt_dqm_clientPB-live_cfg::me, sistrip::mlDqmClient_, LaserDQM_cfi::mon, Skims_PA_cff::name, SummaryGenerator::name(), SiStripEnumsAndStrings::presentation(), sistrip::PROFILE_1D, alignCSCRings::pwd, dqm::implementation::DQMStore::pwd(), dqm::implementation::DQMStore::setCurrentFolder(), AlCaHLTBitMon_QueryRunRegistry::string, edmLumisInFiles::summary, task_, sistrip::valid_, and fw3dlego::xbins.

Referenced by FedTimingHistograms::createSummaryHisto(), FedCablingHistograms::createSummaryHisto(), and createSummaryHisto().

                                                            {
  // Remember pwd
  std::string pwd = bei_->pwd();
  bei_->setCurrentFolder(std::string(sistrip::collate_) + sistrip::dir_ + directory);

  // Construct histogram name
  std::string name = SummaryGenerator::name(task_, mon, pres, view, directory);

  MonitorElement* me = bei_->get(bei_->pwd() + "/" + name);

  // Create summary plot
  float high = static_cast<float>(xbins);
  if (pres == sistrip::HISTO_1D) {
    if (xlow < 1. * sistrip::valid_ && xhigh < 1. * sistrip::valid_) {
      me = bei_->book1D(name, name, xbins, xlow, xhigh);
    } else {
      me = bei_->book1D(name, name, xbins, 0., high);
    }
  } else if (pres == sistrip::HISTO_2D_SUM) {
    me = bei_->book1D(name, name, xbins, 0., high);
  } else if (pres == sistrip::HISTO_2D_SCATTER) {
    me = bei_->book2D(name, name, xbins, 0., high, sistrip::FED_ADC_RANGE + 1, 0., sistrip::FED_ADC_RANGE * 1.);
  } else if (pres == sistrip::PROFILE_1D) {
    me = bei_->bookProfile(name, name, xbins, 0., high, sistrip::FED_ADC_RANGE + 1, 0., sistrip::FED_ADC_RANGE * 1.);
  } else {
    me = nullptr;
    edm::LogWarning(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                  << " Unexpected presentation \"" << SiStripEnumsAndStrings::presentation(pres)
                                  << "\" Unable to create summary plot!";
  }

  // Check pointer
  if (me) {
    LogTrace(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                           << " Created summary plot with name \"" << me->getName() << "\" in directory \""
                           << bei_->pwd() << "\"!";
  } else {
    edm::LogWarning(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                  << " NULL pointer to MonitorElement!"
                                  << " Unable to create summary plot!";
  }

  // Extract root object
  TH1* summary = ExtractTObject<TH1>().extract(me);
  if (!summary) {
    edm::LogWarning(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                  << " Unable to extract root object!"
                                  << " Returning NULL pointer!";
  }

  // Return to pwd
  bei_->setCurrentFolder(pwd);

  return summary;
}

histos()

const CommissioningHistograms::HistosMap & CommissioningHistograms::histos ( ) const

inlineprotected

Definition at line 161 of file CommissioningHistograms.h.

References histos_.

Referenced by ApvTimingHistograms::histoAnalysis(), VpspScanHistograms::histoAnalysis(), CalibrationHistograms::histoAnalysis(), FastFedCablingHistograms::histoAnalysis(), PedestalsHistograms::histoAnalysis(), PedsFullNoiseHistograms::histoAnalysis(), OptoScanHistograms::histoAnalysis(), NoiseHistograms::histoAnalysis(), PedsOnlyHistograms::histoAnalysis(), DaqScopeModeHistograms::histoAnalysis(), SamplingHistograms::histoAnalysis(), and FedCablingHistograms::histoAnalysis().

{ return histos_; }

mapping()

const CommissioningHistograms::FedToFecMap & CommissioningHistograms::mapping ( ) const

inlineprotected

Definition at line 162 of file CommissioningHistograms.h.

References mapping_.

Referenced by FastFedCablingHistograms::histoAnalysis().

{ return mapping_; }

printAnalyses()

void CommissioningHistograms::printAnalyses ( )

virtual

Reimplemented in FedCablingHistograms, CalibrationHistograms, DaqScopeModeHistograms, FastFedCablingHistograms, NoiseHistograms, OptoScanHistograms, PedestalsHistograms, PedsFullNoiseHistograms, PedsOnlyHistograms, and VpspScanHistograms.

Definition at line 466 of file CommissioningHistograms.cc.

References data(), LogTrace, sistrip::mlDqmClient_, and contentValuesCheck::ss.

Referenced by SiStripCommissioningOfflineClient::beginRun().

                                            {
  Analyses::iterator ianal = data().begin();
  Analyses::iterator janal = data().end();
  for (; ianal != janal; ++ianal) {
    if (ianal->second) {
      std::stringstream ss;
      ianal->second->print(ss);
      if (ianal->second->isValid()) {
        LogTrace(mlDqmClient_) << ss.str();
      } else {
        edm::LogWarning(mlDqmClient_) << ss.str();
      }
    }
  }
}

printHistosMap()

void CommissioningHistograms::printHistosMap ( )

protected

Definition at line 519 of file CommissioningHistograms.cc.

References histos_, LogTrace, sistrip::mlDqmClient_, SiStripFedKey::print(), and contentValuesCheck::ss.

                                             {
  LogTrace(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                         << " Printing histogram map, which has " << histos_.size() << " entries...";
  HistosMap::const_iterator ihistos = histos_.begin();
  for (; ihistos != histos_.end(); ihistos++) {
    std::stringstream ss;
    ss << " Found " << ihistos->second.size() << " histogram(s) for key: " << std::endl
       << SiStripFedKey(ihistos->first) << std::endl;
    Histos::const_iterator ihisto = ihistos->second.begin();
    for (; ihisto != ihistos->second.end(); ihisto++) {
      if (*ihisto) {
        (*ihisto)->print(ss);
      } else {
        ss << " NULL pointer to Histo object!";
      }
    }
    LogTrace(mlDqmClient_) << ss.str();
  }
}

printSummary()

void CommissioningHistograms::printSummary ( )

virtual

Reimplemented in FastFedCablingHistograms.

Definition at line 484 of file CommissioningHistograms.cc.

References data(), caHitNtupletGeneratorKernels::good, LogTrace, and sistrip::mlDqmClient_.

Referenced by SiStripCommissioningOfflineClient::beginRun().

                                           {
  std::stringstream good;
  std::stringstream bad;

  Analyses::iterator ianal = data().begin();
  Analyses::iterator janal = data().end();
  for (; ianal != janal; ++ianal) {
    if (ianal->second) {
      if (ianal->second->isValid()) {
        ianal->second->summary(good);
      } else {
        ianal->second->summary(bad);
      }
    }
  }

  if (good.str().empty()) {
    good << "None found!";
  }
  LogTrace(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                         << " Printing summary of good analyses:"
                         << "\n"
                         << good.str();

  if (bad.str().empty()) {
    return;
  }  //@@ bad << "None found!"; }
  LogTrace(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                         << " Printing summary of bad analyses:"
                         << "\n"
                         << bad.str();
}

pset()

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

inlineprotected

Definition at line 163 of file CommissioningHistograms.h.

References pset_.

Referenced by ApvTimingHistosUsingDb::ApvTimingHistosUsingDb(), CalibrationHistograms::CalibrationHistograms(), CalibrationHistosUsingDb::CalibrationHistosUsingDb(), LatencyHistosUsingDb::configure(), FineDelayHistosUsingDb::configure(), DaqScopeModeHistosUsingDb::DaqScopeModeHistosUsingDb(), ApvTimingHistograms::histoAnalysis(), OptoScanHistograms::histoAnalysis(), CalibrationHistograms::histoAnalysis(), DaqScopeModeHistograms::histoAnalysis(), PedestalsHistograms::histoAnalysis(), FastFedCablingHistograms::histoAnalysis(), PedsFullNoiseHistograms::histoAnalysis(), PedsOnlyHistograms::histoAnalysis(), VpspScanHistograms::histoAnalysis(), NoiseHistograms::histoAnalysis(), SamplingHistograms::histoAnalysis(), FedCablingHistograms::histoAnalysis(), OptoScanHistosUsingDb::OptoScanHistosUsingDb(), PedestalsHistosUsingDb::PedestalsHistosUsingDb(), PedsFullNoiseHistosUsingDb::PedsFullNoiseHistosUsingDb(), and VpspScanHistosUsingDb::VpspScanHistosUsingDb().

{ return pset_; }

remove()

void CommissioningHistograms::remove

(

std::string

pattern = ""

)

Definition at line 605 of file CommissioningHistograms.cc.

Referenced by SiStripCommissioningOfflineClient::beginRun().

                                                      {
  // TODO: remove no longer supported in DQMStore.
}

runNumber()

uint32_t CommissioningHistograms::runNumber ( DQMStore * const  bei, const std::vector< std::string > &  contents  )

static

Definition at line 94 of file CommissioningHistograms.cc.

References bei(), dqm::implementation::IBooker::bookString(), sistrip::collate_, relmon_rootfiles_spy::contents, TauDecayModes::dec, sistrip::dir_, dqm::implementation::IGetter::get(), dqm::implementation::IGetter::getContents(), LogTrace, sistrip::mlDqmClient_, castor_dqm_sourceclient_file_cfg::path, writedatasetfile::run, sistrip::runNumber_, dqm::implementation::DQMStore::setCurrentFolder(), pickleFileParser::slash, contentValuesCheck::ss, AlCaHLTBitMon_QueryRunRegistry::string, runGCPTkAlMap::title, and relativeConstraints::value.

Referenced by SiStripCommissioningOfflineClient::beginRun().

                                                                                                     {
  // Check if histograms present
  if (contents.empty()) {
    edm::LogError(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                << " Found no histograms!";
    return 0;
  }

  // Iterate through added contents
  std::vector<std::string>::const_iterator istr = contents.begin();
  while (istr != contents.end()) {
    // Extract source directory path
    std::string source_dir = istr->substr(0, istr->find(":"));

    // Generate corresponding client path (removing trailing "/")
    SiStripFecKey path(source_dir);
    std::string client_dir = path.path();
    std::string slash = client_dir.substr(client_dir.size() - 1, 1);
    if (slash == sistrip::dir_) {
      client_dir = client_dir.substr(0, client_dir.size() - 1);
    }
    client_dir = std::string(sistrip::collate_) + sistrip::dir_ + client_dir;

    // Iterate though MonitorElements from source directory
    std::vector<MonitorElement*> me_list = bei->getContents(source_dir);
    std::vector<MonitorElement*>::iterator ime = me_list.begin();
    for (; ime != me_list.end(); ime++) {
      if (!(*ime)) {
        edm::LogError(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                    << " NULL pointer to MonitorElement!";
        continue;
      }

      // Search for run type in string
      std::string title = (*ime)->getName();
      std::string::size_type pos = title.find(sistrip::runNumber_);

      // Extract run number from string
      if (pos != std::string::npos) {
        std::string value = title.substr(pos + sizeof(sistrip::runNumber_), std::string::npos);
        if (!value.empty()) {
          LogTrace(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                 << " Found string \"" << title.substr(pos, std::string::npos) << "\" with value \""
                                 << value << "\"";
          if (!(bei->get(client_dir + "/" + title.substr(pos, std::string::npos)))) {
            bei->setCurrentFolder(client_dir);
            bei->bookString(title.substr(pos, std::string::npos), value);
            LogTrace(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                   << " Booked string \"" << title.substr(pos, std::string::npos)
                                   << "\" in directory \"" << client_dir << "\"";
          }
          uint32_t run;
          std::stringstream ss;
          ss << value;
          ss >> std::dec >> run;
          return run;
        }
      }
    }

    istr++;
  }
  return 0;
}

runType()

sistrip::RunType CommissioningHistograms::runType ( DQMStore * const  bei, const std::vector< std::string > &  contents  )

static

Extract run type string from "added contents".

Definition at line 161 of file CommissioningHistograms.cc.

References bei(), dqm::implementation::IBooker::bookString(), sistrip::collate_, relmon_rootfiles_spy::contents, sistrip::dir_, dqm::implementation::IGetter::get(), dqm::implementation::IGetter::getContents(), LogTrace, sistrip::mlDqmClient_, castor_dqm_sourceclient_file_cfg::path, SiStripEnumsAndStrings::runType(), dqm::implementation::DQMStore::setCurrentFolder(), pickleFileParser::slash, AlCaHLTBitMon_QueryRunRegistry::string, sistrip::taskId_, runGCPTkAlMap::title, sistrip::UNKNOWN_RUN_TYPE, and relativeConstraints::value.

Referenced by SiStripCommissioningOfflineClient::beginRun().

                                                                                                         {
  // Check if histograms present
  if (contents.empty()) {
    edm::LogError(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                << " Found no histograms!";
    return sistrip::UNKNOWN_RUN_TYPE;
  }

  // Iterate through added contents
  std::vector<std::string>::const_iterator istr = contents.begin();
  while (istr != contents.end()) {
    // Extract source directory path
    std::string source_dir = istr->substr(0, istr->find(":"));

    // Generate corresponding client path (removing trailing "/")
    SiStripFecKey path(source_dir);
    std::string client_dir = path.path();
    std::string slash = client_dir.substr(client_dir.size() - 1, 1);
    if (slash == sistrip::dir_) {
      client_dir = client_dir.substr(0, client_dir.size() - 1);
    }
    client_dir = std::string(sistrip::collate_) + sistrip::dir_ + client_dir;

    // Iterate though MonitorElements from source directory
    std::vector<MonitorElement*> me_list = bei->getContents(source_dir);

    if (me_list.empty()) {
      edm::LogError(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                  << " No MonitorElements found in dir " << source_dir;
      return sistrip::UNKNOWN_RUN_TYPE;
    }

    std::vector<MonitorElement*>::iterator ime = me_list.begin();
    for (; ime != me_list.end(); ime++) {
      if (!(*ime)) {
        edm::LogError(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                    << " NULL pointer to MonitorElement!";
        continue;
      }

      // Search for run type in string
      std::string title = (*ime)->getName();
      std::string::size_type pos = title.find(sistrip::taskId_);

      // Extract commissioning task from string
      if (pos != std::string::npos) {
        std::string value = title.substr(pos + sizeof(sistrip::taskId_), std::string::npos);
        if (!value.empty()) {
          LogTrace(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                 << " Found string \"" << title.substr(pos, std::string::npos) << "\" with value \""
                                 << value << "\"";
          if (!(bei->get(client_dir + sistrip::dir_ + title.substr(pos, std::string::npos)))) {
            bei->setCurrentFolder(client_dir);
            bei->bookString(title.substr(pos, std::string::npos), value);
            LogTrace(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                   << " Booked string \"" << title.substr(pos, std::string::npos)
                                   << "\" in directory \"" << client_dir << "\"";
          }
          return SiStripEnumsAndStrings::runType(value);
        }
      }
    }

    istr++;
  }

  edm::LogError(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                              << " Unable to extract RunType!";
  return sistrip::UNKNOWN_RUN_TYPE;
}

save()

void CommissioningHistograms::save	(	std::string &	filename,
		uint32_t	run_number = 0,
		std::string	partitionName = ""
	)

Definition at line 611 of file CommissioningHistograms.cc.

References bei_, sistrip::collate_, DeadROC_duringRun::dir, sistrip::dqmClientFileName_, LogTrace, sistrip::mlDqmClient_, FrameHeaderEvents_cfi::partitionName, castor_dqm_sourceclient_file_cfg::path, contentValuesCheck::run_number, dqm::implementation::DQMStore::save(), contentValuesCheck::ss, and AlCaHLTBitMon_QueryRunRegistry::string.

Referenced by SiStripCommissioningOfflineClient::beginRun().

                                                                                                {
  // Construct path and filename
  std::stringstream ss;

  if (!path.empty()) {
    ss << path;
    if (ss.str().find(".root") == std::string::npos) {
      ss << ".root";
    }

  } else {
    // Retrieve SCRATCH directory
    std::string scratch = "SCRATCH";
    std::string dir = "";
    if (std::getenv(scratch.c_str()) != nullptr) {
      dir = std::getenv(scratch.c_str());
    }

    // Add directory path
    if (!dir.empty()) {
      ss << dir << "/";
    } else {
      ss << "/tmp/";
    }

    // Add filename with run number and ".root" extension
    if (partitionName.empty())
      ss << sistrip::dqmClientFileName_ << "_" << std::setfill('0') << std::setw(8) << run_number << ".root";
    else
      ss << sistrip::dqmClientFileName_ << "_" << partitionName << "_" << std::setfill('0') << std::setw(8)
         << run_number << ".root";
  }

  // Save file with appropriate filename
  LogTrace(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                         << " Saving histograms to root file"
                         << " (This may take some time!)";
  path = ss.str();
  bei_->save(path, sistrip::collate_);
  edm::LogVerbatim(mlDqmClient_) << "[CommissioningHistograms::" << __func__ << "]"
                                 << " Saved histograms to root file \"" << ss.str() << "\"!";
}

task()

const sistrip::RunType & CommissioningHistograms::task ( ) const

inlineprotected

Definition at line 158 of file CommissioningHistograms.h.

References task_.

Referenced by CalibrationHistograms::CalibrationHistograms(), CalibrationHistosUsingDb::create(), CalibrationHistograms::histoAnalysis(), CalibrationHistosUsingDb::update(), and CalibrationHistosUsingDb::uploadConfigurations().

{ return task_; }

Member Data Documentation

bei_

DQMStore* CommissioningHistograms::bei_

private

Definition at line 134 of file CommissioningHistograms.h.

Referenced by bei(), CommissioningHistograms(), extractHistograms(), histogram(), and save().

ccuVector_

std::vector<uint32_t> CommissioningHistograms::ccuVector_

private

Definition at line 148 of file CommissioningHistograms.h.

Referenced by data().

data_

Analyses CommissioningHistograms::data_

private

Definition at line 136 of file CommissioningHistograms.h.

Referenced by data().

dataWithMask_

Analyses CommissioningHistograms::dataWithMask_

private

Definition at line 152 of file CommissioningHistograms.h.

Referenced by data().

dataWithMaskCached_

bool CommissioningHistograms::dataWithMaskCached_

private

Definition at line 153 of file CommissioningHistograms.h.

Referenced by data().

factory_

std::unique_ptr<Factory> CommissioningHistograms::factory_

protected

Definition at line 129 of file CommissioningHistograms.h.

Referenced by ApvTimingHistograms::ApvTimingHistograms(), CalibrationHistograms::CalibrationHistograms(), DaqScopeModeHistograms::DaqScopeModeHistograms(), factory(), FastFedCablingHistograms::FastFedCablingHistograms(), NoiseHistograms::NoiseHistograms(), OptoScanHistograms::OptoScanHistograms(), PedestalsHistograms::PedestalsHistograms(), PedsFullNoiseHistograms::PedsFullNoiseHistograms(), PedsOnlyHistograms::PedsOnlyHistograms(), SamplingHistograms::SamplingHistograms(), and VpspScanHistograms::VpspScanHistograms().

fecMaskVector_

std::vector<uint32_t> CommissioningHistograms::fecMaskVector_

private

Definition at line 146 of file CommissioningHistograms.h.

Referenced by data().

fedMaskVector_

std::vector<uint32_t> CommissioningHistograms::fedMaskVector_

private

Definition at line 145 of file CommissioningHistograms.h.

Referenced by data().

histos_

HistosMap CommissioningHistograms::histos_

private

Definition at line 138 of file CommissioningHistograms.h.

Referenced by clearHistosMap(), extractHistograms(), histos(), and printHistosMap().

i2cChanVector_

std::vector<uint32_t> CommissioningHistograms::i2cChanVector_

private

Definition at line 149 of file CommissioningHistograms.h.

Referenced by data().

lldChanVector_

std::vector<uint32_t> CommissioningHistograms::lldChanVector_

private

Definition at line 150 of file CommissioningHistograms.h.

Referenced by data().

mapping_

FedToFecMap CommissioningHistograms::mapping_

private

Definition at line 140 of file CommissioningHistograms.h.

Referenced by extractHistograms(), and mapping().

mask_

bool CommissioningHistograms::mask_

private

Definition at line 144 of file CommissioningHistograms.h.

Referenced by data().

pset_

edm::ParameterSet CommissioningHistograms::pset_

private

Definition at line 142 of file CommissioningHistograms.h.

Referenced by pset().

ringVector_

std::vector<uint32_t> CommissioningHistograms::ringVector_

private

Definition at line 147 of file CommissioningHistograms.h.

Referenced by data().

task_

sistrip::RunType CommissioningHistograms::task_

private

Definition at line 132 of file CommissioningHistograms.h.

Referenced by histogram(), and task().