Run an Analysis
Watch the video 'Take a look at the data' to give you an idea what you need to do.
In your terminal window, you are in the main directory ATLAS-DataAndTools. Here you can two python scripts RunScript.py
and PlotResults.py.
These are the two key scripts you need to run an analysis.
You will see there are 6 folders:
Analysis: Code for 7 analyses have been prepared for you.
Configurations: The Configurations file for running and the PlotConf files for plotting are here.
Input: Contains the data and simulated data files.
Output: Your final plots are written here.
Plotting: Contains files defining how your plots will look like.
results: The histograms are written here when you run an analysis, which are then used for plotting.
If you are using the small VM you may not initially have a results folder but you will have an additional file, DownloadScript.py
There are two steps to looking at the data. You must do step 1 followed by step 2.
-
Run an analysis using RunScript.py to produce histograms of individual variables eg jet_pt. The histograms are written to your results folder.
-
Plot the results using PlotResults.py to scale the histograms, colour them in and stack them. Combined plots are produced, for all the simulated and real data. These plots are written to your Output folder.
So let's have a go at the two steps !
Step 1: Run an analysis
In the Analysis folder, there are 7 analyses: TTbarAnalysis.py
, WAnalysis.py
, WZAnalysis.py
, ZAnalysis.py
, ZZAnalysis.py
, ZPrimeAnalysis.py
and HWWAnalysis.py
We will start by running TTbarAnalysis.
If you are running the large VM or running the software directly, then you can run all analyses over all data. This is great, but will take at least an hour. So be aware. It is a good idea to start by just running over a small fraction of the datasets. See below how to do this.
Running an analysis using the Small VM
If you are using the small VM, before you start, download the rest of the data. This can happen in the background, so that when you are ready to use all of the data, it will be ready for you. Type into the command line
python DownloadScript.py -q -a download &
The & is important, to allow you to continue working while the download occurs. The argument -a defines the action, which in this case is 'download' and -q sets output mode to quiet.
Now let's run the analysis.
Type into the command line
python RunScript.py -a TTbarAnalysis
This runs the code called **TTbarAnalysis **.
In this case -a defines the analysis to run.
The analysis should run, taking just a few minutes, telling you about Event Statistics and complete by saying
Job WZ: finished successfully.