SPYHistograms.h

Go to the documentation of this file.

#ifndef DQM_SiStripMonitorHardware_SPYHistograms_HH
#define DQM_SiStripMonitorHardware_SPYHistograms_HH

#include <sstream>

#include "FWCore/ParameterSet/interface/ParameterSet.h"

#include "DQMServices/Core/interface/DQMStore.h"

#include "DQM/SiStripMonitorHardware/interface/SiStripSpyUtilities.h"
#include "DQM/SiStripMonitorHardware/interface/HistogramBase.hh"

class SPYHistograms : public HistogramBase {
public:
  struct Trends {
    unsigned int meanDigitalLow;  // digitalLow averaged over all channels
  };

  struct ErrorCounters {
    unsigned int nNoData;     //max=min=0
    unsigned int nLowRange;   // max-min < min value to tune
    unsigned int nHighRange;  // max-min > max value to tune
    unsigned int nMinZero;    // min = 0
    unsigned int nMaxSat;     //max = 1023
    unsigned int nLowPb;      //min < min value to tune but > 0
    unsigned int nHighPb;     //max > max value to tune but < 1023
    unsigned int nOOS;        //header+trailer found with right distance between them but not in expected position
                              // or header found above 16 (no trailer found)
                              // or 2*2-high separated by 70 samples found (last in right position...)
    unsigned int nOtherPbs;
    unsigned int nAPVError;         //number of APVs with error bit 0
    unsigned int nAPVAddressError;  //number of APV pairs with different APV addresses
    unsigned int nNegPeds;          //ped subtr value = 0
  };

  //helper structs to fill histograms
  struct Errors {
    bool hasNoData;
    bool hasLowRange;
    bool hasHighRange;
    bool hasMinZero;
    bool hasMaxSat;
    bool hasLowPb;
    bool hasHighPb;
    bool hasOOS;
    bool hasOtherPbs;
    bool hasErrorBit0;
    bool hasErrorBit1;
    bool hasAPVAddressError0;
    bool hasAPVAddressError1;
    bool hasNegPeds;
  };

  SPYHistograms();

  ~SPYHistograms() override;

  //initialise histograms
  void initialise(const edm::ParameterSet& iConfig, std::ostringstream* pDebugStream) override;

  //book the top level histograms
  void bookTopLevelHistograms(DQMStore::IBooker&, const TkDetMap*);

  //book individual FED histograms or book all FED level histograms at once
  void bookFEDHistograms(DQMStore::IBooker&, const unsigned int fedId, const Errors& aErr, bool doAll = false);

  void bookAllFEDHistograms(DQMStore::IBooker&);

  void fillCountersHistograms(const ErrorCounters& aCounter, const double aTime);

  void fillGainHistograms(const Trends& aTrendElement, const double aTime);

  void fillFEDHistograms(const Errors& aErr, const unsigned int aFedId);

  void fillDetailedHistograms(const Errors& aErr,
                              const sistrip::SpyUtilities::Frame& aFrame,
                              const unsigned int aFedId,
                              const unsigned int aFedChannel);

  bool tkHistoMapEnabled(unsigned int aIndex = 0) override { return false; };

  TkHistoMap* tkHistoMapPointer(unsigned int aIndex = 0) override { return nullptr; };

protected:
private:
  //histos

  //counting histograms (histogram of number of problems per event)
  HistogramConfig nNoData_;
  HistogramConfig nLowRange_;
  HistogramConfig nHighRange_;
  HistogramConfig nMinZero_;
  HistogramConfig nMaxSat_;
  HistogramConfig nLowPb_;
  HistogramConfig nHighPb_;
  HistogramConfig nOutOfSync_;
  HistogramConfig nOtherPbs_;
  HistogramConfig nApvErrorBit_;
  HistogramConfig nApvAddressError_;
  HistogramConfig nNegativePeds_;

  //vsTime
  HistogramConfig nNoDatavsTime_;
  HistogramConfig nLowRangevsTime_;
  HistogramConfig nHighRangevsTime_;
  HistogramConfig nMinZerovsTime_;
  HistogramConfig nMaxSatvsTime_;
  HistogramConfig nLowPbvsTime_;
  HistogramConfig nHighPbvsTime_;
  HistogramConfig nOutOfSyncvsTime_;
  HistogramConfig nOtherPbsvsTime_;
  HistogramConfig nApvErrorBitvsTime_;
  HistogramConfig nApvAddressErrorvsTime_;
  HistogramConfig nNegativePedsvsTime_;
  HistogramConfig meanDigitalLowvsTime_;

  //top level histograms
  HistogramConfig noData_;
  HistogramConfig lowRange_;
  HistogramConfig highRange_;
  HistogramConfig minZero_;
  HistogramConfig maxSat_;
  HistogramConfig lowPb_;
  HistogramConfig highPb_;
  HistogramConfig outOfSync_;
  HistogramConfig otherPbs_;
  HistogramConfig apvErrorBit_;
  HistogramConfig apvAddressError_;
  HistogramConfig negativePeds_;

  HistogramConfig frameRange_;
  HistogramConfig frameMin_;
  HistogramConfig frameMax_;
  HistogramConfig baseline_;

  //FED level histograms
  HistogramConfig noDataDetailed_;
  HistogramConfig lowRangeDetailed_;
  HistogramConfig highRangeDetailed_;
  HistogramConfig minZeroDetailed_;
  HistogramConfig maxSatDetailed_;
  HistogramConfig lowPbDetailed_;
  HistogramConfig highPbDetailed_;
  HistogramConfig outOfSyncDetailed_;
  HistogramConfig otherPbsDetailed_;
  HistogramConfig apvErrorBitDetailed_;
  HistogramConfig apvAddressErrorDetailed_;
  HistogramConfig negativePedsDetailed_;

  HistogramConfig positionOfFirstHeaderBitDetailed_;
  HistogramConfig positionOfFirstTrailerBitDetailed_;
  HistogramConfig distanceHeaderTrailerDetailed_;

  std::map<unsigned int, MonitorElement*> noDataDetailedMap_;
  std::map<unsigned int, MonitorElement*> lowRangeDetailedMap_;
  std::map<unsigned int, MonitorElement*> highRangeDetailedMap_;
  std::map<unsigned int, MonitorElement*> minZeroDetailedMap_;
  std::map<unsigned int, MonitorElement*> maxSatDetailedMap_;
  std::map<unsigned int, MonitorElement*> lowPbDetailedMap_;
  std::map<unsigned int, MonitorElement*> highPbDetailedMap_;
  std::map<unsigned int, MonitorElement*> outOfSyncDetailedMap_;
  std::map<unsigned int, MonitorElement*> otherPbsDetailedMap_;
  std::map<unsigned int, MonitorElement*> apvErrorBitDetailedMap_;
  std::map<unsigned int, MonitorElement*> apvAddressErrorDetailedMap_;
  std::map<unsigned int, MonitorElement*> negativePedsDetailedMap_;

  std::map<unsigned int, MonitorElement*> positionOfFirstHeaderBitDetailedMap_;
  std::map<unsigned int, MonitorElement*> positionOfFirstTrailerBitDetailedMap_;
  std::map<unsigned int, MonitorElement*> distanceHeaderTrailerDetailedMap_;

  std::vector<bool> histosBooked_;

};  //class

#endif  //DQM_SiStripMonitorHardware_SPYHistograms_HH