Inheritance diagram for SiStripFEDCheckPlugin:

Public Member Functions
	SiStripFEDCheckPlugin (const edm::ParameterSet &)

	~SiStripFEDCheckPlugin ()

Public Member Functions inherited from DQMEDAnalyzer
virtual void	beginRun (edm::Run const &, edm::EventSetup const &) final

virtual void	beginStream (edm::StreamID id) final

virtual void	dqmBeginRun (edm::Run const &, edm::EventSetup const &)

	DQMEDAnalyzer (void)

virtual void	endLuminosityBlockSummary (edm::LuminosityBlock const &, edm::EventSetup const &, dqmDetails::NoCache *) const final

virtual void	endRunSummary (edm::Run const &, edm::EventSetup const &, dqmDetails::NoCache *) const final

uint32_t	streamId () const

Public Member Functions inherited from edm::stream::EDAnalyzer< edm::RunSummaryCache< dqmDetails::NoCache >, edm::LuminosityBlockSummaryCache< dqmDetails::NoCache > >
	EDAnalyzer ()=default

Public Member Functions inherited from edm::stream::EDAnalyzerBase
	EDAnalyzerBase ()

ModuleDescription const &	moduleDescription () const

virtual	~EDAnalyzerBase ()

Public Member Functions inherited from edm::EDConsumerBase
	EDConsumerBase ()

ProductHolderIndexAndSkipBit	indexFrom (EDGetToken, BranchType, TypeID const &) const

void	itemsMayGet (BranchType, std::vector< ProductHolderIndexAndSkipBit > &) const

void	itemsToGet (BranchType, std::vector< ProductHolderIndexAndSkipBit > &) const

std::vector < ProductHolderIndexAndSkipBit > const &	itemsToGetFromEvent () const

void	labelsForToken (EDGetToken iToken, Labels &oLabels) const

void	modulesDependentUpon (const std::string &iProcessName, std::vector< const char * > &oModuleLabels) const

bool	registeredToConsume (ProductHolderIndex, bool, BranchType) const

bool	registeredToConsumeMany (TypeID const &, BranchType) const

void	updateLookup (BranchType iBranchType, ProductHolderIndexHelper const &)

virtual	~EDConsumerBase ()

Private Member Functions
virtual void	analyze (const edm::Event &, const edm::EventSetup &) override

void	bookHistograms (DQMStore::IBooker &, edm::Run const &, edm::EventSetup const &) override

void	doUpdateIfNeeded ()

virtual void	endRun ()

void	fillFatalError (unsigned int fedId, bool fatalError)

void	fillNonFatalError (unsigned int fedId, float nonFatalError)

void	fillPresent (unsigned int fedId, bool present)

bool	hasFatalError (const FEDRawData &fedData, unsigned int fedId) const

bool	hasNonFatalError (const FEDRawData &fedData, unsigned int fedId) const

void	updateCabling (const edm::EventSetup &eventSetup)

void	updateHistograms ()

Private Attributes
const SiStripFedCabling *	cabling_

uint32_t	cablingCacheId_

bool	checkChannelLengths_

bool	checkChannelStatusBits_

bool	checkFELengths_

bool	checkPacketCodes_

std::string	dirName_

bool	doPayloadChecks_

unsigned int	eventCount_

std::vector< unsigned int >	fedFatalErrorBinContents_

MonitorElement *	fedFatalErrors_

std::vector< unsigned int >	fedNonFatalErrorBinContents_

MonitorElement *	fedNonFatalErrors_

MonitorElement *	fedsPresent_

std::vector< unsigned int >	fedsPresentBinContents_

bool	printDebug_

edm::InputTag	rawDataTag_

edm::EDGetTokenT < FEDRawDataCollection >	rawDataToken_

unsigned int	updateFrequency_

Additional Inherited Members
Public Types inherited from edm::stream::EDAnalyzer< edm::RunSummaryCache< dqmDetails::NoCache >, edm::LuminosityBlockSummaryCache< dqmDetails::NoCache > >
typedef CacheContexts< T...>	CacheTypes

typedef CacheTypes::GlobalCache	GlobalCache

typedef AbilityChecker< T...>	HasAbility

typedef CacheTypes::LuminosityBlockCache	LuminosityBlockCache

typedef LuminosityBlockContextT < LuminosityBlockCache, RunCache, GlobalCache >	LuminosityBlockContext

typedef CacheTypes::LuminosityBlockSummaryCache	LuminosityBlockSummaryCache

typedef CacheTypes::RunCache	RunCache

typedef RunContextT< RunCache, GlobalCache >	RunContext

typedef CacheTypes::RunSummaryCache	RunSummaryCache

Public Types inherited from edm::stream::EDAnalyzerBase
typedef EDAnalyzerAdaptorBase	ModuleType

Static Public Member Functions inherited from DQMEDAnalyzer
static std::shared_ptr < dqmDetails::NoCache >	globalBeginLuminosityBlockSummary (edm::LuminosityBlock const &, edm::EventSetup const &, LuminosityBlockContext const *)

static std::shared_ptr < dqmDetails::NoCache >	globalBeginRunSummary (edm::Run const &, edm::EventSetup const &, RunContext const *)

static void	globalEndLuminosityBlockSummary (edm::LuminosityBlock const &, edm::EventSetup const &, LuminosityBlockContext const , dqmDetails::NoCache )

static void	globalEndRunSummary (edm::Run const &, edm::EventSetup const &, RunContext const , dqmDetails::NoCache )

Static Public Member Functions inherited from edm::stream::EDAnalyzerBase
static const std::string &	baseType ()

static void	fillDescriptions (ConfigurationDescriptions &descriptions)

static void	prevalidate (ConfigurationDescriptions &descriptions)

Protected Member Functions inherited from edm::stream::EDAnalyzerBase
void	callWhenNewProductsRegistered (std::function< void(BranchDescription const &)> const &func)

Protected Member Functions inherited from edm::EDConsumerBase
template<typename ProductType , BranchType B = InEvent>
EDGetTokenT< ProductType >	consumes (edm::InputTag const &tag)

EDGetToken	consumes (const TypeToGet &id, edm::InputTag const &tag)

template<BranchType B>
EDGetToken	consumes (TypeToGet const &id, edm::InputTag const &tag)

ConsumesCollector	consumesCollector ()
	Use a ConsumesCollector to gather consumes information from helper functions. More...

template<typename ProductType , BranchType B = InEvent>
void	consumesMany ()

void	consumesMany (const TypeToGet &id)

template<BranchType B>
void	consumesMany (const TypeToGet &id)

template<typename ProductType , BranchType B = InEvent>
EDGetTokenT< ProductType >	mayConsume (edm::InputTag const &tag)

EDGetToken	mayConsume (const TypeToGet &id, edm::InputTag const &tag)

template<BranchType B>
EDGetToken	mayConsume (const TypeToGet &id, edm::InputTag const &tag)

Detailed Description

Description: DQM source application to produce data integrety histograms for SiStrip data for use in HLT and Prompt reco

Definition at line 52 of file SiStripFEDDataCheck.cc.

Constructor & Destructor Documentation

SiStripFEDCheckPlugin::SiStripFEDCheckPlugin ( const edm::ParameterSet & iConfig )

explicit

Definition at line 105 of file SiStripFEDDataCheck.cc.

References checkChannelLengths_, checkChannelStatusBits_, checkFELengths_, checkPacketCodes_, doPayloadChecks_, printDebug_, rawDataTag_, rawDataToken_, and contentValuesCheck::ss.

   : rawDataTag_(iConfig.getParameter<edm::InputTag>("RawDataTag")),
     dirName_(iConfig.getUntrackedParameter<std::string>("DirName","SiStrip/FEDIntegrity/")),
     printDebug_(iConfig.getUntrackedParameter<bool>("PrintDebugMessages",false)),
     updateFrequency_(iConfig.getUntrackedParameter<unsigned int>("HistogramUpdateFrequency",0)),
     fedsPresentBinContents_(FEDNumbering::MAXSiStripFEDID+1,0),
     fedFatalErrorBinContents_(FEDNumbering::MAXSiStripFEDID+1,0),
     fedNonFatalErrorBinContents_(FEDNumbering::MAXSiStripFEDID+1,0),
     eventCount_(0),
     doPayloadChecks_(iConfig.getUntrackedParameter<bool>("DoPayloadChecks",true)),
     checkChannelLengths_(iConfig.getUntrackedParameter<bool>("CheckChannelLengths",true)),
     checkPacketCodes_(iConfig.getUntrackedParameter<bool>("CheckChannelPacketCodes",true)),
     checkFELengths_(iConfig.getUntrackedParameter<bool>("CheckFELengths",true)),
     checkChannelStatusBits_(iConfig.getUntrackedParameter<bool>("CheckChannelStatus",true)),
     cablingCacheId_(0)
 {
   rawDataToken_ = consumes<FEDRawDataCollection>(rawDataTag_);
   if (printDebug_ && !doPayloadChecks_ && (checkChannelLengths_ || checkPacketCodes_ || checkFELengths_)) {
     std::stringstream ss;
     ss << "Payload checks are disabled but individual payload checks have been enabled. The following payload checks will be skipped: ";
     if (checkChannelLengths_) ss << "Channel length check, ";
     if (checkPacketCodes_) ss << "Channel packet code check, ";
     if (checkChannelStatusBits_) ss << "Cabled channel status bits checks, ";
     if (checkFELengths_) ss << "FE Unit legnth check";
     edm::LogWarning("SiStripFEDCheck") << ss.str();
   }
 }

SiStripFEDCheckPlugin::~SiStripFEDCheckPlugin ( )

Definition at line 133 of file SiStripFEDDataCheck.cc.

134 {

135 }

Member Function Documentation

void SiStripFEDCheckPlugin::analyze	(	const edm::Event &	iEvent,
		const edm::EventSetup &	iSetup
	)

overrideprivatevirtual

Implements edm::stream::EDAnalyzerBase.

Definition at line 144 of file SiStripFEDDataCheck.cc.

References cabling_, checkChannelLengths_, checkChannelStatusBits_, checkFELengths_, checkPacketCodes_, FEDRawData::data(), doPayloadChecks_, doUpdateIfNeeded(), FEDRawDataCollection::FEDData(), fillFatalError(), fillNonFatalError(), fillPresent(), edm::EventSetup::get(), edm::Event::getByToken(), FEDNumbering::MAXSiStripFEDID, FEDNumbering::MINSiStripFEDID, printDebug_, edm::ESHandle< class >::product(), rawDataToken_, FEDRawData::size(), contentValuesCheck::ss, and updateCabling().

 {
   //Retrieve tracker topology from geometry
   edm::ESHandle<TrackerTopology> tTopoHandle;
   iSetup.get<IdealGeometryRecord>().get(tTopoHandle);
   const TrackerTopology* const tTopo = tTopoHandle.product();
 
   //update cabling
   updateCabling(iSetup);
   
   //get raw data
   edm::Handle<FEDRawDataCollection> rawDataCollectionHandle;
   const bool gotData = iEvent.getByToken(rawDataToken_,rawDataCollectionHandle);
   if (!gotData) {
     //module is required to silently do nothing when data is not present
     return;
   }
   const FEDRawDataCollection& rawDataCollection = *rawDataCollectionHandle;
   
   //get FED IDs
   const unsigned int siStripFedIdMin = FEDNumbering::MINSiStripFEDID;
   const unsigned int siStripFedIdMax = FEDNumbering::MAXSiStripFEDID;
   
   //FED errors
   FEDErrors lFedErrors;
 
   //loop over siStrip FED IDs
   for (unsigned int fedId = siStripFedIdMin; fedId <= siStripFedIdMax; fedId++) {
     const FEDRawData& fedData = rawDataCollection.FEDData(fedId);
 
     //create an object to fill all errors
     //third param to false:save time by not initialising anything not used here
     lFedErrors.initialiseFED(fedId,cabling_,tTopo,false);
 
 
     //check data exists
     if (!fedData.size() || !fedData.data()) {
       fillPresent(fedId,0);
       continue;
     }
     //fill buffer present histogram
     fillPresent(fedId,1);
 
     //check for fatal errors
     //no need for debug output
     bool hasFatalErrors = false;
     float rateNonFatal = 0;
 
     std::auto_ptr<const sistrip::FEDBuffer> buffer;
 
     if (!lFedErrors.fillFatalFEDErrors(fedData,0)) {
       hasFatalErrors = true;
     }
     else {
       //need to construct full object to go any further
       if (doPayloadChecks_ || checkChannelStatusBits_) {
     
     buffer.reset(new sistrip::FEDBuffer(fedData.data(),fedData.size(),true));
     if (doPayloadChecks_) {
 
       bool channelLengthsOK = checkChannelLengths_ ? buffer->checkChannelLengthsMatchBufferLength() : true;
       bool channelPacketCodesOK = checkPacketCodes_ ? buffer->checkChannelPacketCodes() : true;
       bool feLengthsOK = checkFELengths_ ? buffer->checkFEUnitLengths() : true;
       if ( !channelLengthsOK ||
            !channelPacketCodesOK ||
            !feLengthsOK ) {
         hasFatalErrors = true;
       }
     }
     if (checkChannelStatusBits_) rateNonFatal = lFedErrors.fillNonFatalFEDErrors(buffer.get(),cabling_);
       }
     }
 
     if (hasFatalErrors) {
       fillFatalError(fedId,1);
       if (printDebug_) {
     if (!buffer.get()) buffer.reset(new sistrip::FEDBuffer(fedData.data(),fedData.size(),true));
     edm::LogInfo("SiStripFEDCheck") << "Fatal error with FED ID " << fedId << ". Check summary: " 
                     << std::endl << buffer->checkSummary() << std::endl;
     std::stringstream ss;
     buffer->dump(ss);
     edm::LogInfo("SiStripFEDCheck") << ss.str();
       }
     }
     else {
       fillFatalError(fedId,0);
       //fill non-fatal errors histogram if there were no fatal errors
       fillNonFatalError(fedId,rateNonFatal);
       if (printDebug_ && rateNonFatal > 0) {
     if (!buffer.get()) buffer.reset(new sistrip::FEDBuffer(fedData.data(),fedData.size(),true));
     edm::LogInfo("SiStripFEDCheck") << "Non-fatal error with FED ID " << fedId 
                     << " for " << rateNonFatal << " of the channels. Check summary: " 
                     << std::endl << buffer->checkSummary() << std::endl;
     std::stringstream ss;
     buffer->dump(ss);
     edm::LogInfo("SiStripFEDCheck") << ss.str();
       }
 
     }
   }//loop over FED IDs
   
   //update histograms if needed
   doUpdateIfNeeded();
 }

void SiStripFEDCheckPlugin::bookHistograms	(	DQMStore::IBooker &	ibooker,
		edm::Run const &	run,
		edm::EventSetup const &	eSetup
	)

overrideprivatevirtual

Implements DQMEDAnalyzer.

Definition at line 250 of file SiStripFEDDataCheck.cc.

References DQMStore::IBooker::book1D(), dirName_, fedFatalErrors_, fedNonFatalErrors_, fedsPresent_, FEDNumbering::MAXSiStripFEDID, FEDNumbering::MINSiStripFEDID, MonitorElement::setAxisTitle(), and DQMStore::IBooker::setCurrentFolder().

 {
   //get FED IDs
   const unsigned int siStripFedIdMin = FEDNumbering::MINSiStripFEDID;
   const unsigned int siStripFedIdMax = FEDNumbering::MAXSiStripFEDID;
   //get DQM store
   ibooker.setCurrentFolder(dirName_);
   //book histograms
   fedsPresent_ = ibooker.book1D("FEDEntries",
                               "Number of times FED buffer is present in data",
                               siStripFedIdMax-siStripFedIdMin+1,
                               siStripFedIdMin-0.5,siStripFedIdMax+0.5);
   fedsPresent_->setAxisTitle("FED-ID",1);
   fedFatalErrors_ = ibooker.book1D("FEDFatal",
                               "Number of fatal errors in FED buffer",
                               siStripFedIdMax-siStripFedIdMin+1,
                               siStripFedIdMin-0.5,siStripFedIdMax+0.5);
   fedFatalErrors_->setAxisTitle("FED-ID",1);
   fedNonFatalErrors_ = ibooker.book1D("FEDNonFatal",
                               "Number of non fatal errors in FED buffer",
                               siStripFedIdMax-siStripFedIdMin+1,
                               siStripFedIdMin-0.5,siStripFedIdMax+0.5);
   fedNonFatalErrors_->setAxisTitle("FED-ID",1);
 }

void SiStripFEDCheckPlugin::doUpdateIfNeeded ( )

private

Definition at line 320 of file SiStripFEDDataCheck.cc.

References eventCount_, updateFrequency_, and updateHistograms().

Referenced by analyze().

 {
   eventCount_++;
   if (updateFrequency_ && (eventCount_%updateFrequency_ == 0)) {
     updateHistograms();
   }
 }

void SiStripFEDCheckPlugin::endRun ( void )

privatevirtual

Definition at line 277 of file SiStripFEDDataCheck.cc.

References updateHistograms().

 {
   updateHistograms();
 }

void SiStripFEDCheckPlugin::fillFatalError	(	unsigned int	fedId,
		bool	fatalError
	)

inlineprivate

Definition at line 301 of file SiStripFEDDataCheck.cc.

References fedFatalErrorBinContents_, fedFatalErrors_, MonitorElement::Fill(), and updateFrequency_.

Referenced by analyze().

 {
   if (updateFrequency_) {
     if (fatalError) fedFatalErrorBinContents_[fedId]++;
   } else {
     //fedFatalErrors_->Fill( fatalError ? 1 : 0 );
     if (fatalError) fedFatalErrors_->Fill(fedId);
   }
 }

void SiStripFEDCheckPlugin::fillNonFatalError	(	unsigned int	fedId,
		float	nonFatalError
	)

inlineprivate

Definition at line 311 of file SiStripFEDDataCheck.cc.

References fedNonFatalErrorBinContents_, fedNonFatalErrors_, MonitorElement::Fill(), and updateFrequency_.

Referenced by analyze().

 {
   if (updateFrequency_) {
     if (nonFatalError>0) fedNonFatalErrorBinContents_[fedId]++;//nonFatalError;
   } else {
     if (nonFatalError>0) fedNonFatalErrors_->Fill(fedId);
   }
 }

void SiStripFEDCheckPlugin::fillPresent	(	unsigned int	fedId,
		bool	present
	)

inlineprivate

Definition at line 293 of file SiStripFEDDataCheck.cc.

References fedsPresent_, fedsPresentBinContents_, MonitorElement::Fill(), and updateFrequency_.

Referenced by analyze().

 {
   if (present) {
     if (updateFrequency_) fedsPresentBinContents_[fedId]++;
     else fedsPresent_->Fill(fedId);
   }
 }

bool SiStripFEDCheckPlugin::hasFatalError	(	const FEDRawData &	fedData,
		unsigned int	fedId
	)		const

private

bool SiStripFEDCheckPlugin::hasNonFatalError	(	const FEDRawData &	fedData,
		unsigned int	fedId
	)		const

private

void SiStripFEDCheckPlugin::updateCabling ( const edm::EventSetup & eventSetup )

private

Definition at line 282 of file SiStripFEDDataCheck.cc.

References cabling_, cablingCacheId_, edm::EventSetup::get(), and edm::ESHandle< class >::product().

Referenced by analyze().

 {
   uint32_t currentCacheId = eventSetup.get<SiStripFedCablingRcd>().cacheIdentifier();
   if (cablingCacheId_ != currentCacheId) {
     edm::ESHandle<SiStripFedCabling> cablingHandle;
     eventSetup.get<SiStripFedCablingRcd>().get(cablingHandle);
     cabling_ = cablingHandle.product();
     cablingCacheId_ = currentCacheId;
   }
 }

void SiStripFEDCheckPlugin::updateHistograms ( )

private

Definition at line 328 of file SiStripFEDDataCheck.cc.

References newFWLiteAna::bin, fedFatalErrorBinContents_, fedFatalErrors_, fedNonFatalErrorBinContents_, fedNonFatalErrors_, fedsPresent_, fedsPresentBinContents_, MonitorElement::getTH1(), FEDNumbering::MAXSiStripFEDID, FEDNumbering::MINSiStripFEDID, and updateFrequency_.

Referenced by doUpdateIfNeeded(), and endRun().

 {
   //if the cache is not being used then do nothing
   if (!updateFrequency_) return;
   const unsigned int siStripFedIdMin = FEDNumbering::MINSiStripFEDID;
   const unsigned int siStripFedIdMax = FEDNumbering::MAXSiStripFEDID;
   unsigned int entriesFedsPresent = 0;
   unsigned int entriesFatalErrors = 0;
   unsigned int entriesNonFatalErrors = 0;
   for (unsigned int fedId = siStripFedIdMin, bin = 1; fedId < siStripFedIdMax+1; fedId++, bin++) {
     unsigned int fedsPresentBin = fedsPresentBinContents_[fedId];
     fedsPresent_->getTH1()->SetBinContent(bin,fedsPresentBin);
     entriesFedsPresent += fedsPresentBin;
     unsigned int fedFatalErrorsBin = fedFatalErrorBinContents_[fedId];
     fedFatalErrors_->getTH1()->SetBinContent(bin,fedFatalErrorsBin);
     entriesFatalErrors += fedFatalErrorsBin;
     unsigned int fedNonFatalErrorsBin = fedNonFatalErrorBinContents_[fedId];
     fedNonFatalErrors_->getTH1()->SetBinContent(bin,fedNonFatalErrorsBin);
     entriesNonFatalErrors += fedNonFatalErrorsBin;
   }
   fedsPresent_->getTH1()->SetEntries(entriesFedsPresent);
   fedFatalErrors_->getTH1()->SetEntries(entriesFatalErrors);
   fedNonFatalErrors_->getTH1()->SetEntries(entriesNonFatalErrors);
 }