LVL1::JetEnergyModuleKey Class Reference

The JetEnergyModuleKey object provides the key for each trigger tower depending on its eta-phi coords. More...

#include <JetEnergyModuleKey.h>

Inheritance diagram for LVL1::JetEnergyModuleKey:

Collaboration diagram for LVL1::JetEnergyModuleKey:

Public Types
enum	JEMRegion { MidJEM =0 , LeftEndJEM =1 , RightEndJEM =2 , JEMRegionERROR =999 }

Public Member Functions
	JetEnergyModuleKey ()
	constructs a JetEnergyModuleKey object
virtual	~JetEnergyModuleKey ()
unsigned int	jemKey (const xAOD::JetElement *jetElement)
	returns the key of the passed Coordinate
unsigned int	jemKey (unsigned int crate, unsigned int module)
	calculates key from crate and module index
std::vector< unsigned int >	jeKeys (unsigned int crate, unsigned int module)
	calculates keys of all JetElements in given crate and module
std::vector< Coordinate >	jeCoords (unsigned int crate, unsigned int module)
	returns coordinates of all JetElements in given crate and module
unsigned int	row (const Coordinate &coord) const
	returns the phi row of a coord within the JEM that contains it.
unsigned int	row (const xAOD::JetElement *jetElement) const
	returns the phi row of a coord within the JEM that contains it.
double	rowPhiCoord (unsigned int row, const Coordinate &jemCoord)
	returns the phi coord of the row of the JEM at the coordinates passed
virtual double	dPhi (const Coordinate &coord) const override
	height
virtual double	dEta (const Coordinate &coord) const override
	width
JEMRegion	region (const Coordinate &coord) const
	region
unsigned int	col (const Coordinate &coord)
	return row of passed coordinate
unsigned int	jem (const Coordinate &coord) const
	returns ID of JEP module (i.e.
virtual double	eta () const
	returns the centre of the TT at eta_coord:
virtual double	phi () const
	returns phi coordinate of centre of relevant trigger tower.
unsigned int	key (double phi, double eta)
	calculates a map key from passed phi, eta coordinates
unsigned int	key (const Coordinate &coord)
	returns the key of the passed Coordinate
Coordinate	coord () const
	return central coords of current key value.

Protected Member Functions
ICoordinate	convertCoordsToIntegers (double phi, double eta)
	converts the coordinates and corrects for overflows etc.
virtual int	sign (int temp) const
	returns -1 if temp is -ve and +1 if it is +ve.
virtual int	sign (double temp) const
	returns -1 if temp is -ve and +1 if it is +ve.
int	round (double a) const
	rounds number to nearest whole number
int	sharpRound (double a) const
	rounds number as follows (-1.0 to 0.0) -> -1, (0.0 to 1.0) -> 0, (1.0 to 2.0)->1 etc.
int	sharpRound2 (int a, int b) const
	divides a/b and returns a number as follows (where +b means +ve b): if 0
void	setupThisKeyValues ()

Protected Attributes
int	m_iphi
	integer phi coord
int	m_ieta
	integer eta coord
double	m_eta
	eta coordinate of key
double	m_phi
	phi coordinate of key
int	m_phiBin
	phi bin
int	m_etaBin
	eta bin
double	m_centralPhi
	this is the coordinate of the centre of the relevant trigger tower.
double	m_centralEta
	this is the coordinate of the centre of the relevant trigger tower.
bool	m_debug
	turns DEBUG code on and off

Private Member Functions
virtual BinAndCoord	calculateTriggerBin (const ICoordinate &iCoord) override
	converts integer phi, eta coordinates to phi, eta trigger bins, and central coords
void	setBins (const ICoordinate &iCoord, unsigned int &phiBin, int &etaBin)
	sets the eta and phi bins
unsigned int	midJEMEtaCol (const Coordinate &coord) const
	No descriptions.
unsigned int	leftEndJEMEtaCol (const Coordinate &coord) const
	returns eta row of JEMs 0, or 8
unsigned int	rightEndJEMEtaCol (const Coordinate &coord) const
	returns eta row of JEMs 7 or 15
unsigned int	phiQuadrant (const double phi) const
	returns the quadrant number associated with the phi coordinate, 0 - 90 = 0 90 - 180 = 1 180-270 = 2 270-360 = 3

Private Attributes
bool	m_debugModuleKey
	set to true to turn debugging info on

Detailed Description

The JetEnergyModuleKey object provides the key for each trigger tower depending on its eta-phi coords.

The key is an integer number that uniquely identifies each tower, and is needed by the STL map container: the map holds trigger towers and we retrieve them using their keys.

Author

Edward Moyse

Definition at line 35 of file JetEnergyModuleKey.h.

Member Enumeration Documentation

JEMRegion

enum LVL1::JetEnergyModuleKey::JEMRegion

Enumerator
MidJEM
LeftEndJEM
RightEndJEM
JEMRegionERROR

Definition at line 38 of file JetEnergyModuleKey.h.

                 {
    MidJEM=0,
    LeftEndJEM=1,
    RightEndJEM=2,
    JEMRegionERROR=999
  };

Constructor & Destructor Documentation

JetEnergyModuleKey()

LVL1::JetEnergyModuleKey::JetEnergyModuleKey

(

)

constructs a JetEnergyModuleKey object

Definition at line 36 of file JetEnergyModuleKey.cxx.

                                       : KeyUtilities(), m_debugModuleKey(false){
    if (m_debugModuleKey) std::cout << "JetEnergyModuleKey: m_debugModuleKey output turned on...."<<std::endl;
}

~JetEnergyModuleKey()

LVL1::JetEnergyModuleKey::~JetEnergyModuleKey ( )

virtual

Definition at line 40 of file JetEnergyModuleKey.cxx.

                                       {
}

Member Function Documentation

calculateTriggerBin()

LVL1::BinAndCoord LVL1::JetEnergyModuleKey::calculateTriggerBin ( const ICoordinate & iCoord )

overrideprivatevirtual

converts integer phi, eta coordinates to phi, eta trigger bins, and central coords

converts integer phi, eta coordinates to phi, eta trigger bins.

Returns coordinates of centre of JEs

Implements LVL1::KeyUtilities.

Definition at line 245 of file JetEnergyModuleKey.cxx.

                                                                                    {
//  double phiBinWidth=((2*M_PI)/64.0);
  int abs_ieta=abs(iCoord.eta() );
  int sign=( iCoord.eta() )/abs_ieta;
 
  int etaBin=0; unsigned int phiBin=0;
  setBins(iCoord,phiBin,etaBin);
 
  double centralPhi=( (static_cast<double>(phiBin))*TrigT1CaloDefs::jemPhiSize )
    + TrigT1CaloDefs::jemPhiSize*0.5;
  double centralEta=0.0;
  if ((etaBin>-4)&&(etaBin<4)){
    centralEta=(static_cast<double>(etaBin)*(TrigT1CaloDefs::jemEtaSize) )
      -(TrigT1CaloDefs::jemEtaSize)*sign*0.5;
  }else{
     centralEta=3.65*sign;//centre of end JEMs
  }
  if (m_debugModuleKey){
    std::cout << "JetEnergyModuleKey: start calcTrigBin"<<std::endl;
    std::cout << "phi, eta   : ("<<m_phi<<", "<<m_eta<<")"<<std::endl;
    std::cout << "iphi, ieta : ("<<( iCoord.phi() )<<", "<<( iCoord.eta() )<<")"<<std::endl;
    std::cout << "abs_ieta : ("<<abs_ieta<<" and sign :  "<<sign<<std::endl;
    std::cout << "central : ("<<centralPhi<<", "<<centralEta<<")"
        << "bin : ("<<phiBin<<","<<etaBin<<")"<<std::endl;
  }
 
  Coordinate centralCoords(centralPhi, centralEta);
  if (m_debugModuleKey) std::cout <<" JetEnergyModuleKey : created coord "<<centralCoords<<std::endl;
  return BinAndCoord(phiBin,etaBin,centralCoords);
}

col()

unsigned int LVL1::JetEnergyModuleKey::col

(

const Coordinate &

coord

)

return row of passed coordinate

Definition at line 213 of file JetEnergyModuleKey.cxx.

                                                                {
  switch (region(coord)){
    case MidJEM :
      return midJEMEtaCol(coord);
    case LeftEndJEM :
      return leftEndJEMEtaCol(coord);
    case RightEndJEM :
      return rightEndJEMEtaCol(coord);
    default:
      std::cerr << "JetEnergyModuleKey::etaColumn UNKNOWN REGION"<<std::endl;
  }
  return static_cast<unsigned int>(JEMRegionERROR);
}

convertCoordsToIntegers()

ICoordinate LVL1::KeyUtilities::convertCoordsToIntegers ( double phi, double eta )

protectedinherited

converts the coordinates and corrects for overflows etc.

For instance, if phi is negative this routine converts to the equivalent positive position.

For instance, if phi is negative this routine converts to the equivalent positive position. *todo tidy up a bit.

Definition at line 103 of file KeyUtilities.cxx.

                                                                       {
 
    double phiBinWidth=((2*M_PI)/64.0);
    // there are a maximum of 64 cells in the phi direction
    // stretching from 0 to ~2*PI.
    if (m_debug) std::cout << "KU : (phi, eta) ("<<phi<<","<<eta<<")"<<std::endl;
    int iphi=sharpRound(phi/phiBinWidth);
    int ieta=0;
 
    // Now check that m_iphi is between 0 and 64.
  iphi = iphi%64;
    if (iphi<0) iphi = 64+iphi;
 
    // Make m_ieta symmetrical:
    // o no cell at m_ieta=0
    // o first cells at +-1
    // o last cells at about +- 50
    // this gives us a more useful numerical symmetry.
 
    // So to get integer value we do:
    int temp_sign=sign(eta);
    double temp_abs=eta*temp_sign;
 
    double temp_double=(temp_abs*10.0+1.0)*temp_sign;
  if (m_debug) std::cout << "KU : temp_abs, temp_sign, temp_double : "<<temp_abs<<","<<temp_sign<<","<<temp_double<<std::endl;
//  if (m_eta>=0.0){
//    temp_double=m_eta*10.0+1.0;
//  }else{
//    temp_double=m_eta*10.0-1.0;
//  }
 
    ieta=static_cast<int>(temp_double);
    if (m_debug) std::cout << "KU : (iphi, ieta) ("<<iphi<<","<<ieta<<")"<<std::endl;
    return ICoordinate(iphi, ieta, eta);
}

coord()

LVL1::Coordinate LVL1::KeyUtilities::coord ( ) const

inherited

return central coords of current key value.

Definition at line 194 of file KeyUtilities.cxx.

                                            {
  return Coordinate(m_centralPhi,m_centralEta);
}

dEta()

double LVL1::JetEnergyModuleKey::dEta ( const Coordinate & coord ) const

overridevirtual

width

return width of JE

Implements LVL1::KeyUtilities.

Definition at line 174 of file JetEnergyModuleKey.cxx.

                                                            {
  if (region(coord) == MidJEM) return 0.8;
  if ((region(coord) == LeftEndJEM)||(region(coord) == RightEndJEM))
      return 2.5;//end JEMs cover 2.4-4.9
  return 0.0;
}

dPhi()

double LVL1::JetEnergyModuleKey::dPhi ( const Coordinate & coord ) const

overridevirtual

height

return height of JEM

Implements LVL1::KeyUtilities.

Definition at line 169 of file JetEnergyModuleKey.cxx.

                                                        {
  return M_PI/2;// one quadrant
}

eta()

double LVL1::KeyUtilities::eta ( ) const

virtualinherited

returns the centre of the TT at eta_coord:

returns the eta coord of the centre of the relevent trigger tower

Definition at line 142 of file KeyUtilities.cxx.

                                  {
  return m_centralEta;
}

jeCoords()

std::vector< Coordinate > LVL1::JetEnergyModuleKey::jeCoords	(	unsigned int	crate,
		unsigned int	module )

returns coordinates of all JetElements in given crate and module

returns coordinates of all JetElements in passed crate+module

Get keys for core JetElement locations in this module
Algorithm: start from bottom-left JetElement coordinate in JEM
Then step up by 8 elements in phi (4 in FCAL)
Increment eta and repeat
Do so for all 4 eta bins in JEM

Definition at line 79 of file JetEnergyModuleKey.cxx.

                                                                                          {
  std::vector<Coordinate> coords;
 
  // Protection
  if (crate > 1 || module > 15) return coords;

       
  int top = ( module < 8 ? 0 : 1 );
  double phiStart = crate*TrigT1CaloDefs::jemPhiSize
                  + 2.*top*TrigT1CaloDefs::jemPhiSize
                  + 0.5*TrigT1CaloDefs::Region0Height;
  double etaStart;
  // Central JEMs are easy
  if ( (module%8) > 0) {
    etaStart = (module%8)*TrigT1CaloDefs::jemEtaSize - 3.1;
  }
  // -ive eta end
  else {
    etaStart = -TrigT1CaloDefs::Region5EtaCentre;
  }
 
  // First coordinate for this JEM
  Coordinate startCol(phiStart, etaStart);
  // Nested incrementation of eta and phi
  CoordToHardware cth;
  JetElementKey get(0.,0.);
  while (cth.jepModule( startCol ) == module) {
    Coordinate next = get.getCentre(startCol);
    while (cth.jepCrate( next ) == crate) {
      coords.push_back(next);
      next = get.upPhi(next);
    }
    startCol = get.rightEta(startCol);
    if (startCol.eta() == TrigT1CaloDefs::RegionERROREtaCentre) break;
  }
  
  return coords;
}

jeKeys()

std::vector< unsigned int > LVL1::JetEnergyModuleKey::jeKeys	(	unsigned int	crate,
		unsigned int	module )

calculates keys of all JetElements in given crate and module

returns JetElementKeys of all JetElements in passed crate+module

Definition at line 59 of file JetEnergyModuleKey.cxx.

                                                                                          {
  std::vector<unsigned int> keys;
 
  // Protection
  if (crate > 1 || module > 15) return keys;
 
  // First get coordinates
  std::vector<Coordinate> coords = jeCoords(crate, module);
 
  // Then calculate keys
  JetElementKey get(0.,0.);
  for (const Coordinate& c : coords) {
    keys.push_back(get.jeKey(c));
  }
  
  return keys;
}

jem()

unsigned int LVL1::JetEnergyModuleKey::jem

(

const Coordinate &

coord

)

const

returns ID of JEP module (i.e.

Returns JEM number for coordinate.

JEM) There are 16 JEMS per crate, and 8 JEMS per quadrant. The central 6 JEMS cover the barrel, JEMs 0,7,8 & 15 extend over the FCAL as well. (each crate contains JEMS for opposite quadrants, so one crate might have JEMs 0-7 in quadrant 0 and JEMs 8-15 in quadrant 2)

Definition at line 228 of file JetEnergyModuleKey.cxx.

                                                                       {
  double min=3.2; double jemEtaWidth=0.8;
  unsigned int crateModifier=(phiQuadrant(coord.phi())/2);
  //=0 for quad 0&1, =1 for quad 2&3
 
  double temp = (coord.eta()+min)/jemEtaWidth;
  int jem = static_cast<int>(temp);
  jem=(jem < 0 ? 0 : jem);
  jem=(jem > 7 ? 7 : jem);
 
  jem+=(8*crateModifier);
  return static_cast<unsigned int>(jem);
}

jemKey() [1/2]

unsigned int LVL1::JetEnergyModuleKey::jemKey

(

const xAOD::JetElement *

jetElement

)

returns the key of the passed Coordinate

returns trigger tower key of passed Coordinate

Definition at line 44 of file JetEnergyModuleKey.cxx.

                                                                        {
  return key(jetElement->phi(), jetElement->eta());
}

jemKey() [2/2]

unsigned int LVL1::JetEnergyModuleKey::jemKey	(	unsigned int	crate,
		unsigned int	module )

calculates key from crate and module index

returns trigger tower key of passed crate+module

Definition at line 51 of file JetEnergyModuleKey.cxx.

                                                                               {
  double eta = ((module%8)+0.5)*TrigT1CaloDefs::jemEtaSize - 3.2;
  int quadrant = crate + ((module>7) ? 2 : 0);
  double phi = (quadrant+0.5)*TrigT1CaloDefs::jemPhiSize;
  return key(phi, eta);
}

key() [1/2]

unsigned int LVL1::KeyUtilities::key ( const Coordinate & coord )

inherited

returns the key of the passed Coordinate

returns trigger tower key of passed Coordinate

Definition at line 94 of file KeyUtilities.cxx.

                                                      {
  return key(coord.phi(), coord.eta());
}

key() [2/2]

unsigned int LVL1::KeyUtilities::key ( double phi, double eta )

inherited

calculates a map key from passed phi, eta coordinates

returns key

calculates a map key from passed phi, eta coordinates

Definition at line 77 of file KeyUtilities.cxx.

                                                      {
  m_eta=eta;
  m_phi=phi;
  ICoordinate iCoord = convertCoordsToIntegers(m_phi, m_eta);
  BinAndCoord bandc  = calculateTriggerBin(iCoord);
  if (m_debug) std::cout << "KU : key: got bandc "<<std::endl;
  m_phiBin=bandc.phiBin();
  m_etaBin=bandc.etaBin();
  m_centralPhi=bandc.coords().phi();
  m_centralEta=bandc.coords().eta();
  int temp=((m_etaBin+50)<<6) + m_phiBin;
 
  if (m_debug) std::cout << "KU : key: returning - "<<temp<<std::endl;
    return static_cast<unsigned int>(temp);
}

leftEndJEMEtaCol()

unsigned int LVL1::JetEnergyModuleKey::leftEndJEMEtaCol ( const Coordinate & coord ) const

private

returns eta row of JEMs 0, or 8

returns eta row of JEMs 0,7,8 or 15

Definition at line 293 of file JetEnergyModuleKey.cxx.

                                                                                  {
  // left hand end first
  JetElementKey get;
  switch (get.jeRegion( coord )){
    case JetElementKey::EndCap1 :
      return 3;
      break;
    case JetElementKey::EndCap2 :
      return 2;
      break;
    case JetElementKey::EndCap3 :
      return 1;
      break;
    case JetElementKey::FCAL :
      return 0;
      break;
    case JetElementKey::Barrel :
      // here to stop compiler warnings
      break;
    case JetElementKey::EndBarrel :
      // here to stop compiler warnings
      break;
  }          
  return static_cast<unsigned int>(JEMRegionERROR);
}

midJEMEtaCol()

unsigned int LVL1::JetEnergyModuleKey::midJEMEtaCol ( const Coordinate & coord ) const

private

No descriptions.

Definition at line 277 of file JetEnergyModuleKey.cxx.

                                                                              {
  double etaWidth=0.2;//only true for middle JEMS
  double JEMEtaSize=0.8;
//  unsigned int columnsPerJEM= 4;
  int etaBin=( jem(coord)%8)-4;//bins range from -4 to +3
  double etaMin=(etaBin*JEMEtaSize);
 
  double temp =(coord.eta()-etaMin)/etaWidth;
  int colNum=sharpRound(temp);
 
  colNum=(colNum < 0 ? 0 : colNum);//sorts out any rounding errors
  colNum=(colNum > 3 ? 3 : colNum);
 
  return colNum;
}

phi()

double LVL1::KeyUtilities::phi ( ) const

virtualinherited

returns phi coordinate of centre of relevant trigger tower.

returns phi coordinate of the centre of the relevent trigger tower.

Definition at line 151 of file KeyUtilities.cxx.

                                  {
  return m_centralPhi;
}

phiQuadrant()

unsigned int LVL1::JetEnergyModuleKey::phiQuadrant ( const double phi ) const

private

returns the quadrant number associated with the phi coordinate, 0 - 90 = 0 90 - 180 = 1 180-270 = 2 270-360 = 3

Definition at line 353 of file JetEnergyModuleKey.cxx.

                                                                       {
  double temp = phi/(M_PI/2);
  unsigned int quad =  static_cast<unsigned int>(temp);
  quad=(quad > 3 ? 0 : quad);
 
  return static_cast<unsigned int>(quad);
}

region()

LVL1::JetEnergyModuleKey::JEMRegion LVL1::JetEnergyModuleKey::region

(

const Coordinate &

coord

)

const

region

r

Definition at line 186 of file JetEnergyModuleKey.cxx.

                                                               {
  double absEta=fabs(coord.eta());
  if (absEta<=2.4) return MidJEM;
  if ((coord.eta()>2.4)&&(coord.eta()<=4.9))return RightEndJEM;
  if ((coord.eta()>=-4.9)&&(coord.eta()<-2.4))return LeftEndJEM;
  std::cerr << "JetEnergyModuleKey::region ... Unknown region!"<<std::endl
            << "Coordinate is ("<<coord.phi()<<", "<<coord.eta()<<")"
            <<std::endl;
  return JEMRegionERROR;
}

rightEndJEMEtaCol()

unsigned int LVL1::JetEnergyModuleKey::rightEndJEMEtaCol ( const Coordinate & coord ) const

private

returns eta row of JEMs 7 or 15

returns eta row of JEMs 0,7,8 or 15

Definition at line 320 of file JetEnergyModuleKey.cxx.

                                                                                   {
  // left hand end first
  JetElementKey get;
  switch (get.jeRegion( coord )){
    case JetElementKey::EndCap1 :
      return 0;
      break;
    case JetElementKey::EndCap2 :
      return 1;
      break;
    case JetElementKey::EndCap3 :
      return 2;
      break;
    case JetElementKey::FCAL :
      return 3;
      break;
    case JetElementKey::Barrel :
      // here to stop compiler warnings
      break;
    case JetElementKey::EndBarrel :
      // here to stop compiler warnings
      break;
  }
  return static_cast<unsigned int>(JEMRegionERROR);
}

round()

int LVL1::KeyUtilities::round ( double a ) const

protectedinherited

rounds number to nearest whole number

Definition at line 175 of file KeyUtilities.cxx.

                                          {
  return static_cast<int>(a<0.0?ceil(a-0.5):a>0.0?floor(a+0.5):0.0);
}

row() [1/2]

unsigned int LVL1::JetEnergyModuleKey::row

(

const Coordinate &

coord

)

const

returns the phi row of a coord within the JEM that contains it.

Used in energy trigger (JEM)

Definition at line 124 of file JetEnergyModuleKey.cxx.

                                                                     {
  double phi=coord.phi();
  double rowHeight=TrigT1CaloDefs::jemPhiSize/8.0;
 
  unsigned int rowsPerJEM = 8u;
  int rowNum=static_cast<int>(phi/rowHeight);
  rowNum=rowNum%rowsPerJEM;
  return rowNum;
}

row() [2/2]

unsigned int LVL1::JetEnergyModuleKey::row

(

const xAOD::JetElement *

JE

)

const

returns the phi row of a coord within the JEM that contains it.

Used in energy trigger (JEM)

Definition at line 136 of file JetEnergyModuleKey.cxx.

                                                                      {
  Coordinate coord(JE->phi(), JE->eta());
  return row( coord );
}

rowPhiCoord()

double LVL1::JetEnergyModuleKey::rowPhiCoord	(	unsigned int	row,
		const Coordinate &	jemCoord )

returns the phi coord of the row of the JEM at the coordinates passed

Definition at line 143 of file JetEnergyModuleKey.cxx.

                                                                                         {
  //not sure how to do this.
  //should really reuse code, but above is tied to KU stuff. Probably way to go though.
 
  ICoordinate iCoord = convertCoordsToIntegers(jemCoord.phi(), jemCoord.eta());
  int etaBin=0; unsigned int phiBin=0;
  setBins(iCoord,phiBin,etaBin);
  // now work out row coord.
 
  if (rowNum>7){
    std::cerr << "ERROR!!! JetEnergyModuleKey::rowPhiCoord exceeds allowed range. Row, "<<rowNum
         <<" will be set to zero"<<std::endl;
    rowNum=0;
  }
  double phi =( (static_cast<double>(phiBin))*TrigT1CaloDefs::jemPhiSize ); //bot of JEM
  phi+= static_cast<double>( rowNum )*0.2+0.1; //mid of row
  if (m_debugModuleKey){
    if ( (phi<(jemCoord.phi()-0.8))||(phi>(jemCoord.phi()+0.8) ) ){
    std::cerr << "ERROR!!! JetEnergyModuleKey::rowPhiCoord phi of row is "<<phi
         <<" in a JEM at ("<<jemCoord.phi()<<", "<<jemCoord.eta()<<")"<<std::endl;
    }//endif phi sensible
  }//endif debug
  return phi;
}

setBins()

void LVL1::JetEnergyModuleKey::setBins ( const ICoordinate & iCoord, unsigned int & phiBin, int & etaBin )

private

sets the eta and phi bins

Definition at line 200 of file JetEnergyModuleKey.cxx.

                                                                                                {
  unsigned int iPhiSize=16 ; // =PI/2 * 10
  phiBin=( iCoord.phi() )/(iPhiSize);
  int iEtaSize=8;// JEMs are 0.8 in eta, i.e ietaSize=8
  etaBin=sharpRound2(iCoord.eta(),iEtaSize);
  // the above calculation fails since end JEMs are larger, so ....
  etaBin=(etaBin < -4 ? -4 : etaBin); // etaBin=-5
  etaBin=(etaBin > 4 ? 4 : etaBin); //   belongs to the JEM in etaBin=-4
 
  return;
}

setupThisKeyValues()

void LVL1::KeyUtilities::setupThisKeyValues ( )

protectedinherited

Definition at line 165 of file KeyUtilities.cxx.

                                         {
  ICoordinate iCoord = convertCoordsToIntegers(m_phi, m_eta);
  BinAndCoord bandc  = calculateTriggerBin(iCoord);
  m_phiBin=bandc.phiBin();
  m_etaBin=bandc.etaBin();
  m_centralPhi=bandc.coords().phi();
  m_centralEta=bandc.coords().eta();
}

sharpRound()

int LVL1::KeyUtilities::sharpRound ( double a ) const

protectedinherited

rounds number as follows (-1.0 to 0.0) -> -1, (0.0 to 1.0) -> 0, (1.0 to 2.0)->1 etc.

Definition at line 180 of file KeyUtilities.cxx.

                                               {
  return static_cast<int>(a<0.0?(a-1.0):a>0.0?(a):0.0);
}

sharpRound2()

int LVL1::KeyUtilities::sharpRound2 ( int a, int b ) const

protectedinherited

divides a/b and returns a number as follows (where +b means +ve b): if 0

Definition at line 184 of file KeyUtilities.cxx.

                                                    {
  int temp=(abs(a)-1)/b+1;
  return temp*sign(a);
}

sign() [1/2]

int LVL1::KeyUtilities::sign ( double temp ) const

protectedvirtualinherited

returns -1 if temp is -ve and +1 if it is +ve.

returns 0 if temp =0

Definition at line 161 of file KeyUtilities.cxx.

                                           {
  return ((temp >= 0.0) ? 1 : -1);
}

sign() [2/2]

int LVL1::KeyUtilities::sign ( int temp ) const

protectedvirtualinherited

returns -1 if temp is -ve and +1 if it is +ve.

returns 0 if temp =0

Definition at line 156 of file KeyUtilities.cxx.

                                        {
  return ((temp >= 0) ? 1 : -1);
}

Member Data Documentation

m_centralEta

double LVL1::KeyUtilities::m_centralEta

protectedinherited

this is the coordinate of the centre of the relevant trigger tower.

Definition at line 112 of file KeyUtilities.h.

m_centralPhi

double LVL1::KeyUtilities::m_centralPhi

protectedinherited

this is the coordinate of the centre of the relevant trigger tower.

Definition at line 109 of file KeyUtilities.h.

m_debug

bool LVL1::KeyUtilities::m_debug

protectedinherited

turns DEBUG code on and off

Definition at line 114 of file KeyUtilities.h.

m_debugModuleKey

bool LVL1::JetEnergyModuleKey::m_debugModuleKey

private

set to true to turn debugging info on

Definition at line 100 of file JetEnergyModuleKey.h.

m_eta

double LVL1::KeyUtilities::m_eta

protectedinherited

eta coordinate of key

Definition at line 100 of file KeyUtilities.h.

m_etaBin

int LVL1::KeyUtilities::m_etaBin

protectedinherited

eta bin

Definition at line 106 of file KeyUtilities.h.

m_ieta

int LVL1::KeyUtilities::m_ieta

protectedinherited

integer eta coord

Definition at line 98 of file KeyUtilities.h.

m_iphi

int LVL1::KeyUtilities::m_iphi

protectedinherited

integer phi coord

Definition at line 96 of file KeyUtilities.h.

m_phi

double LVL1::KeyUtilities::m_phi

protectedinherited

phi coordinate of key

Definition at line 102 of file KeyUtilities.h.

m_phiBin

int LVL1::KeyUtilities::m_phiBin

protectedinherited

phi bin

Definition at line 104 of file KeyUtilities.h.

---

The documentation for this class was generated from the following files:

• JetEnergyModuleKey.h
• JetEnergyModuleKey.cxx