Codebase for L1 Menu tools. The targeted environment is Lxplus and assumes a standard session:
ssh -XY <username>@lxplus.cern.ch
Check all the details about the setup and running of the tools in the Menu twiki. Find below some general instructions for the first setup.
cmsrel CMSSW_14_0_0_pre0
cd CMSSW_14_0_0_pre0/src
git clone --depth 1 https://github.com/cms-l1-dpg/L1MenuTools.git
cd L1MenuTools/rate-estimation
wget https://raw.githubusercontent.com/cms-l1-dpg/L1MenuRun3/master/development/L1Menu_Collisions2023_v1_3_0/L1Menu_Collisions2023_v1_3_0.xml # alternatively: place your custom menu XML here
bash configure.sh L1Menu_Collisions2023_v1_3_0.xml # alternatively: provide your custom menu XML
cmsenv
mkdir -p objs/include
make -j 8
Find listed below all the available tools for menu studies in this repository.
-
Rate estimation tools (rate-estimation): Collection of tools used for rate estimation of a new menu.
-
Rate visualization tool (rate-visualization): Create pie charts and bar charts from L1 Menu rate tables.
-
L1-HLT acceptance studies (L1-HLT-acceptance): Study and visualize the relations between L1 and HLT menus.
-
L1Ntuples production recipe (L1Ntuples): Latest snapshot of a recipe to produce L1Ntuples on HTCondor.
-
PS-tools (pstools): Collection of prescale table tools for offline L1 Menu operations in CMS. It contains the following tools:
ps-generate(prescale table generation tool): create a new prescale table according to a L1 Menu, using information from an existing prescale table (documentation).ps-diff(prescale table comparison tool): create diffs between two PS table in various output formats (documentation).
-
Emulated trigger counts (uGT_decision_counts): Tool to extract the emulated trigger counts from the L1Ntuples. Useful for validating that the rate-estimation tools and the emulator work in the same way. Provided tools are :
parse_algo_map.py: Converts the given prescale table that corresponds to the emulated L1 menu into a list that maps the L1 bit index to the L1 seed name.algo_map.py: Contains the list mapping the L1 bit index to the L1 seed name.getuGTdecision.py: script to obtain the emulated trigger counts (stored in m_algoDecisionInitial in the L1Ntuples) for each L1 bit/seed.