To install coffea:
python3 -m pip install coffea --user
All coffea documentation is hosted at https://coffeateam.github.io/coffea/
Begin by cloning the repository,
git clone git@github.com:UMN-CMS/WrCoffea.git
cd WrCoffea
The ./shell
executable can then be used to start an apptainer shell with a coffea environment. For more information: https://github.com/CoffeaTeam/lpcjobqueue
./shell coffeateam/coffea-dask-almalinux8:latest
To run over all 2018 data, enter the command
python3 run_analysis.py 2018 Data --hists Data.root --executor lpc
The output is a root file (Data.root
) containing histograms of kinematic variables across all basic analysis regions.
The command below will locally analyze one root file from the 2018 UL DY+Jets background MC sample:
python3 run_analysis.py 2018 DYJets --hists example_hists.root --max_files 1
To run the analyzer, a sample set and process must be specified as arguments:
- Year: Currently, only
2018
exists, but there are also plans to include the rest of Run II (2016 and 2017). - Process: The process to be analyzed. Options for background processes are
DYJets
,tt+tW
,tt_semileptonic
,WJets
,Diboson
,Triboson
,ttX
,SingleTop
. To analyze signal MC samples, useSignal
, orData
for Data. - Signal Mass: If the process is
Signal
, then the signal masses must also be specified via the flag--mass
, for example--mass MWR3000_MN2900
. To see all possible signal points, use--help
.
--hists
: Generate a root file with histograms of kinematic observables.
--masses
: Generate a root file with branches of the 3-object invariant mass (Signal
).
--max_files
: Generate a root file with branches of the 3-object invariant mass (Signal
).
To run the analyzer without computing any output files (perhaps for debugging purposes), omit both --hists
and --masses
.
For more information, enter:
python3 run_analysis.py --help