L1Trigger/L1TZDC/README.md

0001 Below README for testing prior to CMSSW integration
0002
0003
0004 ***** COMMON FIXES ON FAIL (Skip to below for build instructions) *****
0005
0006 If you see output like the following
0007 ```
0008 ----- Begin Fatal Exception 18-Aug-2023 22:34:50 CEST-----------------------
0009 An exception of category 'ProductNotFound' occurred while
0010    [0] Processing  Event run: 326295 lumi: 4 event: 32601 stream: 0
0011    [1] Running path 'zdcEtSum'
0012    [2] Calling method for module L1TZDCProducer/'zdcEtSumProducer'
0013 Exception Message:
0014 Principal::getByToken: Found zero products matching all criteria
0015 Looking for type: HcalDataFrameContainer<QIE10DataFrame>
0016 Looking for module label: hcalDigis
0017 Looking for productInstanceName: ZDC
0018 Looking for process: reRECO
0019    Additional Info:
0020       [a] If you wish to continue processing events after a ProductNotFound exception,
0021 add "SkipEvent = cms.untracked.vstring('ProductNotFound')" to the "options" PSet in the configuration.
0022
0023 ----- End Fatal Exception -------------------------------------------------
0024 ```
0025
0026 The issue is almost certainly the inclusion of "reRECO" as a third argument for the zdcDigis input tag to zDCEtSumProducer (CM note: putting this at the top as I have forgotten this issue twice now)
0027
0028 ***********************************************************************
0029
0030
0031 Basic build instructions, integratable into Molly's L1Emulator instructions with the Run 3 HI menu using CMSSW_13_1_0_pre4 Found here: \
0032 https://github.com/mitaylor/L1StudiesFramework/tree/main/RunPbPbL1Ntuples
0033
0034 To build, do
0035 ```
0036 cmsrel CMSSW_13_1_0_pre4
0037 cd CMSSW_13_1_0_pre4/src
0038 cmsenv
0039 git cms-init
0040 #Insert zdcL1T_v0.0.X
0041 git remote add cfmcginn https://github.com/cfmcginn/cmssw.git
0042 git fetch cfmcginn zdcL1TOnCMSSW_13_1_0_pre4
0043 git cms-merge-topic -u cfmcginn:zdcL1T_latest
0044 #Note we will do the next line using https instead of Molly's ssh instructions
0045 #git remote add cms-l1t-offline git@github.com:cms-l1t-offline/cmssw.git
0046 git remote add cms-l1t-offline https://github.com/cms-l1t-offline/cmssw.git
0047 git fetch cms-l1t-offline l1t-integration-CMSSW_13_1_0_pre4
0048 git cms-merge-topic -u cms-l1t-offline:l1t-integration-v161
0049 git clone https://github.com/cms-l1t-offline/L1Trigger-L1TCalorimeter.git L1Trigger/L1TCalorimeter/data
0050 svn export https://github.com/boundino/HltL1Run2021.git/trunk/L1/ADC
0051
0052 git cms-checkdeps -A -a
0053
0054 scram b -j 8
0055
0056 wget https://raw.githubusercontent.com/ginnocen/UPCopenHFanalysis/main/zdc_calibration/newZDCAnalyzer/test/files_327524.txt
0057 mv files_327524.txt L1Trigger/L1TZDC/test/
0058 ```
0059
0060 To test, do
0061 ```
0062 cd L1Trigger/L1TZDC/test
0063 cmsRun l1ZDCProducerTest.py
0064 ```
0065
0066 Continuing, but now explicitly using Molly's build instructions directly (Step 2)
0067
0068 ```
0069 git cms-addpkg L1Trigger/L1TCommon
0070 git cms-addpkg L1Trigger/L1TGlobal
0071 mkdir -p L1Trigger/L1TGlobal/data/Luminosity/startup/
0072 cd L1Trigger/L1TGlobal/data/Luminosity/startup/
0073 wget https://raw.githubusercontent.com/mitaylor/HIMenus/main/Menus/L1Menu_CollisionsHeavyIons2023_v0_0_1.xml
0074 cd ../../../../../
0075 scram b -j 8
0076 ```
0077 On a good build we need to edit customiseUtils.py per Molly's instructions:
0078
0079 emacs -nw L1Trigger/Configuration/python/customiseUtils.py
0080
0081 process.TriggerMenu.L1TriggerMenuFile = cms.string('L1Menu_Collisions2022_v1_2_0.xml') → process.TriggerMenu.L1TriggerMenuFile = cms.string('L1Menu_CollisionsHeavyIons2023_v0_0_1.xml')
0082
0083 Create the python by grabbing Molly's runCmsDriver for 2018 data
0084 ```
0085 wget https://raw.githubusercontent.com/mitaylor/L1StudiesFramework/main/RunPbPbL1Ntuples/runCmsDriver_2018Data.sh
0086 bash runCmsDriver_2018Data.sh
0087 ```
0088
0089 We need to modify the output, l1Ntuple_2018Data.py
0090 Towards the end add this block, but before the line
0091
0092 "MassReplaceInputTag(process, new="rawDataMapperByLabel", old="rawDataCollector")"
0093 ****************************
0094 ```
0095 process.l1UpgradeTree.sumZDCToken = cms.untracked.InputTag("zdcEtSumProducer")
0096
0097 process.l1UpgradeEmuTree.sumZDCToken = cms.untracked.InputTag("zdcEtSumProducer")
0098
0099 process.zdcEtSumProducer = cms.EDProducer('L1TZDCProducer',
0100   zdcDigis = cms.InputTag("hcalDigis", "ZDC")
0101 )
0102
0103 process.zdcEtSum = cms.Path(process.zdcEtSumProducer)
0104 process.schedule.append(process.zdcEtSum)
0105
0106 #ABOVE CODE BEFORE THIS LINE
0107 MassReplaceInputTag(process, new="rawDataMapperByLabel", old="rawDataCollector")
0108 ```
0109 ****************************
0110
0111
0112 This should run out of the box - if it does not please contact me (cfmcginn) or ginnocen @ github