L1 Trigger Emulator Stage 2 Upgrade Instructions

This is a set of instructions on how to run the Stage-2 (Phase-I) upgrade version of the L1 Emulator to produce rates and efficiencies. For developer information, please see SWGuideL1TOfflineDev.

** Always use the most recent prompt GT when re-emulating data! You can find it here: https://twiki.cern.ch/twiki/bin/view/CMS/LatestOnlineGTs

Contents:

L1 Trigger Emulator Stage 2 Upgrade Instructions

Environment Setup with Integration Tags

The L1T integration branch has been rebased to CMSSW_13_1_0_pre4. Listed below are instructions for preparing a project area to run in CMSSW_13_1_0_pre4. For the list of sequential features and fixes included up to this tag and later see the table here.

cmsrel CMSSW_13_1_0_pre4
cd CMSSW_13_1_0_pre4/src
cmsenv
git cms-init
git remote add cms-l1t-offline git@github.com:cms-l1t-offline/cmssw.git
git fetch cms-l1t-offline l1t-integration-CMSSW_13_1_0_pre4
git cms-merge-topic -u cms-l1t-offline:l1t-integration-v156
git clone https://github.com/cms-l1t-offline/L1Trigger-L1TCalorimeter.git L1Trigger/L1TCalorimeter/data

git cms-checkdeps -A -a

scram b -j 8

L1T emulation relevant GlobalTags in CMSSW_12_6_0_pre1 are:

for run2 data reprocessing '124X_dataRun2_v2'
for run2 mc '131X_mcRun2_asymptotic_v2'
for run3 mc '131X_mcRun3_2023_realistic_v5'
for run3 data, use latest prompt GT here: https://twiki.cern.ch/twiki/bin/view/CMS/LatestOnlineGTs

The full list of available GTs can be found in https://github.com/cms-sw/cmssw/blob/master/Configuration/AlCa/python/autoCond.py.

L1T Cookbook: current recipes

Workflows

* Re-emulating Run 3 data with new calibrations

cmsDriver.py l1Ntuple -s RAW2DIGI --python_filename=data.py -n 100 --no_output --era=Run3 --data --conditions=124X_dataRun3_Prompt_v4 --customise=L1Trigger/Configuration/customiseReEmul.L1TReEmulFromRAW --customise=L1Trigger/Configuration/customiseSettings.L1TSettingsToCaloParams_2022_v0_3 --customise=L1Trigger/L1TNtuples/customiseL1Ntuple.L1NtupleAODRAWEMU --filein=/store/express/Run2022A/ExpressPhysics/FEVT/Express-v1/000/353/709/00000/4584e10d-10b5-4549-a857-29b5fe0c2674.root

Re-emulating Run-3 (MC) with Run3 era for deriving calibrations

cmsDriver.py l1Ntuple -s RAW2DIGI --python_filename=mc.py -n 303 --no_output --era=Run3 --mc --conditions=123X_mcRun3_2021_realistic_v11 --customise=L1Trigger/Configuration/customiseReEmul.L1TReEmulMCFromRAWSimHcalTP --customise=L1Trigger/L1TNtuples/customiseL1Ntuple.L1NtupleRAWEMUGEN_MC --customise=L1Trigger/Configuration/customiseSettings.L1TSettingsToCaloParams_2022_v0_1 --filein=/store/mc/Run3Summer21DRPremix/SingleNeutrino_Pt-2To20-gun/GEN-SIM-DIGI-RAW/SNB_120X_mcRun3_2021_realistic_v6-v2/2540000/e7186f9d-8dfb-480f-bcba-ead981805f87.root

For samples produced using CMSSW < 12_4_X: Add to the config file the settings for HCAL PFA1p from here, remembering to remove the two lines at the end as they are only needed for data: https://twiki.cern.ch/twiki/bin/viewauth/CMS/HcalPileupMitigation#PFA1_Filter

Re-emulating Run-3 (MC) with Run3 era

cmsDriver.py l1Ntuple -s RAW2DIGI --python_filename=mc.py -n 240 --no_output --era=Run3 --mc --conditions=120X_mcRun3_2021_realistic_v9 --customise=L1Trigger/Configuration/customiseReEmul.L1TReEmulMCFromRAW --customise=L1Trigger/L1TNtuples/customiseL1Ntuple.L1NtupleRAWEMUGEN_MC --customise=L1Trigger/Configuration/customiseSettings.L1TSettingsToCaloParams_2021_v0_1 --filein=/store/relval/CMSSW_12_0_1/RelValTTbar_14TeV/GEN-SIM-DIGI-RAW/120X_mcRun3_2021_realistic_v7-v2/10000/b67e121b-b29f-4eb0-8628-b3aa1cb76720.root

Add to the config file the following lines


import os                                                                                                                                                           
base = os.environ["CMSSW_BASE"]                                                                                                                                     
process.GlobalTag.toGet = cms.VPSet(                                                                                                                                
        cms.PSet(record = cms.string("GEMeMapRcd"),                                                                                                                 
                       tag = cms.string("GEMeMapDummy"),                                                                                                            
                       connect = cms.string("sqlite_file:" + base + "/src/L1Trigger/Configuration/test/GEMeMapDummy.db")                                            
                )                                                                                                                                                   
)                                                                                                                                                                   
process.muonGEMDigis.useDBEMap = True

L1TCaloParamsO2ORcd	L1TCaloParams_static_CMSSW_9_2_10_2017_v1_8_2_updateHFSF_v6MET
L1TCaloParamsRcd	L1TCaloParams_Stage2v3_hlt
L1TGlobalPrescalesVetosFractRcd	L1TGlobalPrescalesVetosFract_Stage2v1_hlt
L1TGlobalPrescalesVetosRcd	L1TGlobalPrescalesVetos_Stage2v0_hlt
L1TMuonBarrelParamsRcd	L1TMuonBarrelParams_Stage2v1_hlt
L1TMuonEndCapForestRcd	L1TMuonEndCapForest_Stage2v1_hlt
L1TMuonEndCapParamsRcd	L1TMuonEndCapParams_Stage2v3_hlt
L1TMuonGlobalParamsRcd	L1TMuonGlobalParams_Stage2v0_hlt
L1TMuonOverlapParamsRcd	L1TMuonOverlapParams_Stage2v0_hlt
L1TUtmTriggerMenuRcd	L1TUtmTriggerMenu_Stage2v0_hlt
L1TriggerKeyListRcd	L1TriggerKeyList_CRAFT09_hlt
L1TriggerKeyRcd	L1TriggerKey_CRAFT09v3_hlt

jetLsb	This is the LSB for Jet candidates. Do not change this unless you change the calibrations to match.
jetSeedThreshold	This value is the amount (in GeV) which the central region must have to be considered a jet seed.

etSumLsb	This is the LSB for EtSum candidates. Do not change this unless you change the calibrations to match.
etSumEtaMin	Minimum tower/jet ieta. Vector of 4 values expected, in order : ETT, HTT, ETM, HTM
etSumEtaMax	Maximum tower/jet ieta. Vector as for etSumMin
etSumEtThreshold	Minimum tower/jet Et. Vector as for etSumMin

egLsb	This is the LSB for EGamma candidates. Do not change this unless you change the calibrations to match.
egSeedThreshold	minimum ET of the seed trigger tower in the clustering
egNeighbourThreshold	minimum ET of the clustered trigger towers
egCompressShapesLUTFile	LUT used for input compression of other LUTs
egTrimmingLUTFile	LUT used for the trimming of EGamma candidates
egShapeIdLUTFile	LUT used for the shape identification of EGamma candidates
egIsoLUTFile	LUT used for the isolation of EGamma candidates
egIsoAreaNrTowersEta	parameter used to define the size of the isolation region in eta (see code for details)
egIsoAreaNrTowersPhi	parameter used to define the size of the isolation region in phi (see code for details)
egIsoVetoNrTowersPhi	parameter used to define the size of the EGamma footprint for isolation (see code for details)
egPUSParams	parameter used to define PU estimator and isolation variables: #0 not used, #1 size in eta of the central region of the detector used to compute the PU estimator, #2 maximal extension in eta of the isolation region (see code for details)

L1 Trigger Emulator Stage 2 Upgrade Instructions

Environment Setup with Integration Tags

L1T Cookbook: current recipes

Workflows

Configuring the emulation of L1T

Workflows

Calo parameters

Making L1Ntuple

L1 Trigger Global Tags in the CondDB

Data Run3

MC Productions Run3

Run2 information

Custom L1T Menu

Re-emulate L1T from RAW information

L1REPACK step with cmsDriver command

Configurations for emulation of L1T with L1REPACK

Recipe to re-emulate L1T from RAW information in MC

Tunable Parameters