CMS 3D CMS Logo

List of all members | Public Types | Public Member Functions | Static Public Member Functions | Static Public Attributes
TotemTimingDetId Class Reference

Detector ID class for CTPPS Totem Timing detectors. Bits [19:31] : Assigend in CTPPSDetId Calss Bits [17:18] : 2 bits for UFSD plane 0,1,2,3 Bits [12:16] : 5 bits for UFSD channel numbers 1,2,3,..16 Bits [0:11] : unspecified yet. More...

#include <TotemTimingDetId.h>

Inheritance diagram for TotemTimingDetId:
CTPPSDetId DetId

Public Types

enum  { ID_NOT_SET = 28 }
 
- Public Types inherited from CTPPSDetId
enum  NameFlag { nShort, nFull, nPath }
 type of name returned by *Name functions More...
 
enum  SubDetector { sdTrackingStrip = 3, sdTrackingPixel = 4, sdTimingDiamond = 5, sdTimingFastSilicon = 6 }
 CTPPS sub-detectors. More...
 
- 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 channel () const
 
void channelName (std::string &name, NameFlag flag=nFull) const
 
TotemTimingDetId getPlaneId () const
 
uint32_t plane () const
 
void planeName (std::string &name, NameFlag flag=nFull) const
 
void setChannel (uint32_t channel)
 
void setPlane (uint32_t channel)
 
 TotemTimingDetId (uint32_t id)
 Construct from a raw id. More...
 
 TotemTimingDetId (const CTPPSDetId &id)
 
 TotemTimingDetId (uint32_t arm, uint32_t station, uint32_t romanPot=0, uint32_t plane=0, uint32_t channel=0)
 Construct from hierarchy indices. More...
 
- Public Member Functions inherited from CTPPSDetId
uint32_t arm () const
 
void armName (std::string &name, NameFlag flag=nFull) const
 
 CTPPSDetId (uint32_t id)
 Construct from a raw id. More...
 
 CTPPSDetId (uint32_t SubDet, uint32_t Arm, uint32_t Station, uint32_t RomanPot=0)
 Construct from hierarchy indeces. More...
 
CTPPSDetId getArmId () const
 
CTPPSDetId getRPId () const
 
CTPPSDetId getStationId () const
 
uint32_t rp () const
 
void rpName (std::string &name, NameFlag flag=nFull) const
 
void setArm (uint32_t arm)
 
void setRP (uint32_t rp)
 
void setStation (uint32_t station)
 
uint32_t station () const
 
void stationName (std::string &name, NameFlag flag=nFull) const
 
void subDetectorName (std::string &name, NameFlag flag=nFull) 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 (uint32_t id)
 Create an id from a raw number. More...
 
constexpr DetId (Detector det, int subdet)
 Create an id, filling the detector and subdetector fields as specified. 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 bool check (unsigned int raw)
 returns true if the raw ID is a PPS-timing one More...
 

Static Public Attributes

static uint32_t lowMaskChannel = 0xFFF
 
static uint32_t lowMaskPlane = 0x1FFFF
 
static uint32_t maskChannel = 0x1F
 
static uint32_t maskPlane = 0x3
 
static uint32_t maxChannel = 31
 
static uint32_t maxPlane = 3
 
static uint32_t startDetBit = 12
 
static uint32_t startPlaneBit = 17
 
- Static Public Attributes inherited from CTPPSDetId
static const uint32_t lowMaskArm = 0xFFFFFF
 
static const uint32_t lowMaskRP = 0x7FFFF
 
static const uint32_t lowMaskStation = 0x3FFFFF
 
static const uint32_t maskArm = 0x1
 
static const uint32_t maskRP = 0x7
 
static const uint32_t maskStation = 0x3
 
static const uint32_t maxArm = 1
 
static const uint32_t maxRP = 6
 
static const uint32_t maxStation = 2
 
static const uint32_t startArmBit = 24
 
static const uint32_t startRPBit = 19
 
static const uint32_t startStationBit = 22
 
- 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
 

Additional Inherited Members

- Protected Attributes inherited from DetId
uint32_t id_
 

Detailed Description

Detector ID class for CTPPS Totem Timing detectors. Bits [19:31] : Assigend in CTPPSDetId Calss Bits [17:18] : 2 bits for UFSD plane 0,1,2,3 Bits [12:16] : 5 bits for UFSD channel numbers 1,2,3,..16 Bits [0:11] : unspecified yet.

This class is very similar to CTPPSDiamondDetId; however the detector is completely separated, therefore it is useful to keep them separate and independent.

Definition at line 27 of file TotemTimingDetId.h.

Member Enumeration Documentation

anonymous enum
Enumerator
ID_NOT_SET 

Definition at line 30 of file TotemTimingDetId.h.

Constructor & Destructor Documentation

TotemTimingDetId::TotemTimingDetId ( uint32_t  id)
explicit

Construct from a raw id.

Definition at line 11 of file TotemTimingDetId.cc.

References channel(), check(), Exception, and DetId::subdetId().

Referenced by getPlaneId(), and TotemTimingDetId().

11  :
12  CTPPSDetId( id )
13 {
14  if ( !check( id ) ) {
15  throw cms::Exception( "InvalidDetId" )
16  << "TotemTimingDetId ctor:"
17  << " channel: " << channel()
18  << " subdet: " << subdetId()
19  << " is not a valid Totem Timing id";
20  }
21 }
uint32_t channel() const
constexpr int subdetId() const
get the contents of the subdetector field (not cast into any detector&#39;s numbering enum) ...
Definition: DetId.h:41
static bool check(unsigned int raw)
returns true if the raw ID is a PPS-timing one
CTPPSDetId(uint32_t id)
Construct from a raw id.
Definition: CTPPSDetId.cc:31
TotemTimingDetId::TotemTimingDetId ( const CTPPSDetId id)
inline

Definition at line 34 of file TotemTimingDetId.h.

References CTPPSDetId::arm(), channel(), plane(), CTPPSDetId::station(), and TotemTimingDetId().

34 : CTPPSDetId( id ) {}
CTPPSDetId(uint32_t id)
Construct from a raw id.
Definition: CTPPSDetId.cc:31
TotemTimingDetId::TotemTimingDetId ( uint32_t  arm,
uint32_t  station,
uint32_t  romanPot = 0,
uint32_t  plane = 0,
uint32_t  channel = 0 
)

Construct from hierarchy indices.

Definition at line 25 of file TotemTimingDetId.cc.

References Exception, DetId::id_, CTPPSDetId::maskArm, maskChannel, maskPlane, CTPPSDetId::maskRP, CTPPSDetId::maskStation, CTPPSDetId::maxArm, maxChannel, maxPlane, CTPPSDetId::maxRP, CTPPSDetId::maxStation, convertSQLiteXML::ok, CTPPSDetId::startArmBit, startDetBit, startPlaneBit, CTPPSDetId::startRPBit, and CTPPSDetId::startStationBit.

25  :
27 {
28  if ( arm > maxArm || station > maxStation || romanPot > maxRP || plane > maxPlane || channel > maxChannel ) {
29  throw cms::Exception( "InvalidDetId" )
30  << "TotemTimingDetId ctor:"
31  << " Invalid parameters:"
32  << " arm=" << arm
33  << " station=" << station
34  << " rp=" << romanPot
35  << " plane=" << plane
36  << " detector=" << channel
37  << std::endl;
38  }
39 
40  uint32_t ok = 0xfe000000;
41  id_ &= ok;
42 
43  id_ |= ( ( arm & maskArm ) << startArmBit );
44  id_ |= ( ( station & maskStation ) << startStationBit );
45  id_ |= ( ( romanPot & maskRP ) << startRPBit );
46  id_ |= ( ( plane & maskPlane ) << startPlaneBit );
47  id_ |= ( ( channel & maskChannel ) << startDetBit );
48 }
uint32_t station() const
Definition: CTPPSDetId.h:63
static uint32_t startPlaneBit
static const uint32_t maxStation
Definition: CTPPSDetId.h:47
uint32_t channel() const
static const uint32_t startRPBit
Definition: CTPPSDetId.h:48
static uint32_t maskPlane
static const uint32_t maskStation
Definition: CTPPSDetId.h:47
static const uint32_t maskRP
Definition: CTPPSDetId.h:48
static const uint32_t maskArm
Definition: CTPPSDetId.h:46
static const uint32_t maxArm
Definition: CTPPSDetId.h:46
static uint32_t maxChannel
uint32_t arm() const
Definition: CTPPSDetId.h:52
static const uint32_t maxRP
Definition: CTPPSDetId.h:48
static uint32_t maxPlane
uint32_t plane() const
static uint32_t startDetBit
uint32_t id_
Definition: DetId.h:62
static uint32_t maskChannel
static const uint32_t startStationBit
Definition: CTPPSDetId.h:47
CTPPSDetId(uint32_t id)
Construct from a raw id.
Definition: CTPPSDetId.cc:31
static const uint32_t startArmBit
Definition: CTPPSDetId.h:46

Member Function Documentation

uint32_t TotemTimingDetId::channel ( ) const
inline

Definition at line 61 of file TotemTimingDetId.h.

References DetId::id_, and maskChannel.

Referenced by channelName(), TotemTimingDQMSource::endLuminosityBlock(), CTPPSGeometryInfo::formatDetId(), and TotemTimingDetId().

62  {
63  return ( ( id_ >> startDetBit ) & maskChannel );
64  }
static uint32_t startDetBit
uint32_t id_
Definition: DetId.h:62
static uint32_t maskChannel
void TotemTimingDetId::channelName ( std::string &  name,
NameFlag  flag = nFull 
) const
inline

Definition at line 91 of file TotemTimingDetId.h.

References channel(), RemoveAddSevLevel::flag, CTPPSDetId::nFull, CTPPSDetId::nPath, CTPPSDetId::nShort, operator<<(), and planeName().

Referenced by TotemTimingDQMSource::ChannelPlots::ChannelPlots().

92  {
93  switch ( flag ) {
94  case nShort: name = ""; break;
95  case nFull: planeName( name, flag ); name += "_"; break;
96  case nPath: planeName( name, flag ); name += "/channel "; break;
97  }
98  name += std::to_string( channel() );
99  }
uint32_t channel() const
void planeName(std::string &name, NameFlag flag=nFull) const
static bool TotemTimingDetId::check ( unsigned int  raw)
inlinestatic

returns true if the raw ID is a PPS-timing one

Definition at line 43 of file TotemTimingDetId.h.

References DetId::kDetOffset, DetId::kSubdetOffset, CTPPSDetId::sdTimingFastSilicon, and DetId::VeryForward.

Referenced by TotemTimingDetId().

44  {
45  return ( ( ( raw >> DetId::kDetOffset ) & 0xF ) == DetId::VeryForward
46  && ( ( raw >> DetId::kSubdetOffset ) & 0x7 ) == sdTimingFastSilicon );
47  }
static const int kSubdetOffset
Definition: DetId.h:23
static const int kDetOffset
Definition: DetId.h:22
TotemTimingDetId TotemTimingDetId::getPlaneId ( ) const
inline

Definition at line 74 of file TotemTimingDetId.h.

References lowMaskPlane, DetId::rawId(), and TotemTimingDetId().

75  {
76  return TotemTimingDetId( rawId() & ( ~lowMaskPlane ) );
77  }
static uint32_t lowMaskPlane
constexpr uint32_t rawId() const
get the raw id
Definition: DetId.h:50
TotemTimingDetId(uint32_t id)
Construct from a raw id.
uint32_t TotemTimingDetId::plane ( ) const
inline

Definition at line 50 of file TotemTimingDetId.h.

References DetId::id_, and maskPlane.

Referenced by TotemTimingDQMSource::endLuminosityBlock(), CTPPSGeometryInfo::formatDetId(), planeName(), and TotemTimingDetId().

51  {
52  return ( ( id_ >> startPlaneBit ) & maskPlane );
53  }
static uint32_t startPlaneBit
static uint32_t maskPlane
uint32_t id_
Definition: DetId.h:62
void TotemTimingDetId::planeName ( std::string &  name,
NameFlag  flag = nFull 
) const
inline

Definition at line 81 of file TotemTimingDetId.h.

References RemoveAddSevLevel::flag, CTPPSDetId::nFull, CTPPSDetId::nPath, CTPPSDetId::nShort, plane(), and CTPPSDetId::rpName().

Referenced by channelName(), and TotemTimingDQMSource::PlanePlots::PlanePlots().

82  {
83  switch ( flag ) {
84  case nShort: name = ""; break;
85  case nFull: rpName( name, flag ); name += "_"; break;
86  case nPath: rpName( name, flag ); name += "/plane "; break;
87  }
88  name += std::to_string( plane() );
89  }
void rpName(std::string &name, NameFlag flag=nFull) const
Definition: CTPPSDetId.h:139
uint32_t plane() const
void TotemTimingDetId::setChannel ( uint32_t  channel)
inline

Definition at line 66 of file TotemTimingDetId.h.

References DetId::id_, maskChannel, and startDetBit.

Referenced by TotemTimingDQMSource::analyze().

67  {
68  id_ &= ~( maskChannel << startDetBit );
69  id_ |= ( ( channel & maskChannel ) << startDetBit );
70  }
uint32_t channel() const
static uint32_t startDetBit
uint32_t id_
Definition: DetId.h:62
static uint32_t maskChannel
void TotemTimingDetId::setPlane ( uint32_t  channel)
inline

Definition at line 55 of file TotemTimingDetId.h.

References DetId::id_, maskPlane, and startPlaneBit.

Referenced by TotemTimingDQMSource::analyze().

56  {
57  id_ &= ~( maskPlane << startPlaneBit );
58  id_ |= ( ( channel & maskPlane ) << startPlaneBit );
59  }
static uint32_t startPlaneBit
uint32_t channel() const
static uint32_t maskPlane
uint32_t id_
Definition: DetId.h:62

Member Data Documentation

uint32_t TotemTimingDetId::lowMaskChannel = 0xFFF
static

Definition at line 40 of file TotemTimingDetId.h.

uint32_t TotemTimingDetId::lowMaskPlane = 0x1FFFF
static

Definition at line 39 of file TotemTimingDetId.h.

Referenced by getPlaneId().

uint32_t TotemTimingDetId::maskChannel = 0x1F
static

Definition at line 40 of file TotemTimingDetId.h.

Referenced by channel(), setChannel(), and TotemTimingDetId().

uint32_t TotemTimingDetId::maskPlane = 0x3
static

Definition at line 39 of file TotemTimingDetId.h.

Referenced by plane(), setPlane(), and TotemTimingDetId().

uint32_t TotemTimingDetId::maxChannel = 31
static

Definition at line 40 of file TotemTimingDetId.h.

Referenced by TotemTimingDetId().

uint32_t TotemTimingDetId::maxPlane = 3
static

Definition at line 39 of file TotemTimingDetId.h.

Referenced by TotemTimingDetId().

uint32_t TotemTimingDetId::startDetBit = 12
static

Definition at line 40 of file TotemTimingDetId.h.

Referenced by setChannel(), and TotemTimingDetId().

uint32_t TotemTimingDetId::startPlaneBit = 17
static

Definition at line 39 of file TotemTimingDetId.h.

Referenced by setPlane(), and TotemTimingDetId().