CoEPP Analysis Suite

Intoduction

The CoEPP Analysis Suite is a collection of analysis packages designed to run on tau D3PDs. The suite is primarily focused on the tau-tau lepton-hadron final state and is designed to be used with the following workflow:

• Run skims over tau D3PDs (CoEPPGridTools can be used for this)
• Process skims writing out derived Ntuples (CoEPPNtupGen). This includes:
  • basic selection requiring a tag and probe candidate
  • application of all official ATLAS tools (eg. pileup reweighting and scale factors)
  • write out of important variables of the tag, probe and the event.
• Process derived Ntuples to generate final analysis plots (CoEPPPyTools). This includes:
  • All data-driven background estimation techniques
  • Ability to change selection and re-run analysis within minutes.

Packages

Tools for running on D3PDs / skims

• CoEPPRelease ([[https://svnweb.cern.ch/trac/atlasusr/browser/wdavey/CoEPPRelease/trunk][SVN]) - configuration package
• CoEPPCore (SVN) - basic set of core tools used by most other packages
• CoEPPD3PDReader (SVN) - D3PDObjects classes used by other packages
• CoEPPTrigTool (SVN) - Trigger tool for accessing trigger decisions usinng metadata
• CoEPPNtupGen (SVN) - Ztautau analysis code

Tools for running on derived ntuples

• CoEPPPyTools (SVN) - Python plotting modules

Other Tools:

• CoEPPGridTools (SVN) - python tools for managing grid job submission (in particular skims) and dq2 datasets

Getting Started

This section will guide you very briefly through the whole workflow of the package, starting from an input tau D3PD and finally generating plots from a small derived Ntuple. Please note however, that there are example datasets available on the grid at the start of each section if you get stuck. Also, I cannot guarantee that the package tags on this wiki will remain up-to-date. So whenever you check out a package, please look for the latest tag!

Suite setup

Note: The CoEPPSuite has been updated to use the RootCore build system.

To use the CoEPP packages follow these setup instructions:

1. Check out CoEPPRelease
   • svn co svn+ssh://svn.cern.ch/reps/atlasusr/wdavey/CoEPPRelease/trunk CoEPPRelease
   • cd CoEPPRelease
2. Configure required packages
   • edit packages.txt and hash out any packages you don't want to use.
3. Check out and compile
   • source checkout.sh
4. Setup in future sessions
   • every time you log into a clean shell, you need to source setup.sh in the CoEPPRelease directory

Note: to avoid having to put your password in 3 times each time you access svn follow these instructions for setting up ssh key access.

Skimming

First follow the installation instructions CoEPPGridTools#Installation. Then run the example CoEPPGridTools#Skimming_Example.

Production of Derived Ntuples

First follow the installation instructions CoEPPNtupGen#Installation. Then run the example CoEPPNtupGen#Examples.

Making final analysis plots

First follow the installation instructions CoEPPPyTools#Installation. Then run the example CoEPPPyTools#Analysis_Example.

Major Change Log

• CoEPPCore-00-01-00, CoEPPD3PDReader-00-01-00, CoEPPTrigTool-00-01-00: Wed Oct 26 14:04:52 CEST 2011
  • All code now put into CoEPP namespace, to avoid compilation issues in external user code (where often classes with the same name may defined, eg. auto generated D3PDObject readers)

-- WillDavey - 19-Oct-2011