L1MuGMTLFSortRankEtaQLUT Class Reference

#include <L1MuGMTLFSortRankEtaQLUT.h>

Inheritance diagram for L1MuGMTLFSortRankEtaQLUT:

Public Types
enum	{ DT, BRPC, CSC, FRPC }
Public Types inherited from L1MuGMTLUT
typedef std::pair< std::string, unsigned >	port

Public Member Functions
	L1MuGMTLFSortRankEtaQLUT ()
	constuctor using function-lookup More...
unsigned	LookupFunctionPacked (int idx, unsigned address) const override
	access to lookup function with packed input and output More...
unsigned	SpecificLookup (int idx, unsigned eta, unsigned q) const
	specific lookup function for entire output field More...
unsigned	SpecificLookup_rank_etaq (int idx, unsigned eta, unsigned q) const
	specific lookup function for rank_etaq More...
unsigned	SpecificLookup_vlq (int idx, unsigned eta, unsigned q) const
	specific lookup function for vlq More...
	~L1MuGMTLFSortRankEtaQLUT () override
	destructor More...
Public Member Functions inherited from L1MuGMTLUT
	L1MuGMTLUT ()
	Init and Destruct. More...
	L1MuGMTLUT (const char *name, const std::vector< std::string > &instances, const std::vector< port > &in_widths, const std::vector< port > &out_widths, unsigned vme_addr_width=0, bool distrRAM=false)
	constructor with init More...
	L1MuGMTLUT (const char *name, const std::string &instances, const std::string &inputs, const std::string &outputs, unsigned vme_addr_width=0, bool distrRAM=false)
void	Load (const char *path)
	I/O functions. More...
std::vector< unsigned >	Lookup (int idx, const std::vector< unsigned > &address) const
	additional lookup function (std::vector -> vector) More...
std::vector< unsigned >	Lookup (int idx, unsigned address) const
	additional lookup function (unsigned -> std::vector) More...
unsigned	LookupPacked (int idx, unsigned) const
unsigned	LookupPacked (int idx, const std::vector< unsigned > &address) const
	additional lookup function (std::vector -> unisgned) More...
void	MakeSubClass (const char *fname="", const char *template_file_h="../interface/L1MuGMTLUT_SubClass.h_template", const char *template_file_cc="../interface/L1MuGMTLUT_SubClass.cc_template")
	Add Generate SubClass method. More...
std::string	Name ()
int	numberOfInstances ()
	get the number of Instances More...
void	Save (const char *path)
	save to LUT file More...
virtual	~L1MuGMTLUT ()
	destructor More...

Private Member Functions
void	InitParameters ()
	Initialize scales, configuration parameters, alignment constants, ... More...
unsigned	TheLookupFunction (int idx, unsigned eta, unsigned q) const
	The lookup function - here the functionality of the LUT is implemented. More...

Private Attributes
unsigned	m_version
	Private data members (LUT parameters);. More...

Additional Inherited Members
Protected Member Functions inherited from L1MuGMTLUT
void	Init (const char *name, const std::vector< std::string > &instances, const std::vector< port > &in_widths, const std::vector< port > &out_widths, unsigned vme_addr_width=0, bool distrRAM=false)
	Initialize the LUT. More...
void	Set (int idx, unsigned address, unsigned value)
	set with single address and value More...
std::vector< unsigned >	u2vec (unsigned value, const std::vector< port > &widths) const
	generate composite address or value from compact unsigned More...
unsigned	vec2u (const std::vector< unsigned > &vec, const std::vector< port > &widths) const
	generate address or value from composite address or value More...
Protected Attributes inherited from L1MuGMTLUT
std::vector< std::vector< unsigned > >	m_Contents
bool	m_distrRAM
unsigned	m_GeneralLUTVersion
bool	m_initialized
std::vector< port >	m_Inputs
std::vector< std::string >	m_InstNames
std::string	m_name
int	m_NLUTS
std::vector< port >	m_Outputs
bool	m_saveFlag
unsigned	m_TotalInWidth
unsigned	m_TotalOutWidth
bool	m_UseLookupFunction
unsigned	m_vme_addr_width

Detailed Description

LFSortRankEtaQ look-up table

this class was automatically generated by L1MuGMTLUT::MakeSubClass()

Definition at line 38 of file L1MuGMTLFSortRankEtaQLUT.h.

Member Enumeration Documentation

anonymous enum

Enumerator
DT
BRPC
CSC
FRPC

Definition at line 40 of file L1MuGMTLFSortRankEtaQLUT.h.

{ DT, BRPC, CSC, FRPC };

Constructor & Destructor Documentation

L1MuGMTLFSortRankEtaQLUT::L1MuGMTLFSortRankEtaQLUT ( )

inline

constuctor using function-lookup

Definition at line 43 of file L1MuGMTLFSortRankEtaQLUT.h.

References InitParameters().

      : L1MuGMTLUT("LFSortRankEtaQ", "DT BRPC CSC FRPC", "eta(6) q(3)", "vlq(2) rank_etaq(2)", 7, false) {
    InitParameters();
  };

L1MuGMTLFSortRankEtaQLUT::~L1MuGMTLFSortRankEtaQLUT ( )

inlineoverride

destructor

Definition at line 49 of file L1MuGMTLFSortRankEtaQLUT.h.

{};

Member Function Documentation

void L1MuGMTLFSortRankEtaQLUT::InitParameters ( )

private

Initialize scales, configuration parameters, alignment constants, ...

Definition at line 35 of file L1MuGMTLFSortRankEtaQLUT.cc.

References L1MuGMTConfig::getVersionSortRankEtaQLUT(), and m_version.

Referenced by L1MuGMTLFSortRankEtaQLUT(), and LookupFunctionPacked().

{ m_version = L1MuGMTConfig::getVersionSortRankEtaQLUT(); }

unsigned L1MuGMTLFSortRankEtaQLUT::LookupFunctionPacked ( int  idx, unsigned  address  ) const

inlineoverridevirtual

access to lookup function with packed input and output

Reimplemented from L1MuGMTLUT.

Definition at line 77 of file L1MuGMTLFSortRankEtaQLUT.h.

References generateTowerEtThresholdLUT::addr, PVValHelper::eta, training_settings::idx, InitParameters(), L1MuGMTLUT::m_Inputs, data-class-funcs::q, TheLookupFunction(), and L1MuGMTLUT::u2vec().

                                                                          {
    std::vector<unsigned> addr = u2vec(address, m_Inputs);
    return TheLookupFunction(idx, addr[0], addr[1]);
  };

unsigned L1MuGMTLFSortRankEtaQLUT::SpecificLookup ( int  idx, unsigned  eta, unsigned  q  ) const

inline

specific lookup function for entire output field

Definition at line 68 of file L1MuGMTLFSortRankEtaQLUT.h.

References generateTowerEtThresholdLUT::addr, PVValHelper::eta, L1MuGMTLUT::LookupPacked(), and data-class-funcs::q.

                                                                   {
    std::vector<unsigned> addr(2);
    addr[0] = eta;
    addr[1] = q;
    return LookupPacked(idx, addr);
  };

unsigned L1MuGMTLFSortRankEtaQLUT::SpecificLookup_rank_etaq ( int  idx, unsigned  eta, unsigned  q  ) const

inline

specific lookup function for rank_etaq

Definition at line 60 of file L1MuGMTLFSortRankEtaQLUT.h.

References generateTowerEtThresholdLUT::addr, PVValHelper::eta, L1MuGMTLUT::Lookup(), and data-class-funcs::q.

Referenced by L1MuGMTSortRankUnit::sort_rank().

                                                                             {
    std::vector<unsigned> addr(2);
    addr[0] = eta;
    addr[1] = q;
    return Lookup(idx, addr)[1];
  };

unsigned L1MuGMTLFSortRankEtaQLUT::SpecificLookup_vlq ( int  idx, unsigned  eta, unsigned  q  ) const

inline

specific lookup function for vlq

Definition at line 52 of file L1MuGMTLFSortRankEtaQLUT.h.

References generateTowerEtThresholdLUT::addr, PVValHelper::eta, L1MuGMTLUT::Lookup(), and data-class-funcs::q.

Referenced by L1MuGMTSortRankUnit::getVeryLowQualityLevel().

                                                                       {
    std::vector<unsigned> addr(2);
    addr[0] = eta;
    addr[1] = q;
    return Lookup(idx, addr)[0];
  };

unsigned L1MuGMTLFSortRankEtaQLUT::TheLookupFunction ( int  idx, unsigned  eta, unsigned  q  ) const

private

The lookup function - here the functionality of the LUT is implemented.

Definition at line 82 of file L1MuGMTLFSortRankEtaQLUT.cc.

References L1MuScale::getCenter(), L1MuGMTConfig::getDoOvlRpcAnd(), L1MuTriggerScales::getRegionalEtaScale(), L1MuGMTConfig::getTriggerScales(), GeomDetEnumerators::isRPC(), and m_version.

Referenced by LookupFunctionPacked().

                                                                                            {
  // idx is DT, BRPC, CSC, FRPC
  // INPUTS:  eta(6) q(3)
  // OUTPUTS: vlq(2) rank_etaq(2)

  const L1MuTriggerScales* theTriggerScales = L1MuGMTConfig::getTriggerScales();

  int isRPC = idx % 2;
  //  int isFWD = idx / 2;

  float etaValue = fabs(theTriggerScales->getRegionalEtaScale(idx)->getCenter(eta));

  //
  // very-low-quality flags
  //
  // 0 .. no VLQ set
  // 1 .. output muon will be quality 2 (disable in single and di-muon trigger)
  // 2 .. output muon will be quality 3 (disable in single-muon trigger only)
  // 3 .. output muon will be quality 4 (disable in di-muon trigger only)

  unsigned vlq = 0;

  int vCSC2 = (m_version)&0xf;
  int vCSC1 = (m_version >> 4) & 0xf;
  int vRPC = (m_version >> 8) & 0xf;

  // RPC selection
  if (isRPC) {
    if (vRPC == 0) {
      if ((q == 0 && ((etaValue > 1.04 && etaValue < 1.24) ||  // Q0, high rate, high noise
                      (etaValue > 1.48))) ||                   // Q0, high rate, high noise
          (q == 1 && ((etaValue > 0.83 && etaValue < 1.04) ||  // Q1, high rate
                      (etaValue > 1.14 && etaValue < 1.24) ||  // Q1, high noise
                      (etaValue > 1.36))) ||                   // Q1, high rate
          (q == 2 && (etaValue > 0.83 && etaValue < 0.93)))    // Q2, high rate
        vlq = 1;
    }
    // reserve vRPC == 1 for doing nothing for bwd compatibility
    if (vRPC == 2) {
      if (q == 0 && etaValue > 1.04)
        vlq = 2;
    }
    if (vRPC == 3) {
      if (q == 0)
        vlq = 2;
    }
    if (vRPC == 4) {
      if (q == 0 && etaValue > 1.04)
        vlq = 1;
    }
    if (vRPC == 5) {
      if (q == 0)
        vlq = 1;
    }
  }

  // CSC selection
  if (idx == 2) {  // CSC
    if (q == 2) {
      if (vCSC2 == 1)
        vlq = 2;
      if (vCSC2 == 2) {
        if (etaValue < 1.5 || etaValue > 1.8)
          vlq = 2;  // disable in single-muon trigger only
      }
      if (vCSC2 == 3) {
        if ((etaValue > 1.2 && etaValue < 1.5) || etaValue > 1.8)
          vlq = 2;  // disable in single-muon trigger only
      }
    }

    if (q == 1) {
      if (vCSC1 == 0) {
        if (etaValue > 1.2)
          vlq = 2;  // disable in single-muon trigger only
      }
      if (vCSC1 == 1) {
        if (etaValue > 1.3)
          vlq = 2;  // disable in single-muon trigger only
      }
    }
  }

  if (L1MuGMTConfig::getDoOvlRpcAnd()) {
    if (idx == 0) {  // DT
      if (etaValue > 0.91)
        vlq = 1;
    }
    if (idx == 2) {  // CSC
      if (etaValue < 1.06)
        vlq = 1;
    }
  }

  //
  // Rank contribution from eta and quality
  //

  // by default return maximum
  // LUT can later be used to reduce the sort rank of certain regions
  unsigned rank_etaq = 3;

  return (vlq << 2) | rank_etaq;
}

Member Data Documentation

unsigned L1MuGMTLFSortRankEtaQLUT::m_version

private

Private data members (LUT parameters);.

Definition at line 90 of file L1MuGMTLFSortRankEtaQLUT.h.

Referenced by InitParameters(), and TheLookupFunction().