L1TMonitor/interface/BxTiming.h

0001 #ifndef BxTiming_H
0002 #define BxTiming_H
0003
0004 /*\class BxTiming
0005  *\description common FED timing DQM module
0006  *\author N.Leonardo, A.Holzner, T.Christiansen, I.Mikulec
0007  *\date 08.03
0008  */
0009
0010 // system, common includes
0011 #include <memory>
0012 #include <string>
0013 #include "FWCore/ServiceRegistry/interface/Service.h"
0014 #include "FWCore/Framework/interface/Frameworkfwd.h"
0015 #include "FWCore/Framework/interface/Event.h"
0016 #include "FWCore/Framework/interface/MakerMacros.h"
0017 #include "FWCore/ParameterSet/interface/ParameterSet.h"
0018 #include "FWCore/MessageLogger/interface/MessageLogger.h"
0019 // dqm includes
0020 #include "DQMServices/Core/interface/DQMStore.h"
0021 //dataFormats
0022 #include "DataFormats/L1GlobalTrigger/interface/L1GlobalTriggerReadoutRecord.h"
0023 #include "DataFormats/FEDRawData/interface/FEDRawDataCollection.h"
0024 #include "DataFormats/FEDRawData/interface/FEDHeader.h"
0025 #include "DataFormats/FEDRawData/interface/FEDTrailer.h"
0026 #include "DataFormats/FEDRawData/interface/FEDNumbering.h"
0027 #include "DQMServices/Core/interface/DQMEDAnalyzer.h"
0028 #include "DataFormats/Provenance/interface/EventAuxiliary.h"
0029
0030 #define nfed_ FEDNumbering::MAXFEDID + 1
0031
0032 class BxTiming : public DQMEDAnalyzer {
0033 public:
0034   explicit BxTiming(const edm::ParameterSet&);
0035   ~BxTiming() override;
0036
0037 protected:
0038   void analyze(const edm::Event&, const edm::EventSetup&) override;
0039   void bookHistograms(DQMStore::IBooker& ibooker, edm::Run const&, edm::EventSetup const&) override;
0040
0041 private:
0042   // input
0043   edm::InputTag fedSource_;
0044   edm::EDGetTokenT<FEDRawDataCollection> fedSource_token_;
0045   edm::InputTag gtSource_;
0046   edm::EDGetTokenT<L1GlobalTriggerReadoutRecord> gtSource_token_;
0047
0048   // debug verbose level
0049   int verbose_;
0050   int verbose() { return verbose_; }
0051
0052   /** calculates the difference (closest distance) between two bunch crossing numbers.
0053       This is similar to calculating delta phi between two vectors.
0054
0055       Calculates bx1 - bx2 but makes sure that the value is in the range
0056         -num_bx_per_orbit / 2 .. + num_bx_per_orbit / 2 .
0057   */
0058   int calcBxDiff(int bx1, int bx2);
0059
0060   // counters
0061   int nEvt_;
0062
0063   // root output file name
0064   std::string histFile_;
0065
0066   // dqm histogram folder
0067   std::string histFolder_;
0068
0069   // running in filter farm? (use reduced set of me's)
0070   bool runInFF_;
0071
0072   // readout l1 systems
0073   static const int norb_ = 3564;            // bx per orbit
0074   static const int half_norb_ = norb_ / 2;  // for calculating the difference between two BX numbers
0075
0076   static const int nbig_ = 10000;  // larger than bx spread
0077   static const int nttype_ = 6;    // number of trigger types (physics, cal,...)
0078
0079   std::vector<int> listGtBits_;  // selected gt bit numbers for synch monitoring
0080
0081   enum nsys { NSYS = 10 };
0082   enum syslist { PS = 0, ETP, HTP, GCT, CTP, CTF, DTP, DTF, RPC, GLT };
0083   std::pair<int, int> fedRange_[NSYS];
0084   int fedRef_;  // reference fed
0085
0086   // bx spread counters
0087   static const int nspr_ = 3;  // delta, min, max
0088   int nBxDiff[nfed_][nspr_];
0089   int nBxOccy[nfed_][nspr_];
0090
0091   /// histograms
0092   MonitorElement* hBxDiffAllFed;        // bx shift wrt reference fed, for all feds
0093   MonitorElement* hBxDiffSysFed[NSYS];  // bx shift wrt reference fed, per subsystem
0094   MonitorElement* hBxOccyAllFed;        // bx occupancy, for all fed's
0095   MonitorElement** hBxOccyOneFed;       // bx occupancy, per each fed
0096
0097   MonitorElement* hBxDiffAllFedSpread[nspr_];  // bx shift wrt ref fed: mean shift, min, max
0098   MonitorElement* hBxOccyAllFedSpread[nspr_];  // bx occupancy: mean shift, min, max
0099
0100   MonitorElement* hBxOccyGtTrigType[nttype_];  // gt bx occupancy per trigger type
0101   MonitorElement** hBxOccyTrigBit[NSYS];       // subsystem bx occupancy per selected trigger bit
0102 };
0103
0104 #endif