Introduction

• This page describes Physics Analysis Ntuple Package framework (PhysicsAnp)
• This tutorial describes how to run a complete analysis from DxAOD to final plots

Overview

• PhysicsAnpProd ntuple production framework
  • Git project: ustc/PhysicsAnpProd
  • This is a standalone package that depends on only on ATLAS analysis software
  • This package reads DxAOD, applies CP corrections and produces analysis ntuples - work in progress
  • Tutorial TWiki: PhysicsAnpProd

• PhysicsAnp framework is made of two core packages
  • Git project: ustc/PhysicsNtuple
  • Two core packages provide core framework functionality:
    • PhysicsAnpData - base package for data objects
    • PhysicsAnpBase - base package for analysis framework code
  • It should not be necessary to modify these packages for regular analysis work

• Main analysis work is performed with PhysicsAnpLight package
  • Git project: ustc/PhysicsAnpLight
  • This is the main analysis package for SSWW, ttH and prompt lepton work
  • PhysicsAnpLight depends on PhysicsAnpData and PhysicsAnpBase packages
  • Analysis code reads ROOT ntuples
  • Selects electrons, muons, jets, etc
  • Selects and plot events
  • Includes python scripts for making stacked plots and cut-flows
  • Work in progress - currently migrating code from the previous iteration of this package

Brief overview of analysis code

• Main python configuration module for object and signal region selections
  • python/PhysicsAnpLightSSWW.py
  • Defines object selections
  • Defines event selections for signal and control regions

• Event data classes
  • RecoEvent corresponds to reconstructed event as read directly from input ntuples
  • CandEvent corresponds to candidate event, consisting objects that pass selections and overlap removal

• Analysis algorithms
  • PrepCand applies object selections and creates CandEvent (from RecoEvent)
  • src/PrepSSWW.cxx compute new event variables (that are not present in input ntuples)

• Analysis variables
  • Variables that are used for cuts and plots are defined in this enum: src/VarDefs.h and src/VarDefs.cxx

• Histogram definitions are stored in config/ssww folder
  • PlotCand.xml - event histograms
  • PlotLep.xml - lepton histograms
  • PlotJet.xml - jet histograms

Running up PhysicsAnp code with release 20.7

First time setup

• This section describes how to set up this code for the first time using release 20.7 of ATLAS analysis software
• Please run these commands only once and then exit shell:

   $ mkdir -p ~/testarea/AnpBase20
   $ cd ~/testarea/AnpBase20
   $ git clone https://:@gitlab.cern.ch:8443/ustc/PhysicsAnpLight.git
   $ source PhysicsAnpLight/macros/setup/first_setup_rel20.sh 
   $ exit

• If "git clone" above fails outside CERN, please try getting CERN Kerberos ticket first:

kinit -f -r7d -A $USER@CERN.CH

Running analysis code

• Please follow instructions for producing ntuple file with release 20.7 described in this TWiki: PhysicsAnpProd
• Commands to run analysis code:

   $ cd ~/testarea/AnpBase20
   $ source setup_atlas_analysis_release.sh
   $ python $TestArea/PhysicsAnpLight/macros/runSSWW.py out.root -n 0 -o hist.root

• Running simple object level cut-flow:

   $ python $TestArea/PhysicsAnpLight/macros/plotObjCutFlow.py hist.root -s --hkey=CutConf.* --outdir=cutflows

• How re-compile all packages when files are updated:

   $ cd $TestArea/PhysicsAnpLight/cmt
   $ cmt bro make -j4

• How re-compile all packages when new files are added:

   $ cd $TestArea/PhysicsAnpLight/cmt
   $ cmt bro rm -r ../x86_64-slc6-*
   $ cmt bro make -j4