HGCRecHit Class Reference

#include <HGCRecHit.h>

Inheritance diagram for HGCRecHit:

Public Types
enum	Flags {   kGood =0, kPoorReco, kOutOfTime, kFaultyHardware,   kNoisy, kPoorCalib, kSaturated, kDead,   kKilled, kWeird, kDiWeird, kUnknown }
enum	HGCbheFlags {   kHGCbheGood, kHGCbheDead, kHGCbheHot, kHGCbhePassBX,   kHGCbheSaturated }
enum	HGCfheFlags {   kHGCfheGood, kHGCfheDead, kHGCfheHot, kHGCfhePassBX,   kHGCfheSaturated }
typedef DetId	key_type

Public Member Functions
bool	checkFlag (int flag) const
	check if the flag is true More...
bool	checkFlags (const std::vector< int > &flagsvec) const
	check if one of the flags in a set is true More...
float	chi2 () const
	HGCRecHit ()
	HGCRecHit (const DetId &id, float energy, float time, uint32_t flags=0, uint32_t flagBits=0)
DetId	id () const
	get the id More...
bool	isTimeErrorValid () const
bool	isTimeValid () const
float	outOfTimeChi2 () const
float	outOfTimeEnergy () const
void	setChi2 (float chi2)
void	setFlag (int flag)
	set the flags (from Flags or ESFlags) More...
void	setOutOfTimeChi2 (float chi2)
void	setOutOfTimeEnergy (float energy)
void	setTimeError (uint8_t timeErrBits)
float	timeError () const
void	unsetFlag (int flag)
Public Member Functions inherited from CaloRecHit
uint32_t	aux () const
	CaloRecHit ()
	CaloRecHit (const DetId &id, float energy, float time, uint32_t flags=0, uint32_t aux=0)
const DetId &	detid () const
float	energy () const
uint32_t	flagField (int base, int width=1) const
uint32_t	flags () const
void	setAux (uint32_t value)
void	setEnergy (float energy)
void	setFlagField (uint32_t value, int base, int width=1)
void	setFlags (uint32_t flags)
float	time () const

Private Attributes
uint32_t	flagBits_
	store rechit condition (see Flags enum) in a bit-wise way More...

Detailed Description

based on EcalRecHit

Author

Valeri Andreev

Definition at line 14 of file HGCRecHit.h.

Member Typedef Documentation

typedef DetId HGCRecHit::key_type

Definition at line 16 of file HGCRecHit.h.

Member Enumeration Documentation

enum HGCRecHit::Flags

Enumerator
kGood
kPoorReco
kOutOfTime
kFaultyHardware
kNoisy
kPoorCalib
kSaturated
kDead
kKilled
kWeird
kDiWeird
kUnknown

Definition at line 19 of file HGCRecHit.h.

               { 
          kGood=0,                   // channel ok, the energy and time measurement are reliable
          kPoorReco,                 // the energy is available from the UncalibRecHit, but approximate (bad shape, large chi2)
          kOutOfTime,                // the energy is available from the UncalibRecHit (sync reco), but the event is out of time
          kFaultyHardware,           // The energy is available from the UncalibRecHit, channel is faulty at some hardware level (e.g. noisy)
          kNoisy,                    // the channel is very noisy
          kPoorCalib,                // the energy is available from the UncalibRecHit, but the calibration of the channel is poor
          kSaturated,                // saturated channel (recovery not tried)
          kDead,                     // channel is dead and any recovery fails
          kKilled,                   // MC only flag: the channel is killed in the real detector
          kWeird,                    // the signal is believed to originate from an anomalous deposit (spike) 
          kDiWeird,                  // the signal is anomalous, and neighbors another anomalous signal  
                                     //
          kUnknown                   // to ease the interface with functions returning flags. 
  };

enum HGCRecHit::HGCbheFlags

Enumerator
kHGCbheGood
kHGCbheDead
kHGCbheHot
kHGCbhePassBX
kHGCbheSaturated

Definition at line 45 of file HGCRecHit.h.

                   {
          kHGCbheGood,
          kHGCbheDead,
          kHGCbheHot,
          kHGCbhePassBX,
          kHGCbheSaturated
  };

enum HGCRecHit::HGCfheFlags

Enumerator
kHGCfheGood
kHGCfheDead
kHGCfheHot
kHGCfhePassBX
kHGCfheSaturated

Definition at line 36 of file HGCRecHit.h.

                   {
          kHGCfheGood,
          kHGCfheDead,
          kHGCfheHot,
          kHGCfhePassBX,
          kHGCfheSaturated
  };

Constructor & Destructor Documentation

HGCRecHit::HGCRecHit

(

)

bit structure of CaloRecHit::flags_ used in EcalRecHit:

| 32 | 31...25 | 24...12 | 11...5 | 4...1 | | | | | | | | | | +–> reco flags ( 4 bits) | | | +–> chi2 for in time events ( 7 bits) | | +–> energy for out-of-time events (13 bits) | +–> chi2 for out-of-time events ( 7 bits) +–> spare ( 1 bit )

Definition at line 8 of file HGCRecHit.cc.

                     : CaloRecHit(), flagBits_(0) {
}

HGCRecHit::HGCRecHit	(	const DetId &	id,
		float	energy,
		float	time,
		uint32_t	flags = 0,
		uint32_t	flagBits = 0
	)

Definition at line 11 of file HGCRecHit.cc.

                                                                                                 :
  CaloRecHit(id,energy,time,flags), flagBits_(flagBits) {
}

Member Function Documentation

bool HGCRecHit::checkFlag ( int  flag ) const

inline

check if the flag is true

Definition at line 95 of file HGCRecHit.h.

References flagBits_.

Referenced by checkFlags().

{return flagBits_ & ( 0x1<<flag);}

bool HGCRecHit::checkFlags

(

const std::vector< int > &

flagsvec

)

const

check if one of the flags in a set is true

Definition at line 98 of file HGCRecHit.cc.

References checkFlag().

                                                                 {
  
  for (std::vector<int>::const_iterator flagPtr = flagsvec.begin(); 
       flagPtr!= flagsvec.end(); ++flagPtr) { // check if one of the flags is up
    if (checkFlag(*flagPtr)) return true;    
  }
  return false;
}

float HGCRecHit::chi2

(

void

)

const

Definition at line 15 of file HGCRecHit.cc.

References CaloRecHit::flags().

                            {
  uint32_t rawChi2 = 0x7F & (flags()>>4);
  return (float)rawChi2 / (float)((1<<7)-1) * 64.;
}

DetId HGCRecHit::id ( ) const

inline

get the id

Definition at line 69 of file HGCRecHit.h.

References CaloRecHit::detid().

{ return DetId(detid());}

bool HGCRecHit::isTimeErrorValid

(

)

const

Definition at line 88 of file HGCRecHit.cc.

References isTimeValid(), and timeError().

                                       {
  if(!isTimeValid())
    return false;
  if(timeError() >= 10000)
    return false;
  
  return true;
}

bool HGCRecHit::isTimeValid

(

)

const

Definition at line 81 of file HGCRecHit.cc.

References timeError().

Referenced by isTimeErrorValid().

                                  {
  if(timeError() <= 0)
    return false;
  else
    return true;
}

float HGCRecHit::outOfTimeChi2

(

)

const

Definition at line 20 of file HGCRecHit.cc.

References CaloRecHit::flags().

                                     {
  uint32_t rawChi2Prob = 0x7F & (flags()>>24);
  return (float)rawChi2Prob / (float)((1<<7)-1) * 64.;
}

float HGCRecHit::outOfTimeEnergy

(

)

const

Definition at line 25 of file HGCRecHit.cc.

References HLT_FULL_cff::exponent, CaloRecHit::flags(), and funct::pow().

                                       {
  uint32_t rawEnergy = (0x1FFF & flags()>>11);
  uint16_t exponent = rawEnergy>>10;
  uint16_t significand = ~(0xE<<9) & rawEnergy;
  return (float) significand*pow(10,exponent-5);
}

void HGCRecHit::setChi2

(

float

chi2

)

Definition at line 32 of file HGCRecHit.cc.

References CaloRecHit::flags(), and CaloRecHit::setFlags().

                                    {
  // bound the max value of the chi2
  if ( chi2 > 64 ) chi2 = 64;
  // use 7 bits
  uint32_t rawChi2 = lround( chi2 / 64. * ((1<<7)-1) );
  // shift by 4 bits (recoFlag)
  setFlags( (~(0x7F<<4) & flags()) | ((rawChi2 & 0x7F)<<4) );
}

void HGCRecHit::setFlag ( int  flag )

inline

set the flags (from Flags or ESFlags)

Definition at line 91 of file HGCRecHit.h.

References flagBits_.

Referenced by HGCalRecHitSimpleAlgo::makeRecHit().

{flagBits_|= (0x1 << flag);}

void HGCRecHit::setOutOfTimeChi2

(

float

chi2

)

Definition at line 52 of file HGCRecHit.cc.

References CaloRecHit::flags(), and CaloRecHit::setFlags().

                                             {
  // bound the max value of chi2
  if ( chi2 > 64 ) chi2 = 64;
  // use 7 bits
  uint32_t rawChi2 = lround( chi2 / 64. * ((1<<7)-1) );
  // shift by 24 bits (recoFlag + chi2 + outOfTimeEnergy)
  setFlags( (~(0x7F<<24) & flags()) | ((rawChi2 & 0x7F)<<24) );
}

void HGCRecHit::setOutOfTimeEnergy

(

float

energy

)

Definition at line 41 of file HGCRecHit.cc.

References HLT_FULL_cff::exponent, CaloRecHit::flags(), funct::pow(), and CaloRecHit::setFlags().

                                                 {
  if ( energy > 0.001 ) {
    uint16_t exponent = lround(floor(log10(energy)))+3;
    uint16_t significand = lround(energy/pow(10,exponent-5));
    // use 13 bits (3 exponent, 10 significand)
    uint32_t rawEnergy = exponent<<10 | significand;
    // shift by 11 bits (recoFlag + chi2)
    setFlags( ( ~(0x1FFF<<11) & flags()) | ((rawEnergy & 0x1FFF)<<11) );
  }
}

void HGCRecHit::setTimeError

(

uint8_t

timeErrBits

)

Definition at line 61 of file HGCRecHit.cc.

References CaloRecHit::aux(), and CaloRecHit::setAux().

                                                  {
  // take the bits and put them in the right spot
  setAux( (~0xFF & aux()) | timeErrBits );
}

float HGCRecHit::timeError

(

)

const

Definition at line 66 of file HGCRecHit.cc.

References CaloRecHit::aux(), HLT_FULL_cff::exponent, and funct::pow().

Referenced by isTimeErrorValid(), and isTimeValid().

                                 {
  uint32_t timeErrorBits = 0xFF & aux();
  // all bits off --> time reco bailed out (return negative value)
  if( (0xFF & timeErrorBits) == 0x00 )
                return -1;
  // all bits on  --> time error over 5 ns (return large value)
  if( (0xFF & timeErrorBits) == 0xFF )
    return 10000;
  
  float LSB = 1.26008;
  uint8_t exponent = timeErrorBits>>5;
  uint8_t significand = timeErrorBits & ~(0x7<<5);
  return pow(2.,exponent)*significand*LSB/1000.;
}

void HGCRecHit::unsetFlag ( int  flag )

inline

Definition at line 92 of file HGCRecHit.h.

References flagBits_.

{flagBits_ &= ~(0x1 << flag);}

Member Data Documentation

uint32_t HGCRecHit::flagBits_

private

store rechit condition (see Flags enum) in a bit-wise way

Definition at line 104 of file HGCRecHit.h.

Referenced by checkFlag(), setFlag(), and unsetFlag().