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
0035 * M2: 2023 GE21 shifted in position
0036
0037 PPS:
0038 * P7: 2021 baseline (after removing overlaps and using common materials whenever possible)
0039
0040 The script also handles the common and forward elements of the geometry:
0041 * O4: as O6, but with zero material
0042 * O5: as O6, but with trackermaterial removed (they are in T5, T6, T7, T8)
0043 * O6: 2021 baseline
0044 * F1: 2021 baseline
0045
0046 Several detector combinations have been generated:
0047 * 2021 = T3+C1+M1+P7+O6+F1
0048 * 2021ZeroMaterial = T4+C1+M1+P7+O4+F1
0049 * 2021FlatMinus05Percent = T5+C1+M1+P7+O5+F1
0050 * 2021FlatMinus10Percent = T6+C1+M1+P7+O5+F1
0051 * 2021FlatPlus05Percent = T7+C1+M1+P7+O5+F1
0052 * 2021FlatPlus10Percent = T8+C1+M1+P7+O5+F1
0053 * 2023 = T3+C1+M2+P7+O6+F1
0054
0055 # Phase 2 Geometries
0056
0057 The Phase 2 geometries are automatically created using the script [generate2026Geometry.py](./scripts/generate2026Geometry.py).
0058
0059 Different versions of various subdetectors can be combined. The available versions are:
0060
0061 Tracker:
0062 * 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.)
0063 * 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
0064 (TFPX: Changed sensors spacing within all double-disks + Increased distance between Disks 6 and 7 + TBPX portcards between Disks 6 and 7.)
0065 * 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.
0066 * 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.
0067 * 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.
0068 * 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.
0069 * 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
0070 * 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.
0071 * T33: Phase2 tilted tracker. Identical to T32 apart from a more realistic description of the 3D sensors in TBPX layer1.
0072
0073 Calorimeters:
0074 * C9: HGCal (v11 post TDR HGCal Geometry w/ corner centering for HE part) + Phase2 HCAL and EB + Tracker cables (used in 2026D49)
0075 * C10: HGCal (as in C9) + HFNose with corrected wafer size + Phase2 HCAL and EB (used in 2026D60)
0076 * 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)
0077 * 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)
0078 * 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)
0079 * C15: HGCal (as in C14) + HFNose with corrected wafer size + Phase2 HCAL and EB (used in 2026D82)
0080 * 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)
0081 * 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)
0082 * 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)
0083 * 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)
0084 * C20: HGCal (v17 version of HGCal geometry as in C18) + HFNose with corrected wafer size + Phase2 HCAL and EB (used in 2026D93)
0085 * C21: HGCal (v17 version of HGCal geometry as in C19 but turning off a;; dead areas and gaps) + Phase2 HCAL and EB (used in 2026D101)
0086
0087 Muon system:
0088 * 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
0089 * M6: same as M4 with right value for YE3 size, no "hidden" overlaps, iRPC updated, adjustment of ME0 in view of updated boundaries
0090 * M7: same as M6 with further ajustment of ME0 for boundaries
0091 * M8: same as M7 with changed number of strips for GE21
0092 * M9: same as M8 with GE0 replacing ME0
0093 * M10: same as M9 but with a realistic support structure for GE0, Shield structure modified in muonYoke
0094
0095 Fast Timing system:
0096 * I10: Fast Timing detector (LYSO barrel (bars along phi flat), silicon endcap), w/ passive materials, ETL in position defined in O4, material adjustments
0097 * I11: Same as I10, xml reorganized, comparison base for new ETL and DD4hep migration
0098 * I12: Starting from I11, new ETL layout from MTD TDR
0099 * I13: Starting from I11, new ETL layout from post MTD TDR (2 sectors per disc face)
0100 * I14: Same as I13, updated sensor structure, disc z location and passive materials
0101 * I15: Same as I14, addition of notch and revision of envelope
0102 * I16: Starting from I15, revised BTL with complete passive material description, it needs Tracker T31 or newer
0103
0104 The script also handles the common and forward elements of the geometry:
0105 * O4: detailed cavern description, changes for modified CALO region for endcap part, no overlaps inside the Muon System
0106 * O5: same as O4 but with changes needed for new support structure
0107 * O6: same as O5 with changes needed for new defintion of boundaries
0108 * O7: same as O6 with changes needed for new defintion of calorimeter boundaries
0109 * O8: same as O7 with changes needed for a newer definition of calorimeter boundaries
0110 * O9: same as O8 with changes needed to support the additional notch in ETL
0111
0112 * F2: modifications needed to accommodate detailed cavern, ZDC description is removed.
0113 * F3: same as F2 but changes due to HFNose
0114 * F4: same as F2 but with modifications needed to forward shield
0115 * F5: same as F4 but changes due to HFNose
0116 * F6: same as F4 with modifications needed for BRM and forward shield
0117 * F7: same as F6 with modifications needed for HFNose
0118 * F8: same as F6 or F7 without BRM
0119
0120 Several detector combinations have been generated:
0121 * D86 = T24+C17+M10+I14+O8+F6
0122 * D88 = T24+C17+M10+I15+O9+F6
0123 * D91 = T30+C17+M10+I15+O9+F6
0124 * D92 = T24+C18+M10+I15+O9+F6
0125 * D93 = T24+C19+M10+I15+O9+F6
0126 * D94 = T24+C20+M10+I15+O9+F8
0127 * D95 = T31+C17+M10+I16+O9+F6
0128 * D96 = T31+C18+M10+I16+O9+F6
0129 * D97 = T25+C17+M10+I15+O9+F6
0130 * D98 = T32+C17+M10+I16+O9+F6 (Current Phase-2 baseline from CMSSW_13_2_0_pre2)
0131 * D99 = T32+C18+M10+I16+O9+F6
0132 * D100 = T33+C17+M10+I16+O9+F6
0133 * D101 = T32+C21+M10+I15+O9+F6
0134