Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

README for running rate-estimation tools with NanoAOD #121

Draft
wants to merge 1 commit into
base: master
Choose a base branch
from
Draft

README for running rate-estimation tools with NanoAOD #121

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions rate-estimation/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,13 @@ cd ntuple
cd ..
```

It is also possible to run the rate estimation code on nanoAOD using the option `--doNano`.
Some notes:
- nanoAOD should only be used with the `--useUnpackTree` option, since nanoAOD does not yet store the emulator trees
- only the final uGT decisions are stored in nanoAOD, whilst initial decisions are the default;
to compare the uGT output (for prescaled triggers) with equivalent ntuples the `--UseFinalDecision` flag should be used
- muon shower variables are not yet stored in nanoAOD for the standalone emulator, so these will return 0 rates

### Lumi section information table
In case you are using data ntuples, this table is used to avoid bad lumi sections (LS).
It also includes LS vs PU information, which can be useful for plotting rate vs PU dependencies.
Expand Down Expand Up @@ -123,13 +130,15 @@ The arguments that you can use are as follows:
|`-b` | Number of bunches. |
|`--lowerPUbound` | Consider only events with PU >= lowerPUbound for the rate estimation |
|`--upperPUbound` | Consider only events with PU <= upperPUbound for the rate estimation |
|`--doNano` | Use nanoAOD format for input events; default is ntuple |
|`--doReweightingRun3` | Apply pileup reweighting of the Run 3 flat pileup distribution according to Run 3Lumi POG model (do not use with `--lowerPUbound` or `--upperPUbound` option!) |
|`--doReweighting2018` | Apply pileup reweighting of the Run 3 flat pileup distribution to match the Run 2 pileup profile (do not use with `--lowerPUbound` or `--upperPUbound` option!) |
|`--customReweighting` | Apply pileup reweighting using a custom set of weights, set a json-file containing the custom weights |
|`--SelectRun` | Select a run number; default is full list. |
|`--SelectLS [startLS,endLS]` | Select lumi sections to run over; default is whole LS provided. |
|`--SelectCol` | Select the column in the PS table. |
|`--UseUnpackTree` | Switch to using UnpackTree; default is EmuTree. |
|`--UseFinalDecision` | Switch to using final uGT decisions; default is initial decisions (relevant only for prescaled triggers). |
|`--maxEvent` | Run on a subset of the available events. |
|`--doPrintPU` | Evaluate and save the rates for different pileup values |
|`--PrescalePrecision` | Select the prescale precision factor e.g. for 100 (=10^2) the prescales are represented with 2 decimal places |
Expand Down