CSCMotherboard.h

Go to the documentation of this file.

#ifndef L1Trigger_CSCTriggerPrimitives_CSCMotherboard_h
#define L1Trigger_CSCTriggerPrimitives_CSCMotherboard_h
 
#include "L1Trigger/CSCTriggerPrimitives/interface/CSCAnodeLCTProcessor.h"
#include "L1Trigger/CSCTriggerPrimitives/interface/CSCCathodeLCTProcessor.h"
#include "DataFormats/CSCDigi/interface/CSCCorrelatedLCTDigi.h"
 
class CSCMotherboard : public CSCBaseboard {
public:
  CSCMotherboard(unsigned endcap,
                 unsigned station,
                 unsigned sector,
                 unsigned subsector,
                 unsigned chamber,
                 const edm::ParameterSet& conf);
 
  CSCMotherboard();
 
  ~CSCMotherboard() override = default;
 
  virtual void run(const CSCWireDigiCollection* wiredc, const CSCComparatorDigiCollection* compdc);
 
  virtual std::vector<CSCCorrelatedLCTDigi> readoutLCTs() const;
 
  std::vector<CSCCorrelatedLCTDigi> getLCTs() const;
 
  void clear();
 
  void setConfigParameters(const CSCDBL1TPParameters* conf);
 
  std::unique_ptr<CSCAnodeLCTProcessor> alctProc;
 
  std::unique_ptr<CSCCathodeLCTProcessor> clctProc;
 
  // VK: change to protected, to allow inheritance
protected:
  /* Containers for reconstructed ALCTs and CLCTs */
  std::vector<CSCALCTDigi> alctV;
  std::vector<CSCCLCTDigi> clctV;
 
  CSCCorrelatedLCTDigi firstLCT[CSCConstants::MAX_LCT_TBINS];
 
  CSCCorrelatedLCTDigi secondLCT[CSCConstants::MAX_LCT_TBINS];
 
  // helper function to return ALCT/CLCT with correct central BX
  CSCALCTDigi getBXShiftedALCT(const CSCALCTDigi&) const;
  CSCCLCTDigi getBXShiftedCLCT(const CSCCLCTDigi&) const;
 
  unsigned int mpc_block_me1a;
  unsigned int alct_trig_enable, clct_trig_enable, match_trig_enable;
  unsigned int match_trig_window_size, tmb_l1a_window_size;
 
  bool drop_used_alcts;
 
  bool drop_used_clcts;
 
  int early_tbins;
 
  bool readout_earliest_2;
 
  bool clct_to_alct;
 
  // encode special bits for high-multiplicity triggers
  unsigned int highMultiplicityBits_;
  bool useHighMultiplicityBits_;
 
  static const unsigned int def_mpc_block_me1a;
  static const unsigned int def_alct_trig_enable, def_clct_trig_enable;
  static const unsigned int def_match_trig_enable, def_match_trig_window_size;
  static const unsigned int def_tmb_l1a_window_size;
 
  /* quality control */
  std::unique_ptr<LCTQualityControl> qualityControl_;
 
  void checkConfigParameters();
 
  void correlateLCTs(const CSCALCTDigi& bestALCT,
                     const CSCALCTDigi& secondALCT,
                     const CSCCLCTDigi& bestCLCT,
                     const CSCCLCTDigi& secondCLCT,
                     int type);
 
  // This method calculates all the TMB words and then passes them to the
  // constructor of correlated LCTs.
  CSCCorrelatedLCTDigi constructLCTs(const CSCALCTDigi& aLCT, const CSCCLCTDigi& cLCT, int type, int trknmb) const;
 
  // CLCT pattern number: encodes the pattern number itself
  unsigned int encodePattern(const int clctPattern) const;
 
  // 4-bit LCT quality number.Made by TMB lookup tables and used for MPC sorting.
  enum class LCT_Quality : unsigned int {
    INVALID = 0,
    NO_CLCT = 1,
    NO_ALCT = 2,
    CLCT_LAYER_TRIGGER = 3,
    LOW_QUALITY = 4,
    MARGINAL_ANODE_CATHODE = 5,
    HQ_ANODE_MARGINAL_CATHODE = 6,
    HQ_CATHODE_MARGINAL_ANODE = 7,
    HQ_ACCEL_ALCT = 8,
    HQ_RESERVED_1 = 9,
    HQ_RESERVED_2 = 10,
    HQ_PATTERN_2_3 = 11,
    HQ_PATTERN_4_5 = 12,
    HQ_PATTERN_6_7 = 13,
    HQ_PATTERN_8_9 = 14,
    HQ_PATTERN_10 = 15
  };
 
  enum class LCT_QualityRun3 : unsigned int {
    INVALID = 0,
    LowQ = 1,
    MedQ = 2,
    HighQ = 3,
  };
 
  LCT_Quality findQuality(const CSCALCTDigi& aLCT, const CSCCLCTDigi& cLCT) const;
 
  LCT_QualityRun3 findQualityRun3(const CSCALCTDigi& aLCT, const CSCCLCTDigi& cLCT) const;
 
  void dumpConfigParams() const;
 
  /* encode high multiplicity bits for Run-3 exotic triggers */
  void encodeHighMultiplicityBits(unsigned alctBits);
};
#endif