#include <EcalScDetId.h>

Inheritance diagram for EcalScDetId:

Public Types
enum	{ kSizeForDenseIndexing = SC_PER_EE_CNT * 2 }

Public Types inherited from DetId
enum	Detector { Tracker = 1, Muon = 2, Ecal = 3, Hcal = 4, Calo = 5, Forward = 6, VeryForward = 7, HGCalEE = 8, HGCalHSi = 9, HGCalHSc = 10, HGCalTrigger = 11 }

Public Member Functions
uint32_t	denseIndex () const

	EcalScDetId ()

	EcalScDetId (const DetId &id)

	EcalScDetId (int ix, int iy, int iz)

	EcalScDetId (uint32_t rawid)

int	hashedIndex () const

int	iquadrant () const

int	ix () const

int	iy () const

EcalScDetId &	operator= (const DetId &id)

EcalSubdetector	subdet () const

int	zside () const

Public Member Functions inherited from DetId
constexpr Detector	det () const
	get the detector field from this detid More...

constexpr	DetId ()
	Create an empty or null id (also for persistence) More...

constexpr	DetId (Detector det, int subdet)
	Create an id, filling the detector and subdetector fields as specified. More...

constexpr	DetId (uint32_t id)
	Create an id from a raw number. More...

constexpr bool	null () const
	is this a null id ? More...

constexpr	operator uint32_t () const

constexpr bool	operator!= (DetId id) const
	inequality More...

constexpr uint32_t	operator() () const

constexpr bool	operator< (DetId id) const
	comparison More...

constexpr bool	operator== (DetId id) const
	equality More...

constexpr uint32_t	rawId () const
	get the raw id More...

constexpr int	subdetId () const
	get the contents of the subdetector field (not cast into any detector's numbering enum) More...

Static Public Member Functions
static EcalScDetId	unhashIndex (int hi)

static bool	validDenseIndex (uint32_t din)

static bool	validDetId (int ix, int iy, int iz)

static bool	validHashIndex (int hi)

Static Public Attributes
static const int	IHASHED_MAX = SC_PER_EE_CNT * 2 - 1

static const int	IHASHED_MIN = 0

static const int	IX_MAX = 20

static const int	IX_MIN = 1

static const int	IY_MAX = 20

static const int	IY_MIN = 1

static const int	SC_PER_EE_CNT = 312

Static Public Attributes inherited from DetId
static const int	kDetMask = 0xF

static const int	kDetOffset = 28

static const int	kSubdetMask = 0x7

static const int	kSubdetOffset = 25

Static Private Member Functions
static void	checkHashedIndexMap ()

Static Private Attributes
static EcalScDetId	hashedIndex2DetId [kSizeForDenseIndexing]

static const int	nEndcaps = 2

static short	xyz2HashedIndex [IX_MAX][IY_MAX][nEndcaps]

Additional Inherited Members
Protected Attributes inherited from DetId
uint32_t	id_

Detailed Description

Supercrystal identifier class for the ECAL endcap.

Note: internal representation of ScDetId:

*  31              .               15              .              0
*  |-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-| 
*  |  det  |sudet|         0       |1|z|     ix      |     iy      |
*  +-------+-----+-----------------+-+-+-------------+-------------+
*

Definition at line 24 of file EcalScDetId.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Enumerator
kSizeForDenseIndexing	Number of dense supercrystal indices.

Definition at line 185 of file EcalScDetId.h.

        {
     kSizeForDenseIndexing = SC_PER_EE_CNT * 2
   };

Constructor & Destructor Documentation

◆ EcalScDetId() [1/4]

EcalScDetId::EcalScDetId ( )

Constructor of a null id

Definition at line 12 of file EcalScDetId.cc.

12 : DetId() {}

Referenced by checkHashedIndexMap(), and unhashIndex().

◆ EcalScDetId() [2/4]

EcalScDetId::EcalScDetId ( uint32_t rawid )

Constructor from a raw value

Parameters

rawid det ID number of the supecrystal, as defined in this class description.

Definition at line 14 of file EcalScDetId.cc.

14 : DetId(rawid) {}

◆ EcalScDetId() [3/4]

EcalScDetId::EcalScDetId	(	int	ix,
		int	iy,
		int	iz
	)

Constructor from supercrystal ix,iy,iz (iz=+1/-1) ix x-index runs from 1 to 20 along x-axis of standard CMS coordinates iy y-index runs from 1 to 20 along y-axis of standard CMS coordinates iz z-index (also called "z-side") is -1 for EE- and +1 for EE+

Parameters

ix	x-index
iy	y-index
iz	z-side /z-index: -1 for EE-, +1 for EE+

Definition at line 16 of file EcalScDetId.cc.

                                                : DetId(Ecal, EcalEndcap) {
   if (!validDetId(ix, iy, iz)) {
     throw cms::Exception("InvalidDetId") << "EcalScDetId:  Cannot create object.  Indexes out of bounds \n"
                                          << "x = " << ix << " y = " << iy << " z = " << iz;
   }
   const int scBit = 1 << 15;  //bit set to 1 to distinguish from crystal id (EEDetId)
   //                         and for a reasonale behaviour of DetId ccomparison operators.
   id_ |= (iy & 0x7f) | ((ix & 0x7f) << 7) | ((iz > 0) ? (1 << 14) : (0)) | scBit;
 }

References Exception, DetId::id_, ix(), iy(), and validDetId().

◆ EcalScDetId() [4/4]

EcalScDetId::EcalScDetId ( const DetId & id )

Constructor from a raw value

Parameters

id	det ID number

Definition at line 26 of file EcalScDetId.cc.

                                          {
   if (!gen.null() && (gen.det() != Ecal || gen.subdetId() != EcalEndcap)) {
     throw cms::Exception("InvalidDetId");
   }
   id_ = gen.rawId();
 }

References DetId::Ecal, EcalEndcap, Exception, and DetId::id_.

Member Function Documentation

◆ checkHashedIndexMap()

void EcalScDetId::checkHashedIndexMap ( )

staticprivate

Initializes x,y,z <-> hashed index map if not yet done.

Definition at line 91 of file EcalScDetId.cc.

                                       {
   std::call_once(initializedFlag, []() {
     int hashedIndex = -1;
     for (int iZ = -1; iZ <= +1; iZ += 2) {
       for (int iY = IY_MIN; iY <= IY_MAX; ++iY) {
         for (int iX = IX_MIN; iX <= IX_MAX; ++iX) {
           if (validDetId(iX, iY, iZ)) {
             xyz2HashedIndex[iX - IX_MIN][iY - IY_MIN][iZ > 0 ? 1 : 0] = ++hashedIndex;
             assert((unsigned)hashedIndex < sizeof(hashedIndex2DetId) / sizeof(hashedIndex2DetId[0]));
             hashedIndex2DetId[hashedIndex] = EcalScDetId(iX, iY, iZ);
           }
         }
       }
     }
   });
 }

References cms::cuda::assert(), EcalScDetId(), hashedIndex(), hashedIndex2DetId, initializedFlag, IX_MAX, IX_MIN, IY_MAX, IY_MIN, validDetId(), and xyz2HashedIndex.

Referenced by hashedIndex(), and unhashIndex().

◆ denseIndex()

uint32_t EcalScDetId::denseIndex ( ) const

inline

Same as hashed index.

Returns: the dense/hashed index

Definition at line 127 of file EcalScDetId.h.

127 { return hashedIndex(); }

References hashedIndex().

◆ hashedIndex()

int EcalScDetId::hashedIndex ( ) const

inline

Gets a compact index for arrays. Index runs from 0 to 623. They are ordered by increasing z (EE- then EE+), then for same z by increasing y. then for same z and y by increasing x

Definition at line 106 of file EcalScDetId.h.

                           {
     checkHashedIndexMap();
     if (!validDetId(ix(), iy(), zside()))
       return -1;
     return xyz2HashedIndex[ix() - IX_MIN][iy() - IY_MIN][zside() > 0 ? 1 : 0];
   }

References checkHashedIndexMap(), ix(), IX_MIN, iy(), IY_MIN, validDetId(), xyz2HashedIndex, and zside().

Referenced by checkHashedIndexMap(), denseIndex(), ecaldqm::SelectiveReadoutTask::runOnDigis(), and ecaldqm::SelectiveReadoutTask::runOnSrFlags().

◆ iquadrant()

int EcalScDetId::iquadrant ( ) const

Gets the quadrant of the DetId.

Quadrant number definition for EE+, x and y in std CMS coordinates:

*                 A y
*                 |
*          Q2     |    Q1
*                 |
*       ----------o---------> x
*                 |
*          Q3     |    Q4
*                 |
*

This method will return the same quadrant number independently of z: that is two supercrystals which are face to face will be considered will have the same quadrant number. It is not clear it is the correct or usual definition.

See also: EEDetId::iquadrant()

Returns: quadrant number, from 1 to 4.

Definition at line 41 of file EcalScDetId.cc.

                                  {
   const int xMiddle = IX_MAX / 2;  //y = 0 between xMiddle and xMiddle+1
   const int yMiddle = IY_MAX / 2;  //x = 0 between yMiddle and yMiddle+1
   if (iy() > yMiddle) {            // y>0
     if (ix() > xMiddle)            //             A y
       return 1;                    //             |
     else                           //      Q2     |    Q1
       return 2;                    //             |
   } else {                         // y<0          //   ----------o---------> x
     if (ix() > xMiddle)            //             |
       return 4;                    //      Q3     |    Q4
     else                           //             |
       return 3;
   }
   //Should never be reached
   return -1;
 }

References ix(), IX_MAX, iy(), and IY_MAX.

◆ ix()

int EcalScDetId::ix ( ) const

inline

Gets the crystal x-index.

See also: EcalDetId(int, int, int) for x-index definition

Returns: x-index

Definition at line 70 of file EcalScDetId.h.

70 { return (id_ >> 7) & 0x7F; }

References DetId::id_.

Referenced by EcalSelectiveReadoutValidation::analyzeEE(), ecaldqm::binning::channelName(), EcalScDetId(), ecaldqm::binning::findBinSuperCrystal_(), hashedIndex(), iquadrant(), ecaldqm::isForward(), ecaldqm::MESet::maskMatches(), EcalDAQTowerStatusXMLTranslator::plot(), EcalDCSTowerStatusXMLTranslator::plot(), ecaldqm::pnForCrystal(), EcalDetIdToBeRecoveredProducer::produce(), EcalRecHitWorkerRecover::run(), ecaldqm::scConstituents(), and xuti::writeCell().

◆ iy()

int EcalScDetId::iy ( ) const

inline

Get the crystal y-index

See also: EcalDetId(int, int, int) for y-index definition.

Returns: y-index

Definition at line 76 of file EcalScDetId.h.

76 { return id_ & 0x7F; }

References DetId::id_.

Referenced by EcalSelectiveReadoutValidation::analyzeEE(), ecaldqm::binning::channelName(), EcalScDetId(), ecaldqm::binning::findBinSuperCrystal_(), hashedIndex(), iquadrant(), ecaldqm::isForward(), ecaldqm::MESet::maskMatches(), EcalDAQTowerStatusXMLTranslator::plot(), EcalDCSTowerStatusXMLTranslator::plot(), ecaldqm::pnForCrystal(), EcalDetIdToBeRecoveredProducer::produce(), EcalRecHitWorkerRecover::run(), ecaldqm::scConstituents(), and xuti::writeCell().

◆ operator=()

EcalScDetId & EcalScDetId::operator= ( const DetId & id )

Assignment operator

Parameters

id	source det id

Definition at line 33 of file EcalScDetId.cc.

                                                     {
   if (!gen.null() && (gen.det() != Ecal || gen.subdetId() != EcalEndcap)) {
     throw cms::Exception("InvalidDetId");
   }
   id_ = gen.rawId();
   return *this;
 }

References DetId::Ecal, EcalEndcap, Exception, and DetId::id_.

◆ subdet()

EcalSubdetector EcalScDetId::subdet ( ) const

inline

Gets the subdetector

Returns: subdetectot ID, that is EcalEndcap

Definition at line 59 of file EcalScDetId.h.

59 { return EcalSubdetector(subdetId()); }

References DetId::subdetId().

◆ unhashIndex()

static EcalScDetId EcalScDetId::unhashIndex ( int hi )

inlinestatic

Gets EcalScDetId from hasedIndex as defined by hashedIndex method

Parameters

hi	hashed index

Returns: the EcalScDetId. If hi is invalid return a null EcalScDetId.

Definition at line 117 of file EcalScDetId.h.

                                          {
     checkHashedIndexMap();
     if (hi < 0 || hi >= kSizeForDenseIndexing)
       return EcalScDetId();
     return hashedIndex2DetId[hi];
   }

References checkHashedIndexMap(), EcalScDetId(), hashedIndex2DetId, and kSizeForDenseIndexing.

Referenced by EcalDAQTowerStatusXMLTranslator::dumpXML(), EcalDCSTowerStatusXMLTranslator::dumpXML(), ecaldqm::TowerStatusTask::endLuminosityBlock(), EcalDAQTowerStatusXMLTranslator::plot(), EcalDCSTowerStatusXMLTranslator::plot(), ecaldqm::StatusManager::readFromObj(), ecaldqm::SelectiveReadoutTask::runOnDigis(), and ecaldqm::StatusManager::writeToObj().

◆ validDenseIndex()

static bool EcalScDetId::validDenseIndex ( uint32_t din )

inlinestatic

Validates a hashed index.

Parameters

din	hashed index to validate

Returns: true if the index is valid, false if it is invalid.

Definition at line 133 of file EcalScDetId.h.

133 { return din < kSizeForDenseIndexing; }

References cropTnPTrees::din, and kSizeForDenseIndexing.

Referenced by validHashIndex().

◆ validDetId()

bool EcalScDetId::validDetId	(	int	ix,
		int	iy,
		int	iz
	)

static

Checks validity of a crystal (x,y.z) index triplet.

Parameters

ix	supercrystal x-index
iy	supercrystal y-index
iz	supercrystal z-index (aka z-side)

See also: EEDetId(int, int, int) for index definition

Returns: true if valid, false otherwise

Definition at line 59 of file EcalScDetId.cc.

                                                    {
   static const char endcapMap[401] = {
       "       XXXXXX       "
       "    XXXXXXXXXXXX    "
       "   XXXXXXXXXXXXXX   "
       "  XXXXXXXXXXXXXXXX  "
       " XXXXXXXXXXXXXXXXXX "
       " XXXXXXXXXXXXXXXXXX "  //    Z
       " XXXXXXXXXXXXXXXXXX "  //     x-----> X
       "XXXXXXXXXXXXXXXXXXXX"  //     |
       "XXXXXXXXX  XXXXXXXXX"  //     |
       "XXXXXXXX    XXXXXXXX"  //_          //     |
       "XXXXXXXX    XXXXXXXX"  //     V Y
       "XXXXXXXXX  XXXXXXXXX"
       "XXXXXXXXXXXXXXXXXXXX"
       " XXXXXXXXXXXXXXXXXX "
       " XXXXXXXXXXXXXXXXXX "
       " XXXXXXXXXXXXXXXXXX "
       "  XXXXXXXXXXXXXXXX  "
       "   XXXXXXXXXXXXXX   "
       "    XXXXXXXXXXXX    "
       "       XXXXXX       "};
  
   return abs(iZ) == 1 && endcapMap[iX - 1 + (iY - 1) * 20] != ' ';
 }

References funct::abs().

Referenced by checkHashedIndexMap(), EcalScDetId(), popcon::EcalDAQHandler::getNewObjects(), popcon::EcalDCSHandler::getNewObjects(), hashedIndex(), popcon::EcalDCSHandler::insertHVDataSetToOffline(), popcon::EcalDCSHandler::insertLVDataSetToOffline(), ecaldqm::binning::isValidIdBin(), EcalSelectiveReadout::printEndcap(), EcalTrivialConditionRetriever::produceEcalDAQTowerStatus(), EcalTrivialConditionRetriever::produceEcalDCSTowerStatus(), EcalTrivialConditionRetriever::produceEcalDQMTowerStatus(), and EcalSelectiveReadoutSuppressor::run().

◆ validHashIndex()

static bool EcalScDetId::validHashIndex ( int hi )

inlinestatic

Validates a hashed index.

Parameters

hi	hashed index to validate

Returns: true if the index is valid, false if it is invalid.

Definition at line 139 of file EcalScDetId.h.

139 { return validDenseIndex(hi); }

References validDenseIndex().

Referenced by EcalDAQTowerStatusXMLTranslator::dumpXML(), EcalDCSTowerStatusXMLTranslator::dumpXML(), EcalDCSTowerStatusXMLTranslator::plot(), and EcalDAQTowerStatusXMLTranslator::plot().

◆ zside()

int EcalScDetId::zside ( ) const

inline

Gets the z-side of the crystal (1/-1)

Returns: -1 for EE-, +1 for EE+

Definition at line 64 of file EcalScDetId.h.

64 { return (id_ & 0x4000) ? (1) : (-1); }

References DetId::id_.

Referenced by EcalSelectiveReadoutValidation::analyzeEE(), EcalSelectiveReadout::eeRuInterest(), ecaldqm::binning::findBinSuperCrystal_(), hashedIndex(), ecaldqm::MESet::maskMatches(), EcalDAQTowerStatusXMLTranslator::plot(), EcalDCSTowerStatusXMLTranslator::plot(), ecaldqm::pnForCrystal(), EcalDetIdToBeRecoveredProducer::produce(), EcalRecHitWorkerRecover::run(), ecaldqm::scConstituents(), and xuti::writeCell().

Member Data Documentation

◆ hashedIndex2DetId

EcalScDetId EcalScDetId::hashedIndex2DetId

staticprivate

Map of hased index to x,y,z. See hashedIndex/

Definition at line 200 of file EcalScDetId.h.

Referenced by checkHashedIndexMap(), and unhashIndex().

◆ IHASHED_MAX

const int EcalScDetId::IHASHED_MAX = SC_PER_EE_CNT * 2 - 1

static

Upper bound for hashed/dense index

Definition at line 167 of file EcalScDetId.h.

◆ IHASHED_MIN

const int EcalScDetId::IHASHED_MIN = 0

static

Lower bound for hashed/dense index

Definition at line 163 of file EcalScDetId.h.

◆ IX_MAX

const int EcalScDetId::IX_MAX = 20

static

Upper bound of EE crystal y-index

Definition at line 155 of file EcalScDetId.h.

Referenced by checkHashedIndexMap(), and iquadrant().

◆ IX_MIN

const int EcalScDetId::IX_MIN = 1

static

Lower bound of EE supercrystal x-index

Definition at line 147 of file EcalScDetId.h.

Referenced by checkHashedIndexMap(), and hashedIndex().

◆ IY_MAX

const int EcalScDetId::IY_MAX = 20

static

Upper bound of EE crystal y-index

Definition at line 159 of file EcalScDetId.h.

Referenced by checkHashedIndexMap(), and iquadrant().

◆ IY_MIN

const int EcalScDetId::IY_MIN = 1

static

Lower bound of EE supercrystal y-index

Definition at line 151 of file EcalScDetId.h.

Referenced by checkHashedIndexMap(), and hashedIndex().

◆ nEndcaps

const int EcalScDetId::nEndcaps = 2

staticprivate

Definition at line 192 of file EcalScDetId.h.

◆ SC_PER_EE_CNT

const int EcalScDetId::SC_PER_EE_CNT = 312

static

Number of supercrystals per endcap

Definition at line 143 of file EcalScDetId.h.

◆ xyz2HashedIndex

short EcalScDetId::xyz2HashedIndex

staticprivate

Map of z,x,y index to hashed index. See hashedIndex/

Definition at line 196 of file EcalScDetId.h.

Referenced by checkHashedIndexMap(), and hashedIndex().

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Static Private Member Functions

Static Private Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ anonymous enum

Constructor & Destructor Documentation

◆ EcalScDetId() [1/4]

◆ EcalScDetId() [2/4]

◆ EcalScDetId() [3/4]

◆ EcalScDetId() [4/4]

Member Function Documentation

◆ checkHashedIndexMap()

◆ denseIndex()

◆ hashedIndex()

◆ iquadrant()

◆ ix()

◆ iy()

◆ operator=()

◆ subdet()

◆ unhashIndex()

◆ validDenseIndex()

◆ validDetId()

◆ validHashIndex()

◆ zside()

Member Data Documentation

◆ hashedIndex2DetId

◆ IHASHED_MAX

◆ IHASHED_MIN

◆ IX_MAX

◆ IX_MIN

◆ IY_MAX

◆ IY_MIN

◆ nEndcaps

◆ SC_PER_EE_CNT

◆ xyz2HashedIndex