l1t::EnergySumCondition Class Reference

#include <EnergySumCondition.h>

Inheritance diagram for l1t::EnergySumCondition:

Public Member Functions
	EnergySumCondition ()
	EnergySumCondition (const GtCondition *, const GtBoard *)
	from base template condition (from event setup usually) More...
	EnergySumCondition (const EnergySumCondition &)
const bool	evaluateCondition (const int bxEval) const
	the core function to check if the condition matches More...
const GtBoard *	getuGtB () const
	get / set the pointer to uGt GtBoard More...
const EnergySumTemplate *	gtEnergySumTemplate () const
	get / set the pointer to a L1GtCondition More...
EnergySumCondition &	operator= (const EnergySumCondition &)
void	print (std::ostream &myCout) const
	print condition More...
void	setGtEnergySumTemplate (const EnergySumTemplate *)
void	setuGtB (const GtBoard *)
	set the pointer to uGT GtBoard More...
virtual	~EnergySumCondition ()
Public Member Functions inherited from l1t::ConditionEvaluation
	ConditionEvaluation ()
	constructor More...
bool	condLastResult () const
	get the latest result for the condition More...
int	condMaxNumberObjects () const
void	evaluateConditionStoreResult (const int bxEval)
	call evaluateCondition and save last result More...
CombinationsInCond const &	getCombinationsInCond () const
	get all the object combinations evaluated to true in the condition More...
virtual std::string	getNumericExpression () const
	get numeric expression More...
void	setCondMaxNumberObjects (int condMaxNumberObjectsValue)
void	setVerbosity (const int verbosity)
virtual	~ConditionEvaluation ()
	destructor More...

Private Member Functions
void	copy (const EnergySumCondition &cp)
	copy function for copy constructor and operator= More...

Private Attributes
const EnergySumTemplate *	m_gtEnergySumTemplate
	pointer to a EnergySumTemplate More...
const GtBoard *	m_uGtB
	pointer to uGt GtBoard, to be able to get the trigger objects More...

Additional Inherited Members
Protected Member Functions inherited from l1t::ConditionEvaluation
template<class Type1 >
const bool	checkBit (const Type1 &mask, const unsigned int bitNumber) const
	check if a bit with a given number is set in a mask More...
template<class Type1 >
const bool	checkRangeDeltaEta (const unsigned int obj1Eta, const unsigned int obj2Eta, const Type1 &lowerR, const Type1 &upperR, const unsigned int nEtaBits) const
	check if a value is in a given range More...
template<class Type1 >
const bool	checkRangeDeltaPhi (const unsigned int obj1Phi, const unsigned int obj2Phi, const Type1 &lowerR, const Type1 &upperR) const
	check if a value is in a given range More...
template<class Type1 >
const bool	checkRangeEta (const unsigned int bitNumber, const Type1 &beginR, const Type1 &endR, const Type1 &beginVetoR, const Type1 &endVetoR, const unsigned int nEtaBits) const
	check if a value is in a given range and outside of a veto range More...
template<class Type1 >
const bool	checkRangePhi (const unsigned int bitNumber, const Type1 &beginR, const Type1 &endR, const Type1 &beginVetoR, const Type1 &endVetoR) const
	check if a value is in a given range and outside of a veto range More...
template<class Type1 , class Type2 >
const bool	checkThreshold (const Type1 &threshold, const Type2 &value, bool condGEqValue) const
CombinationsInCond &	combinationsInCond () const
	get all the object combinations (to fill it...) More...
Protected Attributes inherited from l1t::ConditionEvaluation
CombinationsInCond	m_combinationsInCond
	store all the object combinations evaluated to true in the condition More...
bool	m_condLastResult
	the last result of evaluateCondition() More...
int	m_condMaxNumberObjects
int	m_verbosity
	verbosity level More...

Detailed Description

Definition at line 37 of file EnergySumCondition.h.

Constructor & Destructor Documentation

EnergySumCondition::EnergySumCondition

(

)

constructors default

Definition at line 49 of file EnergySumCondition.cc.

                                          :
    ConditionEvaluation() {

    //empty

}

EnergySumCondition::EnergySumCondition	(	const GtCondition *	eSumTemplate,
		const GtBoard *	ptrGTB
	)

from base template condition (from event setup usually)

Definition at line 57 of file EnergySumCondition.cc.

References l1t::ConditionEvaluation::m_condMaxNumberObjects.

                                                                                                :
    ConditionEvaluation(),
    m_gtEnergySumTemplate(static_cast<const EnergySumTemplate*>(eSumTemplate)),
    m_uGtB(ptrGTB)

{

    // maximum number of objects received for the evaluation of the condition
    // energy sums are global quantities - one object per event

    m_condMaxNumberObjects = 1;

}

EnergySumCondition::EnergySumCondition

(

const EnergySumCondition &

cp

)

Definition at line 85 of file EnergySumCondition.cc.

References copy().

                                                                         :
    ConditionEvaluation() {

    copy(cp);

}

EnergySumCondition::~EnergySumCondition ( )

virtual

Definition at line 93 of file EnergySumCondition.cc.

                                           {

    // empty

}

Member Function Documentation

void EnergySumCondition::copy ( const EnergySumCondition &  cp )

private

copy function for copy constructor and operator=

Definition at line 72 of file EnergySumCondition.cc.

References l1t::ConditionEvaluation::condLastResult(), l1t::ConditionEvaluation::condMaxNumberObjects(), l1t::ConditionEvaluation::getCombinationsInCond(), getuGtB(), gtEnergySumTemplate(), and l1t::ConditionEvaluation::m_verbosity.

Referenced by EnergySumCondition().

                                                                {

    m_gtEnergySumTemplate = cp.gtEnergySumTemplate();
    m_uGtB = cp.getuGtB();

    m_condMaxNumberObjects = cp.condMaxNumberObjects();
    m_condLastResult = cp.condLastResult();
    m_combinationsInCond = cp.getCombinationsInCond();

    m_verbosity = cp.m_verbosity;

}

const bool EnergySumCondition::evaluateCondition ( const int  bxEval ) const

virtual

the core function to check if the condition matches

Implements l1t::ConditionEvaluation.

Definition at line 121 of file EnergySumCondition.cc.

References BXVector< T >::at(), hitfit::clear(), ETM, ETT, EnergySumTemplate::ObjectParameter::etThreshold, BXVector< T >::getLastBX(), l1t::EtSum::getType(), HTM, HTT, l1t::L1Candidate::hwPhi(), l1t::L1Candidate::hwPt(), LogDebug, EnergySumTemplate::ObjectParameter::phiWindowLower, EnergySumTemplate::ObjectParameter::phiWindowUpper, EnergySumTemplate::ObjectParameter::phiWindowVetoLower, and BXVector< T >::size().

                                                                          {

    // number of trigger objects in the condition
    // in fact, there is only one object
    int iCondition = 0;

    // condition result condResult set to true if the energy sum
    // passes all requirements
    bool condResult = false;

    // store the indices of the calorimeter objects
    // from the combination evaluated in the condition
    SingleCombInCond objectsInComb;

    // clear the m_combinationsInCond vector
    (combinationsInCond()).clear();

    // clear the indices in the combination
    objectsInComb.clear();

    const BXVector<const l1t::EtSum*>* candVec = m_uGtB->getCandL1EtSum();

    // Look at objects in bx = bx + relativeBx
    int useBx = bxEval + m_gtEnergySumTemplate->condRelativeBx();

    int numberObjects = candVec->size(useBx);
    if (numberObjects < 1) {
        return false;
    }

    // Fail condition if attempting to get Bx outside of range
    if( ( useBx < candVec->getFirstBX() ) ||
    ( useBx > candVec->getLastBX() ) ) {
      return false;
    }


    l1t::EtSum::EtSumType type;
    bool MissingEnergy = false;
    switch( (m_gtEnergySumTemplate->objectType())[0] ){
    case ETM:
      type = l1t::EtSum::EtSumType::kMissingEt;
      MissingEnergy = true;
      break;
    case ETT:
      type = l1t::EtSum::EtSumType::kTotalEt;
      MissingEnergy = false;
      break;
    case HTM:
      type = l1t::EtSum::EtSumType::kMissingHt;
      MissingEnergy = true;
      break;
    case HTT:
      type = l1t::EtSum::EtSumType::kTotalHt;
      MissingEnergy = false;
      break;
    default:
      edm::LogError("l1t|Global")
    << "\n  Error: "
    << "Unmatched object type from template to EtSumType, (m_gtEnergySumTemplate->objectType())[0] = "
    << (m_gtEnergySumTemplate->objectType())[0]
    << std::endl;
      type = l1t::EtSum::EtSumType::kTotalEt;
      break;
    }


    // get energy, phi (ETM and HTM) and overflow for the trigger object
    unsigned int candEt = 0;
    unsigned int candPhi = 0;
    bool candOverflow = false;
    for( int iEtSum = 0; iEtSum < numberObjects; ++iEtSum ){
      l1t::EtSum cand = *(candVec->at(useBx,iEtSum));
      if( cand.getType() != type ) continue;
      candEt  = cand.hwPt();
      candPhi = cand.hwPhi();
    }


    const EnergySumTemplate::ObjectParameter objPar =
        ( *(m_gtEnergySumTemplate->objectParameter()) )[iCondition];

    // check energy threshold and overflow
    // overflow evaluation:
    //     for condGEq >=
    //         candidate overflow true -> condition true
    //         candidate overflow false -> evaluate threshold
    //     for condGEq =
    //         candidate overflow true -> condition false
    //         candidate overflow false -> evaluate threshold
    //

    bool condGEqVal = m_gtEnergySumTemplate->condGEq();

    // check energy threshold
    if ( !checkThreshold(objPar.etThreshold, candEt, condGEqVal) ) {
      LogDebug("l1t|Global") << "\t\t l1t::EtSum failed checkThreshold" << std::endl;
        return false;
    }

    if( !condGEqVal && candOverflow ) return false;

    // for ETM and HTM check phi also
    // for overflow, the phi requirements are ignored
    if( MissingEnergy ){
      // check phi
      if( !checkRangePhi(candPhi, objPar.phiWindowLower, objPar.phiWindowUpper, objPar.phiWindowVetoLower, objPar.phiWindowVetoLower) ){
    LogDebug("l1t|Global") << "\t\t l1t::EtSum failed checkRange(phi)" << std::endl;
    return false;
      }
    }


    // index is always zero, as they are global quantities (there is only one object)
    int indexObj = 0;

    objectsInComb.push_back(indexObj);
    (combinationsInCond()).push_back(objectsInComb);

    // if we get here all checks were successfull for this combination
    // set the general result for evaluateCondition to "true"

    condResult = true;
    return condResult;

}

const GtBoard* l1t::EnergySumCondition::getuGtB ( ) const

inline

get / set the pointer to uGt GtBoard

Definition at line 76 of file EnergySumCondition.h.

References m_uGtB.

Referenced by copy().

                                          {
        return m_uGtB;
    }

const EnergySumTemplate* l1t::EnergySumCondition::gtEnergySumTemplate ( ) const

inline

get / set the pointer to a L1GtCondition

Definition at line 69 of file EnergySumCondition.h.

References m_gtEnergySumTemplate.

Referenced by copy().

                                                                {
        return m_gtEnergySumTemplate;
    }

l1t::EnergySumCondition & EnergySumCondition::operator=

(

const EnergySumCondition &

cp

)

Definition at line 100 of file EnergySumCondition.cc.

References filterCSVwithJSON::copy.

{
    copy(cp);
    return *this;
}

void EnergySumCondition::print ( std::ostream &  myCout ) const

virtual

print condition

Reimplemented from l1t::ConditionEvaluation.

Definition at line 248 of file EnergySumCondition.cc.

References l1t::ConditionEvaluation::print().

Referenced by l1t::GtBoard::runGTL().

                                                          {

    m_gtEnergySumTemplate->print(myCout);
    ConditionEvaluation::print(myCout);

}

void EnergySumCondition::setGtEnergySumTemplate

(

const EnergySumTemplate *

eSumTempl

)

Definition at line 107 of file EnergySumCondition.cc.

                                                                                     {

    m_gtEnergySumTemplate = eSumTempl;

}

void EnergySumCondition::setuGtB

(

const GtBoard *

ptrGTB

)

set the pointer to uGT GtBoard

Definition at line 114 of file EnergySumCondition.cc.

                                                         {

    m_uGtB = ptrGTB;

}

Member Data Documentation

const EnergySumTemplate* l1t::EnergySumCondition::m_gtEnergySumTemplate

private

pointer to a EnergySumTemplate

Definition at line 90 of file EnergySumCondition.h.

Referenced by gtEnergySumTemplate().

const GtBoard* l1t::EnergySumCondition::m_uGtB

private

pointer to uGt GtBoard, to be able to get the trigger objects

Definition at line 93 of file EnergySumCondition.h.

Referenced by getuGtB().