Warning, /Configuration/Geometry/README.md is written in an unsupported language. File is not indexed.
0001 # To work on geometry package
0002
0003 ### To create or update geometries
0004 ```
0005 git cms-addpkg Geometry/CMSCommonData
0006 git cms-addpkg Configuration/Geometry
0007 scram b -j 8
0008 cd Configuration/Geometry
0009 vi python/dict2021Geometry.py
0010 python3 ./scripts/generate2021Geometry.py -D 2021
0011 ```
0012 Note:
0013 * For Phase-2, use [generateRun4Geometry.py](./scripts/generateRun4Geometry.py) and [dictRun4Geometry.py](./python/dictRun4Geometry.py) instead.
0014 * For the list of geometries, see below.
0015
0016 # Run 3 Geometries
0017
0018 The Run 3 geometry is automatically created using the script [generate2021Geometry.py](./scripts/generate2021Geometry.py).
0019
0020 Different versions of various subdetectors can be combined. The available versions are:
0021
0022 Tracker:
0023 * T3: 2021 baseline after separating tracker specific material
0024 * T4: as T3, but with zero material
0025 * T5: as T3, but with tracker material budget reduced by 5%
0026 * T6: as T3, but with tracker material budget reduced by 10%
0027 * T7: as T3, but with tracker material budget increased by 5%
0028 * T8: as T3, but with tracker material budget increased by 10%
0029
0030 Calorimeters:
0031 * C1: 2021 baseline
0032
0033 Muon system:
0034 * M1: 2021 baseline with additional chambers in GE21 and iRPC31/41
0035 * M2: 2023 GE21 shifted in position
0036 * M3: 2024 with additional chambers in GE21 and iRPC31
0037 * M4: 2025 with additional chambers in GE21 and iRPC and modified DTShield
0038 * M5: Same as M1 with modified RPC
0039 * M6: Same as M2 with modified RPC
0040 * M7: Same as M3 with modified RPC
0041 * M8: Same as M4 with modified RPC
0042 * M9: Same as M1 with modified RPC, corrected for phi staggering and z-position
0043 * M10: Same as M2 with modified RPC, corrected for phi staggering and z-position
0044 * M11: Same as M3 with modified RPC, corrected for phi staggering and z-position
0045 * M12: Same as M4 with modified RPC, corrected for phi staggering and z-position
0046 * M13: Same as M9 with modified DTShield
0047 * M14: Same as M10 with modified DTShield
0048 * M15: Same as M11 with modified DTShield
0049 * M16: Same as M12 with unmounted GE11 for 2025
0050
0051 PPS:
0052 * P7: 2021 baseline (after removing overlaps and using common materials whenever possible)
0053 * P8: First 2025 version with the rotated PPS detectors
0054
0055 The script also handles the common and forward elements of the geometry:
0056 * O4: as O6, but with zero material
0057 * O5: as O6, but with trackermaterial removed (they are in T5, T6, T7, T8)
0058 * O6: 2021 baseline
0059 * O7: 2021 with added material for muon shield
0060 * O8: as O4 with added material for muon shield
0061 * O9: as O5 with added material for muon shield
0062 * F1: 2021 baseline
0063 * F2: same as F1 with modified file zdc.xmlfrom ZDC group
0064 * F3: same as F2 with added simulti geometry for RPD
0065
0066 Several detector combinations have been generated:
0067 * 2021 = T3+C3+M13+P7+O7+F1
0068 * 2021ZeroMaterial = T4+C1+M9+P7+O4+F1
0069 * 2021FlatMinus05Percent = T5+C1+M9+P7+O5+F1
0070 * 2021FlatMinus10Percent = T6+C1+M9+P7+O5+F1
0071 * 2021FlatPlus05Percent = T7+C1+M9+P7+O5+F1
0072 * 2021FlatPlus10Percent = T8+C1+M9+P7+O5+F1
0073 * 2023 = T3+C2+M14+P7+O7+F3
0074 * 2023ZeroMaterial = T4+C1+M10+P7+O4+F2
0075 * 2023FlatMinus05Percent = T5+C1+M10+P7+O5+F2
0076 * 2023FlatMinus10Percent = T6+C1+M10+P7+O5+F2
0077 * 2023FlatPlus05Percent = T7+C1+M10+P7+O5+F2
0078 * 2023FlatPlus10Percent = T8+C1+M10+P7+O5+F2
0079 * 2024 = T3+C2+M15+P7+O7+F3
0080 * 2024ZeroMaterial = T4+C2+M11+P7+O4+F2
0081 * 2024FlatMinus05Percent = T5+C2+M11+P7+O5+F2
0082 * 2024FlatMinus10Percent = T6+C2+M11+P7+O5+F2
0083 * 2024FlatPlus05Percent = T7+C2+M11+P7+O5+F2
0084 * 2024FlatPlus10Percent = T8+C2+M11+P7+O5+F2
0085 * 2025 = T3+C2+M16+P8+O7+F3
0086 * 2025ZeroMaterial = T4+C2+M12+P8+O8+F3
0087 * 2025FlatMinus05Percent = T5+C2+M12+P8+O9+F3
0088 * 2025FlatMinus10Percent = T6+C2+M12+P8+O9+F3
0089 * 2025FlatPlus05Percent = T7+C2+M12+P8+O9+F3
0090 * 2025FlatPlus10Percent = T8+C2+M12+P8+O9+F3
0091
0092 # Phase 2 Geometries
0093
0094 The Phase 2 geometries are automatically created using the script [generateRun4Geometry.py](./scripts/generateRun4Geometry.py).
0095
0096 Different versions of various subdetectors can be combined. The available versions are:
0097
0098 Tracker:
0099 * T15: Phase2 tilted tracker (v6.1.6) w/ phase 2 pixel (v6.1.3) (Active geometry: same as T14. Material Budget: major update in IT, gathering info from recent Mechanical designs.)
0100 * T21: Phase2 tilted tracker. Outer Tracker (v8.0.0): TBPS update in Layer 1 (facilitate IT insertion) + In all TEDD, update sensors Z inter-spacing. Inner Tracker: (v6.1.5) from previous T17
0101 (TFPX: Changed sensors spacing within all double-disks + Increased distance between Disks 6 and 7 + TBPX portcards between Disks 6 and 7.)
0102 * T24: Phase2 tilted tracker. Tracker detector description itself is identical to T21 (OT800 IT615). Change of paradigm, entire description reworked to be compatible with DD4hep library.
0103 * T25: Phase2 tilted tracker. Outer Tracker (v8.0.0): same as T24/T21. Inner Tracker (v7.0.2): Based on (v6.1.5) (T24/T21), but with 3D sensors in TBPX L1. Compatible with DD4hep library.
0104 * T26: Phase2 tilted tracker. Outer Tracker (v8.0.0): same as T24/T21. Inner Tracker (v7.0.3): Based on (v6.1.5) (T24/T21), but with 3D sensors in TBPX L1 and 50x50 pixel aspect ratio in TFPX and TEPX. Compatible with DD4hep library.
0105 * T30: Phase2 tilted tracker. Exploratory geometry *only to be used in D91 for now*. Outer Tracker (v8.0.1): based on v8.0.0 with updated TB2S spacing. Inner Tracker (v6.4.0): based on v6.1.5 but TFPX with more realistic module positions.
0106 * T31: Phase2 tilted tracker. The tracker description is identical to T24/T21. The outer radius of the tracker volume is reduced to avoid a clash with the BTL geometry. The positions of the tracker components are not affected
0107 * T32: Phase2 tilted tracker. The tracker description is identical to T25. The outer radius of the tracker volume is reduced to avoid a clash with the BTL geometry (same as T31). The positions of the tracker components are not affected. This geometry is intended as a transition step towards a realistic configuration with 3D sensors in TBPX layer1.
0108 * T33: Phase2 tilted tracker. Identical to T32 apart from a more realistic description of the 3D sensors in TBPX layer1.
0109 * T34: Same as T32 with the exception of modified Tracker volume so that it touches CALO on the outer side and BeamPipe on the inner side
0110 * T35: Same as T33 with the exception of modified Tracker volume so that it touches CALO on the outer side and BeamPipe on the inner side
0111 * T36: OT (v8.0.6): increased (smallDelta +300 micron) inter-ladder radial spacing TB2S. IT (v7.4.1): TBPX as in T35 with 0.4 mm gap between Z+ and Z-
0112 * T37: OT (v8.0.6): increased (smallDelta +300 micron) inter-ladder radial spacing TB2S. IT (v7.4.2): TBPX as in T35 with 0.7+0.4+0.7 mm gap between Z+ and Z-
0113 * T38: OT (v8.0.6): increased (smallDelta +300 micron) inter-ladder radial spacing TB2S. IT (v7.4.4): TBPX as in T35 with 1.3+0.4+1.3 mm gap between Z+ and Z-
0114 * T39: Same as T35 but introducing BigPixels in InnerTracker (1x2 planar and 2x2 planar modules)
0115
0116 Calorimeters:
0117 * C9: HGCal (v11 post TDR HGCal Geometry w/ corner centering for HE part) + Phase2 HCAL and EB + Tracker cables (used in Run4D49)
0118 * C10: HGCal (as in C9) + HFNose with corrected wafer size + Phase2 HCAL and EB (used in Run4D60)
0119 * C11: HGCal (v12 post TDR HGCal Geometry same as C9 + modified support structure + full list of masked wafers) + Phase2 HCAL and EB + Tracker cables (used in Run4D68)
0120 * C13: HGCal (v13 version which reads the input from the flat file, uses these for checks and makes provision to be used downstream) + Phase2 HCAL and EB (used in Run4D70, Run4D84)
0121 * C14: HGCal (v14 version reading the input from the flat file and uses it to create geometry, still using masking to define partial wafers) + Phase2 HCAL and EB (used in Run4D76-81, Run4D85, Run4D87)
0122 * C15: HGCal (as in C14) + HFNose with corrected wafer size + Phase2 HCAL and EB (used in Run4D82)
0123 * C16: HGCal (v15 version of HGCal geometry created using real full and partial silicon modules using the constants of the flat file) + Phase2 HCAL and EB (used in Run4D83)
0124 * C17: HGCal (v16 version of HGCal geometry created with new longitudinal structure having 47 layers and new definition of partial wafers iusing the constants of the flat file) + Phase2 HCAL and EB (used in Run4D86, Run4D88)
0125 * C18: HGCal (v17 version of HGCal geometry created for a new flat file for silicon having 47 layers, ideas of cassettes, new orientation indices for full and partial wafers) + Phase2 HCAL and EB (used in Run4D92)
0126 * C19: HGCal (v17 version of HGCal geometry as in C18 but without internal cells in the Geant4 geometry definition) + Phase2 HCAL and EB (used in Run4D93)
0127 * C20: HGCal (v17 version of HGCal geometry as in C18) + HFNose with corrected wafer size + Phase2 HCAL and EB (used in Run4D93)
0128 * C21: HGCal (v17 version of HGCal geometry as in C19 but turning off all dead areas and gaps) + Phase2 HCAL and EB (used in Run4D101)
0129 * C22: HGCal (v18 version of HGCal geometry as in C18 with calibration cells, nonzero cssette retraction, correct mousebite, guard ring, proper cell size) + Phase2 HCAL and EB (used in Run4D104)
0130 * C23: HGCal (same as the v18 version which is in C22 but without internal cells in the Geant4 geometry defintiion) + Phase2 HCAL and EB (used in Run4D106)
0131 * C24: HGCal (v18 version of HGCal geometry as in C22 but turning off all dead areas and gaps) + Phase2 HCAL and EB (used in Run4D109)
0132 * C25: sane as C18 but changing ebalgo.xml to make it more conformant with standard
0133 * C26: HGCal (v19 version of HGCal geometry with calibration cells, nonzero cssette retraction, correct mousebite, guard ring, proper cell size) + Phase2 HCAL and EB (used in Run4D120)
0134 * C27: HGCal (same as the v19 version which is in C26 but without internal cells in the Geant4 geometry defintiion) + Phase2 HCAL and EB (used in Run4D106)
0135 * C28: HGCal (v19 version of HGCal geometry as in C22 but turning off all dead areas and gaps) + Phase2 HCAL and EB (used in Run4D109)
0136
0137 Muon system:
0138 * M4: Phase2 muon system for TDR w/ GE2/1, ME0, RE3/1, RE4/1 (incl. granularity in ME0, staggered GE2/1), 96 iRPC strips, no overlaps, MB4Shields
0139 * M6: same as M4 with right value for YE3 size, no "hidden" overlaps, iRPC updated, adjustment of ME0 in view of updated boundaries
0140 * M7: same as M6 with further ajustment of ME0 for boundaries
0141 * M8: same as M7 with changed number of strips for GE21
0142 * M9: same as M8 with GE0 replacing ME0
0143 * M10: same as M9 but with a realistic support structure for GE0, Shield structure modified in muonYoke
0144 * M11: same as M10 but with a corrected eta partition sizes for GE21
0145 * M12: same as M11 but removing overlaps in yoke, MB3, GE0 + adding DT shield
0146 * M13: same as M10 with right front-back relation between alternate phi segments
0147 * M14: same as M11 with right front-back relation between alternate phi segments
0148 * M15: same as M12 with right front-back relation between alternate phi segments
0149 * M16: same as M15 with reverting RPC endcap disk4 rotation
0150
0151 Fast Timing system:
0152 * I10: Fast Timing detector (LYSO barrel (bars along phi flat), silicon endcap), w/ passive materials, ETL in position defined in O4, material adjustments
0153 * I11: Same as I10, xml reorganized, comparison base for new ETL and DD4hep migration
0154 * I12: Starting from I11, new ETL layout from MTD TDR
0155 * I13: Starting from I11, new ETL layout from post MTD TDR (2 sectors per disc face)
0156 * I14: Same as I13, updated sensor structure, disc z location and passive materials
0157 * I15: Same as I14, addition of notch and revision of envelope
0158 * I16: Starting from I15, revised BTL with complete passive material description, it needs Tracker T31 or newer
0159 * I17: Same as I16, BTL with one crystal thickness (type) only, ETL with LGAD split into two sensors
0160 * I18: Same as I17, needed for updated BTL numbering scheme and BTLDetId format
0161 * I19: BTL I18/v4, ETL v9 with 2024 full layout
0162 * I20: BTL I18/v4, ETL v10 with 2024 1.7 layout
0163
0164 The script also handles the common and forward elements of the geometry:
0165 * O4: detailed cavern description, changes for modified CALO region for endcap part, no overlaps inside the Muon System
0166 * O5: same as O4 but with changes needed for new support structure
0167 * O6: same as O5 with changes needed for new defintion of boundaries
0168 * O7: same as O6 with changes needed for new defintion of calorimeter boundaries
0169 * O8: same as O7 with changes needed for a newer definition of calorimeter boundaries
0170 * O9: same as O8 with changes needed to support the additional notch in ETL
0171 * O10: same as O9 with changes needed to support the shields for DT
0172
0173 * F2: modifications needed to accommodate detailed cavern, ZDC description is removed.
0174 * F3: same as F2 but changes due to HFNose
0175 * F4: same as F2 but with modifications needed to forward shield
0176 * F5: same as F4 but changes due to HFNose
0177 * F6: same as F4 with modifications needed for BRM and forward shield
0178 * F7: same as F6 with modifications needed for HFNose
0179 * F8: same as F6 or F7 without BRM
0180 * F9: same as F8 after removing overlap in rotated shield
0181
0182 Several detector combinations have been generated:
0183 * D95 = T31+C17+M13+I16+O9+F8
0184 * D96 = T31+C18+M13+I16+O9+F8
0185 * D98 = T32+C17+M13+I16+O9+F8
0186 * D99 = T32+C18+M13+I16+O9+F8
0187 * D100 = T34+C17+M14+I16+O9+F8
0188 * D101 = T34+C18+M14+I16+O9+F8
0189 * D102 = T35+C17+M14+I16+O9+F8
0190 * D103 = T35+C21+M14+I17+O9+F8
0191 * D104 = T35+C22+M14+I16+O9+F8
0192 * D105 = T35+C17+M14+I17+O9+F8
0193 * D106 = T35+C23+M14+I17+O9+F8
0194 * D107 = T32+C17+M14+I17+O9+F8
0195 * D108 = T35+C19+M14+I17+O9+F8
0196 * D109 = T35+C24+M14+I17+O9+F8
0197 * D110 = T35+C18+M14+I17+O9+F8
0198 * D111 = T36+C24+M14+I17+O9+F8
0199 * D112 = T37+C24+M14+I17+O9+F8
0200 * D113 = T38+C24+M14+I17+O9+F8
0201 * D114 = T39+C19+M14+I17+O9+F8
0202 * D115 = T35+C20+M14+I17+O9+F8
0203 * D116 = T35+C25+M15+I17+O10+F9
0204 * D117 = T35+C25+M15+I18+O10+F9
0205 * D118 = T35+C25+M15+I19+O10+F9
0206 * D119 = T35+C25+M15+I20+O10+F9
0207 * D120 = T35+C26+M16+I20+O10+F9
0208 * D121 = T35+C25+M16+I18+O10+F9 (Current Phase-2 baseline from CMSSW_15_1_0_pre4)
0209 * D122 = T35+C27+M16+I18+O10+F9
0210 * D123 = T35+C28+M16+I18+O10+F9
