How to Install the Analysis Framework: CxAOD _monoVH

1) Log in to your lxplus account.

a) Open a terminal.

b) ssh -X yourCERNAccountName ["at" symbol] lxplus.cern.ch

ssh -X stands for 'secure shell with x11 forwarding'

c) Enter your CERN password.

d) Check to see if your Lxplus account is able to setup up an ATLAS "environment" by typing 'setupATLAS' in your terminal within your lxplus session. If the command fails, paste the following lines of code at the very end of your .bashrc file (located in your home directory and opened by typing 'vim ~/.bashrc' ):

export AtlasSetup =/afs/cern.ch/atlas/software/dist/AtlasSetup

export ATLAS_LOCAL_ROOT_BASE=/cvmfs/atlas.cern.ch/repo/ATLASLocalRootBase

alias setupATLAS='source ${ATLAS_LOCAL_ROOT_BASE}/user/atlasLocalSetup.sh'

2) Create a directory which will be used to contain the framework files: mkdir MonoVHFrameworkTag

3) Enter the newly created directory: cd MonoVHFrameworkTag

4) svn export svn+ssh://svn.cern.ch/reps/atlasoff/PhysicsAnalysis/HiggsPhys/Run2/Hbb/CxAODFramework/FrameworkExe_monoVH/tags/FrameworkExe_monoVH-00-01-03/scripts/setup_monoVH.sh setup_monoVH.sh

5) Run the setup script located in MonoVHFrameworkTag with the following: source setup_monoVH.sh tag

There will likely be an error mentioning that a file "CutFlow" is missing; simply exit the root session that will have been opened for you by the script. Check to see if you have a directory in MonoVHFrameworkTag called 'CxAODReader'; if such a directory exists (and non-empty) then the script succeded.

6) Remove, if desired, the setup script: rm setup_monoVH.sh

7) Submit test jobs to the "lxplus batch queue":

./BatchSumbit.py 0

./BatchSumbit.py 4

How to Install the Plotting Package

The following terminal commands will download and create the PlottingTool directory needed for making histograms within the monoVH framework.

1) Login to lxplus.

2) cd MonoVHFrameworkTag

3) mkdir Plotting

4) cd Plotting

5) setupATLAS

6) rcSetup Base,2.3.25

7) svn co svn+ssh://svn.cern.ch/reps/atlasoff/PhysicsAnalysis/HiggsPhys/Run2/Hbb/CxAODFramework/FrameworkExe/trunk/macros

8) svn co svn+ssh://svn.cern.ch/reps/atlasoff/PhysicsAnalysis/HiggsPhys/Run2/Hbb/InputsProcessingTools/PlottingTool/trunk PlottingTool

How to Run the Plotter Tool

After downloading the plotting tool, the following commands will help you begin making plots:

1) Login to lxplus.

2) cd MonoVHFrameworkTag

3) Combine the root files together with: hadd 0lep.root BatchSubmitOutput _HIGG5D1_mc15?/*/hist-*.root

4) svn co svn+ssh://svn.cern.ch/reps/atlasoff/PhysicsAnalysis/HiggsPhys/Run2/Hbb/InputsProcessingTools/PlottingTool/trunk PlottingTool

5) Download the files from here (type into your terminal where you want the files to be saved): git clone https://gitlab.com/DarkSide_ofMatter/runMonoVHPlots.git

6) setupATLAS

7) source rcSetup.sh

8) Open the runMonoVHPlots file: vim runMonoVHPlots.cxx

9) Set the variable, in runMonoVHPlots.cxx, " InputFileName _0Lepton" to the path where your 0lep.root file is located. Note, this requires a relative path and not an absolute path.

a) You need change the code, pressing 'i' to manually insert your own script, to this: TString InputFileName _0Lepton = "0lep.root";

Once you are done writing the script, press the escape button to stop inserting.

b) Save and exit the text editor. You can do this by typing in ':wq'

The script should now look like the runMonoVH.cxx attachment below.

10) Run the macro with the following: root -l -b -q "runMonoVHPlots.cxx(0)"

Doing this should create a directory named "plots0LeptonFull" which contains all of the plots.

Readings We've Referenced for More Information on this Specific Analysis

• The conference note: https://cds.cern.ch/record/2129160/files/ATL-COM-PHYS-2016-103.pdf
• The support note: https://cds.cern.ch/record/2056641/files/ATL-COM-PHYS-2015-1231.pdf
• A paper on fat-jets: https://cdsweb.cern.ch/record/2041461/files/ATL-PHYS-PUB-2015-033.pdf
• A paper on the Cambridge/Aachen algorithm: http://arxiv.org/pdf/0802.1188v2.pdf
• A paper on the anti-kt jet clustering algorithm: https://arxiv.org/pdf/0802.1189v2.pdf
• A paper that is great for providing definitions of the jargon: https://cds.cern.ch/record/1967511/files/ATL-COM-PHYS-2014-1450.pdf
• A paper on D2: http://arxiv.org/pdf/1507.03018v5.pdf