|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
|
/****************************************************************************
*
* This is a part of TOTEM offline software.
* Authors:
* Hubert Niewiadomski
* Jan Kašpar (jan.kaspar@gmail.com)
*
****************************************************************************/
#ifndef DataFormats_CTPPSDetId_TotemRPDetId
#define DataFormats_CTPPSDetId_TotemRPDetId
#include "DataFormats/CTPPSDetId/interface/CTPPSDetId.h"
#include "FWCore/Utilities/interface/Exception.h"
#include <iosfwd>
#include <iostream>
#include <string>
/**
*\brief Detector ID class for TOTEM Si strip detectors.
*
* Beyond the bit assignment in CTPPSDetId, this is the additional structure:
* Bits [15:18] => plane number from 0 (most near) to 9 (most far)
* Bits [13:14] => chip (VFAT) number
* Bits [0:12] => not assigned
**/
class TotemRPDetId : public CTPPSDetId {
public:
/// Construct from a raw id. It is required that the Detector part of
/// id is Totem and the SubDet part is RP, otherwise an exception is thrown.
explicit TotemRPDetId(uint32_t id);
TotemRPDetId(const CTPPSDetId& id) : CTPPSDetId(id) {}
/// Construct from hierarchy indeces.
TotemRPDetId(uint32_t Arm, uint32_t Station, uint32_t RomanPot = 0, uint32_t Plane = 0, uint32_t Chip = 0);
static const uint32_t startPlaneBit, maskPlane, maxPlane, lowMaskPlane;
static const uint32_t startChipBit, maskChip, maxChip, lowMaskChip;
//-------------------- component getters and setters --------------------
uint32_t plane() const { return ((id_ >> startPlaneBit) & maskPlane); }
void setPlane(uint32_t det) {
id_ &= ~(maskPlane << startPlaneBit);
id_ |= ((det & maskPlane) << startPlaneBit);
}
uint32_t chip() const { return ((id_ >> startChipBit) & maskChip); }
void setChip(uint32_t chip) {
id_ &= ~(maskChip << startChipBit);
id_ |= ((chip & maskChip) << startChipBit);
}
//-------------------- id getters for higher-level objects --------------------
TotemRPDetId planeId() const { return TotemRPDetId(rawId() & (~lowMaskPlane)); }
//-------------------- strip orientation methods --------------------
bool isStripsCoordinateUDirection() const { return plane() % 2; }
bool isStripsCoordinateVDirection() const { return !isStripsCoordinateUDirection(); }
//-------------------- conversions to the obsolete decimal representation --------------------
// NOTE: only for backward compatibility, do not use otherwise!
inline uint32_t rpDecimalId() const { return rp() + station() * 10 + arm() * 100; }
inline uint32_t planeDecimalId() const { return plane() + rpDecimalId() * 10; }
//-------------------- name methods --------------------
inline void planeName(std::string& name, NameFlag flag = nFull) const {
switch (flag) {
case nShort:
name = "";
break;
case nFull:
rpName(name, flag);
name += "_";
break;
case nPath:
rpName(name, flag);
name += "/plane ";
break;
}
name += planeNames[plane()];
}
inline void chipName(std::string& name, NameFlag flag = nFull) const {
switch (flag) {
case nShort:
name = "";
break;
case nFull:
planeName(name, flag);
name += "_";
break;
case nPath:
planeName(name, flag);
name += "/chip ";
break;
}
name += chipNames[chip()];
}
private:
static const std::string planeNames[];
static const std::string chipNames[];
};
std::ostream& operator<<(std::ostream& os, const TotemRPDetId& id);
#endif
|