HECCell Class Reference

A cell of the hadronic endcap calorimeter readout geometry. More...

#include <HECCell.h>

Inheritance diagram for HECCell:

Collaboration diagram for HECCell:

Public Types
enum	CELLPOS { FRONT , CENTER , BACK }

Public Member Functions
	HECCell (unsigned int endcap, const HECDetDescr *hecDescriptor, unsigned int eta, unsigned int phi)
	Constructor.
unsigned int	getPhiIndex () const
	The Phi Index of this Cell.
unsigned int	getEndcapIndex () const
	The EndcapIndex of this Cell (0=negative, 1=positive)
unsigned int	getEtaIndex () const
	The eta index of this cell.
unsigned int	getSamplingIndex () const
	The sampling index of this cell.
unsigned int	getRegionIndex () const
	The region index of this cell.
unsigned int	getNumBlocks () const
	The number of blocks in this cell.
unsigned int	getBlockIndex (unsigned int block) const
	The block index of cell i.
double	getZMin (unsigned int block) const
	Minimum Z of Block i.
double	getZMax (unsigned int block) const
	Maximum Z of block i.
double	getPhiLocalLower () const
	Gets the phi value at the "lower" edge of a cell.
double	getPhiLocalUpper () const
	Gets the phi value at the "upper" edge of the cell.
double	getPhiMinNominal () const
	returns a nominal phi min in global coords; assume canonical placement
double	getPhiMaxNominal () const
	returns a nominal phi max in global coords; assume canonical placement
double	getEtaMinNominal () const
	Nominal Eta Min (geometry is not projective)
double	getEtaMaxNominal () const
	Nominal Eta Min (geometry is not projective)
double	getZLocal (CELLPOS position) const
	Z for the cell at (FRONT,CENTER,BACK)
double	getRMinLocalNominal (CELLPOS position) const
	Nominal RMin for the cell at (FRONT,CENTER,BACK)
double	getRMaxLocalNominal (CELLPOS position) const
	Nominal RMax for the cell at (FRONT,CENTER,BACK)
double	getRMin (unsigned int block) const
	Minimum r of block i.
double	getRMax (unsigned int block) const
	Maximum r of block i.
const HECDetDescr *	getDescriptor () const
	Returns a pointer to the descriptor.
bool	occupiesBlock (unsigned int block) const
	Returns true if the cell occupies (or overlaps) this longitudinal block.
unsigned int	getNumSubgaps () const
	@Get num subgaps
const HECHVSubgap &	getSubgap (unsigned int i) const
	@Get subgap

Private Member Functions
	HECCell (const HECCell &right)
virtual	~HECCell ()
HECCell &	operator= (const HECCell &right)
const std::vector< const HECHVSubgap * > &	getSubgaps () const
void	initHV (std::vector< const HECHVSubgap * > &subgaps) const

Private Attributes
const HECDetDescr *	m_hecDetDescr
	Pointer to the Descriptor.
unsigned int	m_clockwork
	Bitpacked indices.
CxxUtils::CachedValue< std::vector< const HECHVSubgap * > >	m_subgaps
	Cache of subgaps.

Friends
class	ImaginaryFriend
	Additional Implementation Declarations.

Detailed Description

A cell of the hadronic endcap calorimeter readout geometry.

This class represents a single HEC Cell. A cell spans multiple blocks and has different boundaries at each block. For access to the HEC Cells, use the HECDetector Region class.

Use the HEC Cells through HEC Cell Links please!!! This will free the memory used by the cell when the last link to the cell disappears.

Definition at line 30 of file HECCell.h.

Member Enumeration Documentation

CELLPOS

enum HECCell::CELLPOS

Enumerator
FRONT
CENTER
BACK

Definition at line 34 of file HECCell.h.

{FRONT,CENTER,BACK} CELLPOS;

Constructor & Destructor Documentation

HECCell() [1/2]

HECCell::HECCell ( unsigned int endcap, const HECDetDescr * hecDescriptor, unsigned int eta, unsigned int phi )

inline

Constructor.

Definition at line 212 of file HECCell.h.

  :m_hecDetDescr(hecDescriptor),m_clockwork(phi | (eta<<6) | (endcap <<10))
  
{
  
  
}

HECCell() [2/2]

HECCell::HECCell ( const HECCell & right )

private

Member Function Documentation

getBlockIndex()

unsigned int HECCell::getBlockIndex ( unsigned int block ) const

inline

The block index of cell i.

In more detail: there are 7 longitudinal blocks in the full HEC. This cell contains (n=numBlocks()) of them. The block index of cell i tells you which block you are in within the full HEC.

Definition at line 269 of file HECCell.h.

{
  
  return getDescriptor()->getBlockIndex(block);
  
}

getDescriptor()

const HECDetDescr * HECCell::getDescriptor ( ) const

inline

Returns a pointer to the descriptor.

Definition at line 372 of file HECCell.h.

{
  
  return m_hecDetDescr;
  
}

getEndcapIndex()

unsigned int HECCell::getEndcapIndex ( ) const

inline

The EndcapIndex of this Cell (0=negative, 1=positive)

Definition at line 233 of file HECCell.h.

{
  
  return (m_clockwork & 0x00000400) >> 10;
  
}

getEtaIndex()

unsigned int HECCell::getEtaIndex ( ) const

inline

The eta index of this cell.

Definition at line 240 of file HECCell.h.

{
  
  // 4 Bits for eta:
  return (m_clockwork & 0x000003C0) >> 6;
  
}

getEtaMaxNominal()

double HECCell::getEtaMaxNominal ( ) const

inline

Nominal Eta Min (geometry is not projective)

Definition at line 311 of file HECCell.h.

{
  
  return getDescriptor()->getEtaBinning().binUpper(getEtaIndex());
  
}

getEtaMinNominal()

double HECCell::getEtaMinNominal ( ) const

inline

Nominal Eta Min (geometry is not projective)

Definition at line 304 of file HECCell.h.

{
  
  return getDescriptor()->getEtaBinning().binLower(getEtaIndex());
  
}

getNumBlocks()

unsigned int HECCell::getNumBlocks ( ) const

inline

The number of blocks in this cell.

Definition at line 262 of file HECCell.h.

{
  
  return getDescriptor()->getNumBlocks();
  
}

getNumSubgaps()

unsigned int HECCell::getNumSubgaps

(

)

const

@Get num subgaps

Definition at line 14 of file HECCell.cxx.

                                          {
  return getSubgaps().size();
}

getPhiIndex()

unsigned int HECCell::getPhiIndex ( ) const

inline

The Phi Index of this Cell.

Definition at line 226 of file HECCell.h.

{
  
  return m_clockwork & 0x0000003F;
  
}

getPhiLocalLower()

double HECCell::getPhiLocalLower ( ) const

inline

Gets the phi value at the "lower" edge of a cell.

This is a local phi!!! It's useful for constructing exact phi boundaries in the local coordinate system.

Definition at line 290 of file HECCell.h.

{
  
  return getDescriptor()->getPhiBinning().binLower(getPhiIndex());
  
}

getPhiLocalUpper()

double HECCell::getPhiLocalUpper ( ) const

inline

Gets the phi value at the "upper" edge of the cell.

This is a local phi!!! It's useful for constructing exact phi boundaries in the local coordinate system.

Definition at line 297 of file HECCell.h.

{
  
  return getDescriptor()->getPhiBinning().binUpper(getPhiIndex());
  
}

getPhiMaxNominal()

double HECCell::getPhiMaxNominal ( ) const

inline

returns a nominal phi max in global coords; assume canonical placement

Definition at line 392 of file HECCell.h.

{
  return getEndcapIndex()==0 ? M_PI-getPhiLocalLower() : getPhiLocalUpper();
}

getPhiMinNominal()

double HECCell::getPhiMinNominal ( ) const

inline

returns a nominal phi min in global coords; assume canonical placement

Definition at line 387 of file HECCell.h.

{
  return getEndcapIndex()==0 ? M_PI-getPhiLocalUpper() : getPhiLocalLower();
}

getRegionIndex()

unsigned int HECCell::getRegionIndex ( ) const

inline

The region index of this cell.

Definition at line 255 of file HECCell.h.

{
  
  return getDescriptor()->getRegionIndex();
  
}

getRMax()

double HECCell::getRMax ( unsigned int block ) const

inline

Maximum r of block i.

Definition at line 365 of file HECCell.h.

{
  
  return getDescriptor()->getRMax(block,getEtaIndex());
  
}

getRMaxLocalNominal()

double HECCell::getRMaxLocalNominal ( CELLPOS position ) const

inline

Nominal RMax for the cell at (FRONT,CENTER,BACK)

Definition at line 346 of file HECCell.h.

{
  bool hec2 = getSamplingIndex() > 1;
  if (hec2) {
    return (getDescriptor()->getManager()->getFocalToRef2() + getZLocal(position))/sinh(getEtaMinNominal());
  }
  else {
    return (getDescriptor()->getManager()->getFocalToRef1() + getZLocal(position))/sinh(getEtaMinNominal());
  }
      
}

getRMin()

double HECCell::getRMin ( unsigned int block ) const

inline

Minimum r of block i.

Definition at line 358 of file HECCell.h.

{
  
  return getDescriptor()->getRMin(block,getEtaIndex());
  
}

getRMinLocalNominal()

double HECCell::getRMinLocalNominal ( CELLPOS position ) const

inline

Nominal RMin for the cell at (FRONT,CENTER,BACK)

Definition at line 334 of file HECCell.h.

{
  bool hec2 = getSamplingIndex() > 1;
  if (hec2) {
    return (getDescriptor()->getManager()->getFocalToRef2() + getZLocal(position))/sinh(getEtaMaxNominal());
  }
  else {
    return (getDescriptor()->getManager()->getFocalToRef1() + getZLocal(position))/sinh(getEtaMaxNominal());
  }
 
}

getSamplingIndex()

unsigned int HECCell::getSamplingIndex ( ) const

inline

The sampling index of this cell.

Definition at line 248 of file HECCell.h.

{
  
  return getDescriptor()->getSamplingIndex();
  
}

getSubgap()

const HECHVSubgap & HECCell::getSubgap

(

unsigned int

i

)

const

@Get subgap

Definition at line 18 of file HECCell.cxx.

                                                           {
  return *getSubgaps()[i];
}

getSubgaps()

const std::vector< const HECHVSubgap * > & HECCell::getSubgaps ( ) const

private

Definition at line 24 of file HECCell.cxx.

{
  if (!m_subgaps.isValid()) {
    std::vector<const HECHVSubgap*> subgaps;
    initHV (subgaps);
    m_subgaps.set (std::move (subgaps));
  }
  return *m_subgaps.ptr();
}

getZLocal()

double HECCell::getZLocal ( CELLPOS position ) const

inline

Z for the cell at (FRONT,CENTER,BACK)

Definition at line 318 of file HECCell.h.

{
  
  switch (position) {
  case FRONT:
    return getZMin(0);
  case CENTER:
    return (getZLocal(FRONT) + getZLocal(BACK))/2.0;
  case BACK:
    return getZMax(getNumBlocks()-1);
  default :
    return 0;
  };
  
}

getZMax()

double HECCell::getZMax ( unsigned int block ) const

inline

Maximum Z of block i.

Definition at line 283 of file HECCell.h.

{
  
  return getDescriptor()->getZMax(block);
  
}

getZMin()

double HECCell::getZMin ( unsigned int block ) const

inline

Minimum Z of Block i.

Definition at line 276 of file HECCell.h.

{
  
  return getDescriptor()->getZMin(block);
  
}

initHV()

void HECCell::initHV ( std::vector< const HECHVSubgap * > & subgaps ) const

private

Definition at line 35 of file HECCell.cxx.

{
  const HECHVManager& hvManager=getDescriptor()->getManager()->getHVManager();
 
 
  unsigned int iSide=getEndcapIndex();
 
  double phiUpper = getPhiMaxNominal();
  double phiLower = getPhiMinNominal();
  double phi=fabs(phiUpper+phiLower)/2.0;
  const CellBinning & phiBinning=hvManager.getDescriptor().getPhiBinning();
  unsigned int iPhi = int((phi - phiBinning.getStart())/phiBinning.getDelta()) + phiBinning.getFirstDivisionNumber();
 
  unsigned int iSampling=getSamplingIndex();
 
  const HECHVModule& hvMod = hvManager.getHVModule(iSide,iPhi,iSampling);
  for (unsigned int iSubgap=0;iSubgap<4;iSubgap++) {
    const HECHVSubgap& hvElec = hvMod.getSubgap(iSubgap);
    subgaps.push_back(&hvElec);
  }
} 

occupiesBlock()

bool HECCell::occupiesBlock ( unsigned int block ) const

inline

Returns true if the cell occupies (or overlaps) this longitudinal block.

Definition at line 379 of file HECCell.h.

{
  
  return getDescriptor()->getRadialSegment(block,getEtaIndex())!=NULL;
  
}

operator=()

HECCell & HECCell::operator= ( const HECCell & right )

private

~HECCell()

HECCell::~HECCell ( )

privatevirtualdefault

Friends And Related Symbol Documentation

ImaginaryFriend

friend class ImaginaryFriend

friend

Additional Implementation Declarations.

Definition at line 202 of file HECCell.h.

Member Data Documentation

m_clockwork

unsigned int HECCell::m_clockwork

private

Bitpacked indices.

Definition at line 192 of file HECCell.h.

m_hecDetDescr

const HECDetDescr* HECCell::m_hecDetDescr

private

Pointer to the Descriptor.

This class responds to its interface mostly by forwarding requests to the descriptor.

Definition at line 187 of file HECCell.h.

m_subgaps

CxxUtils::CachedValue<std::vector<const HECHVSubgap*> > HECCell::m_subgaps

private

Cache of subgaps.

Definition at line 197 of file HECCell.h.

---

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

• HECCell.h
• HECCell.cxx