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 [generate2026Geometry.py](./scripts/generate2026Geometry.py) and [dict2026Geometry.py](./python/dict2026Geometry.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
0038 PPS:
0039 * P7: 2021 baseline (after removing overlaps and using common materials whenever possible)
0040
0041 The script also handles the common and forward elements of the geometry:
0042 * O4: as O6, but with zero material
0043 * O5: as O6, but with trackermaterial removed (they are in T5, T6, T7, T8)
0044 * O6: 2021 baseline
0045 * F1: 2021 baseline
0046 * F2: same as F1 with modified file zdc.xmlfrom ZDC group
0047 * F3: same as F2 with added simulti geometry for RPD
0048
0049 Several detector combinations have been generated:
0050 * 2021 = T3+C1+M1+P7+O6+F1
0051 * 2021ZeroMaterial = T4+C1+M1+P7+O4+F1
0052 * 2021FlatMinus05Percent = T5+C1+M1+P7+O5+F1
0053 * 2021FlatMinus10Percent = T6+C1+M1+P7+O5+F1
0054 * 2021FlatPlus05Percent = T7+C1+M1+P7+O5+F1
0055 * 2021FlatPlus10Percent = T8+C1+M1+P7+O5+F1
0056 * 2023 = T3+C1+M2+P7+O6+F3
0057 * 2023ZeroMaterial = T4+C1+M2+P7+O4+F2
0058 * 2023FlatMinus05Percent = T5+C1+M2+P7+O5+F2
0059 * 2023FlatMinus10Percent = T6+C1+M2+P7+O5+F2
0060 * 2023FlatPlus05Percent = T7+C1+M2+P7+O5+F2
0061 * 2023FlatPlus10Percent = T8+C1+M2+P7+O5+F2
0062 * 2024 = T3+C1+M3+P7+O6+F3
0063 * 2024ZeroMaterial = T4+C1+M3+P7+O4+F2
0064 * 2024FlatMinus05Percent = T5+C1+M3+P7+O5+F2
0065 * 2024FlatMinus10Percent = T6+C1+M3+P7+O5+F2
0066 * 2024FlatPlus05Percent = T7+C1+M3+P7+O5+F2
0067 * 2024FlatPlus10Percent = T8+C1+M3+P7+O5+F2
0068
0069 # Phase 2 Geometries
0070
0071 The Phase 2 geometries are automatically created using the script [generate2026Geometry.py](./scripts/generate2026Geometry.py).
0072
0073 Different versions of various subdetectors can be combined. The available versions are:
0074
0075 Tracker:
0076 * 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.)
0077 * 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
0078 (TFPX: Changed sensors spacing within all double-disks + Increased distance between Disks 6 and 7 + TBPX portcards between Disks 6 and 7.)
0079 * 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.
0080 * 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.
0081 * 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.
0082 * 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.
0083 * 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
0084 * 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.
0085 * T33: Phase2 tilted tracker. Identical to T32 apart from a more realistic description of the 3D sensors in TBPX layer1.
0086 * 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
0087 * 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
0088 * 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-
0089 * 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-
0090 * 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-
0091 * T39: Same as T35 but introducing BigPixels in InnerTracker (1x2 planar and 2x2 planar modules)
0092
0093 Calorimeters:
0094 * C9: HGCal (v11 post TDR HGCal Geometry w/ corner centering for HE part) + Phase2 HCAL and EB + Tracker cables (used in 2026D49)
0095 * C10: HGCal (as in C9) + HFNose with corrected wafer size + Phase2 HCAL and EB (used in 2026D60)
0096 * 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 2026D68)
0097 * 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 2026D70, 2026D84)
0098 * 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 2026D76-81, 2026D85, 2026D87)
0099 * C15: HGCal (as in C14) + HFNose with corrected wafer size + Phase2 HCAL and EB (used in 2026D82)
0100 * 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 2026D83)
0101 * 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 2026D86, 2025D88)
0102 * 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 2026D92)
0103 * 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 2026D93)
0104 * C20: HGCal (v17 version of HGCal geometry as in C18) + HFNose with corrected wafer size + Phase2 HCAL and EB (used in 2026D93)
0105 * C21: HGCal (v17 version of HGCal geometry as in C19 but turning off all dead areas and gaps) + Phase2 HCAL and EB (used in 2026D101)
0106 * 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 2026D104)
0107 * 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 2026D106)
0108 * C24: HGCal (v18 version of HGCal geometry as in C122 but turning off all dead areas and gaps) + Phase2 HCAL and EB (used in 2026D109)
0109
0110 Muon system:
0111 * 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
0112 * M6: same as M4 with right value for YE3 size, no "hidden" overlaps, iRPC updated, adjustment of ME0 in view of updated boundaries
0113 * M7: same as M6 with further ajustment of ME0 for boundaries
0114 * M8: same as M7 with changed number of strips for GE21
0115 * M9: same as M8 with GE0 replacing ME0
0116 * M10: same as M9 but with a realistic support structure for GE0, Shield structure modified in muonYoke
0117 * M11: same as M10 but with a corrected eta partition sizes for GE21
0118
0119 Fast Timing system:
0120 * I10: Fast Timing detector (LYSO barrel (bars along phi flat), silicon endcap), w/ passive materials, ETL in position defined in O4, material adjustments
0121 * I11: Same as I10, xml reorganized, comparison base for new ETL and DD4hep migration
0122 * I12: Starting from I11, new ETL layout from MTD TDR
0123 * I13: Starting from I11, new ETL layout from post MTD TDR (2 sectors per disc face)
0124 * I14: Same as I13, updated sensor structure, disc z location and passive materials
0125 * I15: Same as I14, addition of notch and revision of envelope
0126 * I16: Starting from I15, revised BTL with complete passive material description, it needs Tracker T31 or newer
0127 * I17: Same as I16, BTL with one crystal thickness (type) only, ETL with LGAD split into two sensors
0128
0129 The script also handles the common and forward elements of the geometry:
0130 * O4: detailed cavern description, changes for modified CALO region for endcap part, no overlaps inside the Muon System
0131 * O5: same as O4 but with changes needed for new support structure
0132 * O6: same as O5 with changes needed for new defintion of boundaries
0133 * O7: same as O6 with changes needed for new defintion of calorimeter boundaries
0134 * O8: same as O7 with changes needed for a newer definition of calorimeter boundaries
0135 * O9: same as O8 with changes needed to support the additional notch in ETL
0136
0137 * F2: modifications needed to accommodate detailed cavern, ZDC description is removed.
0138 * F3: same as F2 but changes due to HFNose
0139 * F4: same as F2 but with modifications needed to forward shield
0140 * F5: same as F4 but changes due to HFNose
0141 * F6: same as F4 with modifications needed for BRM and forward shield
0142 * F7: same as F6 with modifications needed for HFNose
0143 * F8: same as F6 or F7 without BRM
0144
0145 Several detector combinations have been generated:
0146 * D95 = T31+C17+M10+I16+O9+F8
0147 * D96 = T31+C18+M10+I16+O9+F8
0148 * D98 = T32+C17+M10+I16+O9+F8
0149 * D99 = T32+C18+M10+I16+O9+F8
0150 * D100 = T34+C17+M11+I16+O9+F8
0151 * D101 = T34+C18+M11+I16+O9+F8
0152 * D102 = T35+C17+M11+I16+O9+F8
0153 * D103 = T35+C21+M11+I17+O9+F8
0154 * D104 = T35+C22+M11+I16+O9+F8
0155 * D105 = T35+C17+M11+I17+O9+F8
0156 * D106 = T35+C23+M11+I17+O9+F8
0157 * D107 = T32+C17+M11+I17+O9+F8
0158 * D108 = T35+C19+M11+I17+O9+F8
0159 * D109 = T35+C24+M11+I17+O9+F8
0160 * D110 = T35+C18+M11+I17+O9+F8 (Current Phase-2 baseline from CMSSW_14_1_0_pre2)
0161 * D111 = T36+C24+M11+I17+O9+F8
0162 * D112 = T37+C24+M11+I17+O9+F8
0163 * D113 = T38+C24+M11+I17+O9+F8
0164 * D114 = T39+C19+M11+I17+O9+F8
0165