Truth studies¶
For several cases it can be interesting to study simulated events (Monte Carlo) on truth level. This means that the direct output from the event generator is analysed, without any detector simulation. If the events would be processed by a detector simulation one speaks of analysis on reconstruction level.
The most common use case might be to study the properties of a new signal model and scan a large range of model parameters since the event generation is rather fast compared to the detector simulation.
Event generation¶
If you are unfamiliar with ATLAS MC software, please have a look into the tutorial:
A collection of scripts and job options for MC generation is linked here:
Bookkeeping¶
These scripts simplify the bookkeeping of generated samples and keeping track of the generated cross-sections. They are designed to work with the scripts stored in https://gitlab.cern.ch/pgadow/monoHbbSignalStudy/
Get cross-sections from AMI¶
This script allows you to query the AMI database for cross-sections.
usage: getXSectionFromAMI [-h] [--campaign CAMPAIGN] [--tag TAG] [-o OUTFILE]
DSID [DSID ...]
Positional Arguments¶
| DSID | DSID for which the cross-section should be retrieved |
Named Arguments¶
| --campaign | MC campaign Default: “mc16_13TeV” |
| --tag | Tag of AOD Default: “” |
| -o, --outFile | Write to output file (only if specified) |
Get cross-sections from log files¶
This script allows you to search a large amount of log files from the event generation for the cross-section and other interesting information.
The cross-sections are either printed to the screen or can be saved to a JSON file using the -o option.
For further analysis it is required to store the cross-section information to a file.
usage: getXSectionFromLog [-h] [-o OUTFILE] [-g GENERATOR]
logFile [logFile ...]
Positional Arguments¶
| logFile | Path to log file from event generation, contains cross-section information. |
Named Arguments¶
| -o, --outFile | Write to output file (only if specified) |
| -g, --generator | |
| Specify which MC generator was used for event generation. If not specified, try to determine from log file structure. | |
Analyse cross section files¶
This script allows you to analyse the content of a cross-section information JSON file created with getXSectionFromLog.py.
This script is more or less something like a swiss army knife. It can print the cross-sections in a nice format, write them to a csv file, plot the cross-sections or even generate snippets for the XAMPPmonoH input config steering script. Check out the options of the script:
usage: analyseXSection [-h] [--factor FACTOR] [-p] [-c] [-x] [-l LIST]
xsecFile
Positional Arguments¶
| xsecFile | JSON file containing cross-section information. |
Named Arguments¶
| --factor | CSV file with factors to be multiplied to the cross-sections. Structure: dsid, factor |
| -p, --plot | Create plots of cross-sections. Default: False |
| -c, --csv | Write cross-sections to CSV file. Default: False |
| -x, --xsec | Write cross-sections to file with XAMPP framework structure. Default: False |
| -l, --list | List samples for JSON file steering input config creation for XAMPPplotting. |
It may well be that you have to modify this script if you want to study a specific signal, so don’t be afraid to look in the source code!
Create TRUTH sample lists¶
This script allows you to generate sample lists for TRUTH DxAODs (or other samples) to be stored in XAMPPmonoH/data/GroupDiskLists/<RSE>
usage: createTruthSampleList [-h] [-o OUTPUTDIRECTORY] inputDirectory
Positional Arguments¶
| inputDirectory | Directory with ROOT files to be scanned. |
Named Arguments¶
| -o, --outputDirectory | |
Output directory for sample lists. Default: “XAMPPmonoH/data/GroupDiskLists/MPPMU_LOCALGROUPDISK” | |