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:

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.

30 { ID_NOT_SET = 28 };

TotemTimingDetId::ID_NOT_SET

Definition: TotemTimingDetId.h:30

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().

                                                 :
   CTPPSDetId( id )
 {
   if ( !check( id ) ) {
     throw cms::Exception( "InvalidDetId" )
       << "TotemTimingDetId ctor:"
       << " channel: " << channel()
       << " subdet: " << subdetId()
       << " is not a valid Totem Timing id";
   }
 }

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::CTPPSDetId

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.

                                                                                                                         :
   CTPPSDetId( sdTimingFastSilicon, arm, station, romanPot )
 {
   if ( arm > maxArm || station > maxStation || romanPot > maxRP || plane > maxPlane || channel > maxChannel ) {
     throw cms::Exception( "InvalidDetId" )
       << "TotemTimingDetId ctor:"
       << " Invalid parameters:"
       << " arm=" << arm
       << " station=" << station
       << " rp=" << romanPot
       << " plane=" << plane
       << " detector=" << channel
       << std::endl;
   }
 
   uint32_t ok = 0xfe000000;
   id_ &= ok;
 
   id_ |= ( ( arm & maskArm ) << startArmBit );
   id_ |= ( ( station & maskStation ) << startStationBit );
   id_ |= ( ( romanPot & maskRP ) << startRPBit );
   id_ |= ( ( plane & maskPlane ) << startPlaneBit );
   id_ |= ( ( channel & maskChannel ) << startDetBit );
 }

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(), CTPPSGeometryInfo::formatDetId(), TotemTimingDQMSource::globalEndLuminosityBlock(), and TotemTimingDetId().

   {
     return ( ( id_ >> startDetBit ) & 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().

   {
     switch ( flag ) {
       case nShort: name = ""; break;
       case nFull: planeName( name, flag ); name += "_"; break;
       case nPath: planeName( name, flag ); name += "/channel "; break;
     }
     name += std::to_string( channel() );
   }

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().

   {
     return ( ( ( raw >> DetId::kDetOffset ) & 0xF ) == DetId::VeryForward
           && ( ( raw >> DetId::kSubdetOffset ) & 0x7 ) == sdTimingFastSilicon );
   }

TotemTimingDetId TotemTimingDetId::getPlaneId ( ) const

inline

Definition at line 74 of file TotemTimingDetId.h.

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

   {
     return TotemTimingDetId( rawId() & ( ~lowMaskPlane ) );
   }

uint32_t TotemTimingDetId::plane ( ) const

inline

Definition at line 50 of file TotemTimingDetId.h.

References DetId::id_, and maskPlane.

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

   {
     return ( ( id_ >> startPlaneBit ) & maskPlane );
   }

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().

   {
     switch ( flag ) {
       case nShort: name = ""; break;
       case nFull: rpName( name, flag ); name += "_"; break;
       case nPath: rpName( name, flag ); name += "/plane "; break;
     }
     name += std::to_string( plane() );
   }

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().

   {
     id_ &= ~( maskChannel << startDetBit );
     id_ |= ( ( channel & maskChannel ) << startDetBit );
   }

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().

   {
     id_ &= ~( maskPlane << startPlaneBit );
     id_ |= ( ( channel & maskPlane ) << startPlaneBit );
   }

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().

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation