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