Warning, /Geometry/TrackerNumberingBuilder/README.md is written in an unsupported language. File is not indexed.
0001 In this package the `GeometricDet` tree of the `TrackerGeometry` object in the `TrackerDigiGeometryRecord` is created, the DetIds are assigned to the different components in the tree according to the schema which is defined in the xml description of trackerParameters.xml for the `TrackerGeometricDetESModule`, and the configuration of the `TrackerTopology` object is configured to be able to decode the DetIds using
0002 the same schema.
0003
0004 The graph of the `GeometricDet` tree can be found in [this file](doc/GeometricDetBuilder.png)
0005
0006 ## Available DetId Schemas
0007 The predefined DetId schemas available in this package are:
0008 * The Run 1 (aka _present_) detector DetId schema
0009 * The Phase 1 detector DetId schema where the pixel detector is replaced by the upgraded one
0010 * The Phase 2 upgrade detector DetId schema where both the strip and the pixel detectors are replaced by the upgraded ones - TDR-like
0011 * The Phase 2 upgrade reordered detector DetId schema, where the strip detector is replaced by the upgraded one (TDR-like), as is the pixel detector. This differs from the full TDR-like Phase2 DetId schema to account for a re-ordering in the pixel endcaps.
0012
0013 In the table below the DetId levels which are in normal font represents _real_ hierarchy levels which are present
0014 also in the `GeometricDet` tree which is build in parallel to the DetId assignment. Those levels which are in _italic_ font are _fake_ levels and are not known by the GeometricDet tree.
0015 When the name of the `TrackerTopology` method is written in _italic_, it means that its name does not reflect the actual attribute of the DetId which is returned. This is because, so far, the names of the methods are hardcoded and reflect the present Tracker detector. In addition two generic methods, `TrackerTopology::layer(id)` and `TrackerTopology::side(id)` can be used to determine the layer/disk number and the side of the endcap subdetectors.
0016
0017 ### Run 1 Detector DetId schema
0018 The Run 1 detector DetId schema profits of all the six available subdetectors (from 1 to 6) and it is defined as follows
0019
0020 * Subdetector 1 (`DetId::subDetId() == PixelSubdetector::PixelBarrel`): Pixel Barrel
0021
0022 | Name | start bit | hex mask | bit size | `TrackerTopology` method | Notes |
0023 |------|-----------|-----------|-----|----|-----|
0024 | _not used_ | 20 | 0x1F | 5 | | |
0025 | Layer | 16 | 0xF | 4 | pxbLayer(id) or layer(id) | increasing r |
0026 | Ladder | 8 | 0xFF | 8 | pxbLadder(id) | increasing phi |
0027 | Module | 2 | 0x3F | 6 | pxbModule(id) | increasing z |
0028 | _not used_ | 0 | 0x3 | 2 | | |
0029
0030 * Subdetector 2 (`DetId::subDetId() == PixelSubdetector::PixelEndcap`): Pixel Forward
0031
0032 | Name | start bit | hex mask | bit size | `TrackerToplogy` method | Notes |
0033 |------|-----------|-----------|----|-----|-----|
0034 | subdetector part | 23 | 0x3 | 2 | pxfSide(id) or side(id) | 1=FPIX- 2=FPIX+ |
0035 | _not used_ | 20 | 0x7 | 3 | | |
0036 | Disk | 16 | 0xF | 4 | pxfDisk(id) or layer(id) | increasing abs(z) |
0037 | _Blade_ | 10 | 0x3F | 6 | pxfBlade(id) | increasing phi |
0038 | Panel | 8 | 0x3 | 2 | pxfPanel(id) | 1=forward 2=backward |
0039 | Module | 2 | 0x3F | 6 | pxfModule(id) | increasing r |
0040 | _not used_ | 0 | 0x3 | 2 | | |
0041
0042 * Subdetector 3 (`DetId::subDetId() == StripSubdetector::TIB`): TIB
0043
0044 | Name | start bit | hex mask | bit size | `TrackerTopology` method | Notes |
0045 |------|-----------|-----------|-----|----|-----|
0046 | not used | 17 | 0xFF | 8 | | |
0047 | Layer | 14 |0x7 | 3 | tibLayer(id) or layer(id) | increasing r |
0048 | _subdetector part_ | 12 | 0x3 | 2 | tibSide(id) | 1=TIB- 2=TIB+ |
0049 | _Layer side_ | 10 | 0x3 | 2 | tibOrder(id) | 1=internal 2=external |
0050 | String | 4 | 0x3F | 6 | tibString(id) | increasing phi |
0051 | Module | 2 | 0x3 | 2 | tibModule(id) | increasing abs(z) |
0052 | Module type | 0 | 0x3 | 2 | tibStereo(id) or tibGlued(id) | 1=stereo, 2=rphi, 0=pair |
0053
0054 * Subdetector 4 (`DetId::subDetId() == StripSubdetector::TID`): TID
0055
0056 | Name | start bit | hex mask | bit size | `TrackerTopology` method | Notes |
0057 |------|-----------|-----------|-----|----|-----|
0058 | _not used_ | 15 | 0x3FF | 10 | | |
0059 | subdetector part | 13 |0x3 | 2 | tidSide(id) or side(id) | 1=TID- 2=TID+ |
0060 | Disk | 11 | 0x3 | 2 | tidWheel(id) or layer(id) | increasing abs(z) |
0061 | Ring | 9 | 0x3 | 2 | tidRing(id) | increasing r |
0062 | _Disk side_ | 7 | 0x3 | 2 | tidOrder(id) | 1=back 2=front |
0063 | Module | 2 | 0x1F | 5 | tidModule(id) | increasing phi |
0064 | Module type | 0 | 0x3 | 2 | tidStereo(id) or tidGlued(id) | 1=stereo, 2=rphi, 0=pair |
0065
0066 * Subdetector 5 (`DetId::subDetId() == StripSubdetector::TOB`): TOB
0067
0068 | Name | start bit | hex mask | bit size | `TrackerTopology` method | Notes |
0069 |------|-----------|-----------|-----|----|----|
0070 | _not used_ | 17 | 0xFF | 8 | | |
0071 | Layer | 14 |0x7 | 3 | tobLayer(id) or layer(id) | increasing r |
0072 | _subdetector part_ | 12 | 0x3 | 2 | tobSide(id) | 1=TIB- 2=TIB+ |
0073 | Rod | 5 | 0x7F | 7 | tobRod(id) | increasing phi |
0074 | Module | 2 | 0x7 | 3 | tobModule(id) | increasing abs(z) |
0075 | Module type | 0 | 0x3 | 2 | tobStereo(id) or tobGlued(id) | 1=stereo, 2=rphi, 0=pair |
0076
0077 * Subdetector 6 (`DetId::subDetId() == StripSubdetector::TEC`): TEC
0078
0079 | Name | start bit | hex mask | bit size | `TrackerTopology` method | Notes |
0080 |------|-----------|-----------|-----|----|----|
0081 | _not used_ | 20 | 0x3F | 5 | | |
0082 | subdetector part | 18 |0x3 | 2 | tecSide(id) or side(id) | 1=TEC- 2=TEC+ |
0083 | Wheel | 14 | 0xF | 4 | tecWheel(id) or layer(id) | increasing abs(z) |
0084 | _Wheel side_ | 12 | 0x3 | 2 | tecOrder(id) | 1=back 2=front |
0085 | Petal | 8 | 0xF | 4 | tecPetal(id) | increasing phi |
0086 | Ring | 5 | 0x7 | 3 | tecRing(id) | increasing r |
0087 | Module | 2 | 0x7 | 3 | tecModule(id) | increasing phi |
0088 | Module type | 0 | 0x3 | 2 | tecStereo(id) or tecGlued(id) | 1=stereo, 2=rphi, 0=pair |
0089
0090 A more detailed description of the SiStrip Tracker DetId schema can be found in this CMS Internal Note: [http://cms.cern.ch/iCMS/jsp/openfile.jsp?type=IN&year=2007&files=IN2007_020.pdf]
0091
0092 The configuration names for this detid schema are `trackerNumberingGeometry_cfi` (to run on geometry built from xml files) or `trackerNumberingGeometryDB_cfi` (to run on geometry from DB) for `TrackerGeometricDetESModule` and `trackerTopologyConstants_cfi` for `TrackerTopology`
0093 The xml description of tracker parameters for this detid schema is in [Geometry/TrackerCommonData/data/trackerParameters.xml](../TrackerCommonData/data/trackerParameters.xml)
0094
0095 ### Phase 1 Upgrade Detector DetId schema
0096 The phase 1 detector DetId schema differs from that of the Run 1 detector only in the first two subdetectors which
0097 corresponds to the Pixel Barrel and Forward detector. Therefore only them will be repeated here:
0098
0099 * Subdetector 1 (`DetId::subDetId() == PixelSubdetector::PixelBarrel`): Phase1 Pixel Barrel
0100
0101 | Name | start bit | hex mask | bit size | `TrackerTopology` method | Notes |
0102 |------|-----------|-----------|-----|----|-----|
0103 | _not used_ | 24 | 0x1 | 1 | | |
0104 | Layer | 20 | 0xF | 4 | pxbLayer(id) or layer(id) | increasing r |
0105 | Ladder | 12 | 0xFF | 8 | pxbLadder(id) | increasing phi |
0106 | Module | 2 | 0x3FF | 10 | pxbModule(id) | increasing z |
0107 | _not used_ | 0 | 0x3 | 2 | | |
0108
0109 * Subdetector 2 (`DetId::subDetId() == PixelSubdetector::PixelEndcap`): Phase1 Pixel Forward
0110
0111 | Name | start bit | hex mask | bit size | `TrackerTopology` method | Notes |
0112 |------|-----------|-----------|----|-----|-----|
0113 | subdetector part | 23 | 0x3 | 2 | pxfSide(id) or side(id) | 1=FPIX- 2=FPIX+ |
0114 | _not used_ | 22 | 0x1 | 1 | | |
0115 | Disk | 18 | 0xF | 4 | pxfDisk(id) or layer(id) | increasing abs(z) |
0116 | _Blade_ | 12 | 0x3F | 6 | pxfBlade(id) | increasing phi and r: first inner ring blades and the outer ring blades |
0117 | Panel | 10 | 0x3 | 2 | pxfPanel(id) | 1=forward 2=backward |
0118 | Module | 2 | 0xFF | 8 | pxfModule(id) | always = 1 |
0119 | _not used_ | 0 | 0x3 | 2 | | |
0120
0121 Subdetectors 3 to 6 are as for the Run 1 detector since the SiStrip Tracker is the same in phase1.
0122
0123 The configuration names for this detid schema are `trackerNumberingGeometry_cfi` (to run on geometry built from xml files) or `trackerNumberingGeometryDB_cfi` (to run on geometry from DB) for `TrackerGeometricDetESModule` and `trackerTopology2017Constants_cfi` for `TrackerTopology`
0124 The xml description of tracker parameters for this detid schema is in [Geometry/TrackerCommonData/data/PhaseI/trackerParameters.xml](../TrackerCommonData/data/PhaseI/trackerParameters.xml)
0125
0126 ### Phase 2 Upgrade Detector DetId schema Flat or Tilted Geometry with new pixel detector for TDR (from Version V4021)
0127 The phase 2 detector DetId schema for the pixel has been re-designed in order to have the correct hierarchy endcap-->disk-->ring-->module
0128 while the outer tracker, use, as in previous case, subdetector 5, for the barrel, and subdetector 4, for the endcap. In some cases the name of the `TrackerTopology` methods is not so meaningful. In particular, for the Outer Tracker, the methods DoubleSided is not implemented, firstly because there is no need, secondly because it is not possible, just looking at the DetId and without something hardcoded, to understand if the module is single or double. This is also valid for Run I and Phase I.
0129 The OT tilted option has been introduced in the subdetector 5 with two bits (in the table referred with _subdetector part_ ) that correspond to the rings in the negative and positive part and the central barrel part. The order is thus changed respectevely for the three different subparts: ladders by increasing phi and rings by increasing |z|, same consistency for the modules order.
0130
0131 With this subdetector, the flat geometry is compatible using just the central barrel part of the subdetector 5.
0132
0133 * Subdetector 1: (`DetId::subDetId() == PixelSubdetector::PixelBarrel`): Phase2 Pixel Barrel
0134
0135 | Name | start bit | hex mask | bit size | `TrackerTopology` method | Notes |
0136 |------|-----------|-----------|-----|----|-----|
0137 | _not used_ | 24 | 0x1 | 1 | | |
0138 | Layer | 20 | 0xF | 4 | pxbLayer(id) or layer(id) | increasing r |
0139 | Ladder | 12 | 0xFF | 8 | pxbLadder(id) | increasing phi |
0140 | Module | 2 | 0x3FF | 10 | pxbModule(id) | increasing z |
0141 | _not used_ | 0 | 0x3 | 2 | | |
0142
0143 * Subdetector 2: (`DetId::subDetId() == PixelSubdetector::PixelEndcap`): Phase2 Pixel Forward
0144
0145 | Name | start bit | hex mask | bit size | `TrackerTopology` method | Notes |
0146 |------|-----------|-----------|----|-----|-----|
0147 | subdetector part | 23 | 0x3 | 2 | pxfSide(id) or side(id) | 1=FPIX- 2=FPIX+ |
0148 | _not used_ | 22 | 0x1 | 1 | | |
0149 | Disk | 18 | 0xF | 4 | pxfDisk(id) or layer(id) | increasing abs(z) |
0150 | _Ring_ | 12 | 0x3F | 6 | pxfBlade(id) | increasing r |
0151 | Panel | 10 | 0x3 | 2 | pxfPanel(id) | always 1 |
0152 | Module | 2 | 0xFF | 8 | pxfModule(id) | increasing phi |
0153 | _not used_ | 0 | 0x3 | 2 | | |
0154
0155 * Subdetector 5 (`DetId::subDetId() == StripSubdetector::TOB`): Phase2 Outer Tracker Barrel
0156
0157 | Name | start bit | hex mask | bit size | `TrackerTopology` method | Notes |
0158 |------|-----------|-----------|-----|----|-----|
0159 | _not used_ | 24 | 0x1 | 1 | | |
0160 | Layer | 20 | 0xF | 4 | tobLayer(id) or layer(id) | increasing r |
0161 | _subdetector part_ | 18| 0x3 | 2 | tobSide(id) | 1=rings- 2=rings+ 3=barrel0|
0162 | Ladder | 10 | 0xFF | 8 | tobRod(id) | increasing abs(z) (rings) or phi(barrel) |
0163 | Module | 2 | 0xFF | 8 | tobModule(id) | increasing phi (rings) or z(barrel) |
0164 | Module type | 0 | 0x3 | 2 | tobLower(id) or tobUpper(id) | 1=lower in local s.o.r.(P sensor into PS), 2=upper in local s.o.r.(S sensor into PS), 0=pair |
0165 * Subdetector 4 (`DetId::subDetId() == StripSubdetector::TID`): Phase2 Outer Tracker Endcap
0166
0167 | Name | start bit | hex mask | bit size | `TrackerTopology` method | Notes |
0168 |------|-----------|-----------|----|-----|----|
0169 | subdetector part | 23 | 0x3 | 2 | tidSide(id) or side(id) | 1=-ve 2=+ve |
0170 | _not used_ | 22 | 0x1 | 1 | | |
0171 | Disk | 18 | 0xF | 4 | tidDisk(id) or side(id) | increasing abs(z) |
0172 | _Ring_ | 12 | 0x3F | 6 | tidRing(id) | increasing r |
0173 | Panel | 10 | 0x3 | 2 | _tidOrder(id)_ | always = 1 |
0174 | Module | 2 | 0xFF | 8 | tidModule(id) | increasing phi |
0175 | Module type | 0 | 0x3 | 2 | tidLower(id) or tidUpper(id) | 1=lower in local s.o.r.(P sensor into PS), 2=upper in local s.o.r.(S sensor into PS), 0=pair |
0176
0177 The configuration names for this detid schema are `trackerNumberingGeometry_cfi` (to run on geometry built from xml files) or `trackerNumberingGeometryDB_cfi` (to run on geometry from DB) for `TrackerGeometricDetESModule` and `trackerTopology2023Constants_cfi` for `TrackerTopology`
0178 The xml description of tracker parameters for this detid schema is in [Geometry/TrackerCommonData/data/PhaseII/trackerParameters.xml](../TrackerCommonData/data/PhaseII/trackerParameters.xml
0179
0180 ### Phase 2 Upgrade Detector DetId schema modified to account for the re-ordering of the pixel
0181 Only the subdetector 2 schema is different wrt the original Phase 2 upgrade DetIdSchema
0182
0183 * Subdetector 2: (`DetId::subDetId() == PixelSubdetector::PixelEndcap`): Phase2 Pixel Forward
0184
0185 | Name | start bit | hex mask | bit size | `TrackerTopology` method | Notes |
0186 |------|-----------|-----------|----|-----|-----|
0187 | subdetector part | 23 | 0x3 | 2 | pxfSide(id) or side(id) | 1=FPIX- 2=FPIX+ |
0188 | DoubleDisk | 19 | 0xF | 4 |pxfDisk(id) or layer(id) | increasing abs(z) |
0189 | _SubDisk_ | 18 | 0x1 | 1 | | increasing abs(z) |
0190 | _SingleRing_ | 12 | 0x3F | 6 | pxfBlade(id) | increasing r |
0191 | Panel | 10 | 0x3 | 2 | pxfPanel(id) | always 1 |
0192 | Module | 2 | 0xFF | 8 | pxfModule(id) | increasing phi |
0193 | _not used_ | 0 | 0x3 | 2 | | |
0194
0195 The configuration names for this detid schema are `trackerNumberingGeometry_cfi` (to run on geometry built from xml files) or `trackerNumberingGeometryDB_cfi` (to run on geometry from DB) for `TrackerGeometricDetESModule` and `trackerTopology2023Constants_cfi` for `TrackerTopology`
0196 The xml description of tracker parameters for this detid schema is in [Geometry/TrackerCommonData/data/PhaseII/TFPXTEPXReordered/trackerParameters.xml](../TrackerCommonData/data/PhaseII/TFPXTEPXReordered/trackerParameters.xml
0197
0198
0199 ### Subdetector `GeometricDet` Enumerators
0200
0201 The link between the subdetectors described in the geometry and the `DetId::subDetId()` is created by the `GeometricDet::GDEnumType` enumerators. Each subdetector name in the Tracker DDD is associated to a `GeometricDet::GDEnumType` enumerator which has to be of the form n*100+m where m is between 1 and 6 and it will correspond to the `DetId::subDetId()` value. The present link table is:
0202
0203 | Tk DDD name | `GeometricDet::GDEnumType` | `DetId::subDetId()` |
0204 |-------------|------------------------|---------------------|
0205 | PixelBarrel | `PixelBarrel`=1 | 1=`PixelSubdetector::PixelBarrel` |
0206 | PixelEndcapSubDet | `PixelEndCap`=2 | 2=`PixelSubdetector::PixelEndcap` |
0207 | TIB | `TIB`=3 | 3=`StripSubdetector::TIB` |
0208 | TID | `TID`=4 | 4=`StripSubdetector::TID` |
0209 | TOB | `TOB`=5 | 5=`StripSubdetector::TOB` |
0210 | TEC | `TEC`=6 | 6=`StripSubdetector::TEC` |
0211 | PixelPhase1Barrel | `PixelPhase1Barrel`=101 | 1=`PixelSubdetector::PixelBarrel` |
0212 | PixelPhase1EndcapSubDet | `PixelPhase1EndCap`=102 | 2=`PixelSubdetector::PixelEndcap` |
0213 | PixelPhase2Barrel | `PixelPhase2Barrel`=201 | 1=`PixelSubdetector::PixelBarrel` |
0214 | PixelPhase2EndcapSubDet | `PixelPhase2EndCap`=202 | 2=`PixelSubdetector::PixelEndcap` |
0215 | Phase2OTBarrel | `OTPhase2Barrel`=205 | 5=`StripSubdetector::TOB` |
0216 | Phase2OTEndcap | `OTPhase2EndCap`=204 | 4=`StripSubdetector::TID` |
