4.2.4 Physics Analysis Toolkit (PAT): Tutorial

Contents

• Introduction
• Lectures
• Exercises
• More Exercises
• Review status

Introduction

There exists a series of PAT Tutorials, which are held at cern. You can find the next PAT Tutorial announced on SWGuidePAT. Have a look at indico and the CMS elearning area to learn more about the Tutorials that have already taken place. On this page you can find a set of lectures, documentation and exercises for your personal studies. The following pages might be of help before getting started:

• WorkBookPATGlossary: Learn more about commonly used PAT expressions.
• WorkBookBasicCPlusPlus: Find a good start into the basics of C++ needed for this Tutorial.
• WorkBookConfigFileIntro: Find a good summary about the python configuration language.
• WorkBookPATDataFormats: Get an overview of the PAT Data Formats.
• WorkBookPATWorkflow: Get an overview of the PAT Workflow.
• WorkBookPATConfiguration: Learn how to configure PAT Data Formats and Workflow.
• WorkBookTroubleShooting: In case of trouble when compiling/running modules.

If you have more question or need more of support have a look at SWGuidePAT#Support.

Lectures

You can find a list of recent lectures and documentation pages about PAT below:

1. Lecture 1.1: PAT introduction. (Jul2013)
2. Lecture 1.2: Learn how to access pat::Candidates with an EDAnalyzer or FWLite executable. (Jul2013)
3. Lecture 2.1: Learn more about how PAT supports object cross cleaning. (Jul2013)
4. Lecture 2.2: Learn more about how to configure the workflow and event content of a pat::Tuple. (Jul2013)
5. Lecture 3.2: Learn more about how PAT supports matching to trigger objects or Monte Carlo truth information. (Jul2013)
6. Lecture 4.1: Learn something about triggers, especially HLT, in CMS from the software point of view. (Jul2013)
7. Lecture 4.2: Learn more about the production, configuration and use of the pat::TriggerEvent. (Jul2013)
8. Lecture 4.3: Learn more about trigger matches to pat::Candidates. (Jul2013)
9. Lecture 5: Learn more about access to particle flow objects in PAT (PFBRECO). (Jul2013)

These lectures are being updated for each PAT Tutorial every ~6 Month. The date of last update is indicated in brackets.

Exercises

You can find a set of TWiki based Tutorial Exercises below. All exercises require:

Requirements

• A working cern account.
• At least 2GB of free space in your afs directory. In case you need some more space increase your quota here: CERN Resources Portal: AFS Workspaces
• Some knowledge of C++. Have a look to WorkBookBasicCPlusPlus to get a quick overhaul of the C++ you need.
• Some minimal knowledge of CMSSW.

Note:

This web course that is presented below is part of the PAT Tutorial, which takes regularly place at cern and in other places. When following the PAT Tutorial the answers of questions marked in RED on these TWiki pages should be filled into the exercise form that has been introduced at the beginning of the tutorial. Also the solutions to the Exercises found on these TWiki pages should be filled into the form. The exercises are marked in three colours, indicating whether this exercise is basic (obligatory), continuative (recommended) or optional (free). The colour coding is summarized in the table below:

Color Code	Explanation
	Basic exercise, which is obligatory for the PAT Tutorial.
	Continuative exercise, which is recommended for the PAT Tutorial to deepen what has been learned.
	Optional exercise, which shows interesting applications of what has been learned.

Basic exercises ( ) are obliged and the solutions to the exercises should be filled into the exercise form during the PAT Tutorial.

Pre-exercises:

If you are feeling unsafe about how to do the preparation you have to do for the exercises indicated below you can follow the

• WorkBookPATTutorialPreExercises (responsible: Heiner Tholen) (Jul2014) .

Week exercise

For the Tutorial there is an over-spanning exercise from the area of Top-Physics that the participants should work on during the week. You can find this example on WorkBookPATWeekExercise (responsible: Felix Hoehle) (Jul2014) .

PAT Tutorial Exercises:

• Week exercise: In this exercise you should apply learnt knowledge on a simplified physics problem: WorkBookPATWeekExercise.
• Monday
  • [Exercise 01]: WorkBookPATDocNavigationExercise: Use of the PAT documentation
    (responsible: Till Arndt, Justin Pilot) (Jun2015) .
  • [Exercise 02]: WorkBookPATTupleCreationExercise: How to create a standard PAT tuple
    (responsible: Till Arndt, Justin Pilot) (Jun2015) .
  • [Exercise 03]: SWGuidePATConfigExercise: More detailed exercise on how to configure your own PAT tuple
    (responsible: Till Arndt, Justin Pilot) (Jun2015) .
  • [Exercise 04]: WorkBookPATAccessExercise: How to access objects from a standard PAT tuple
    (responsible: Till Arndt, Justin Pilot) (Jun2015) .
• Tuesday:
  • [Exercise 05]: SWGuidePATCrossObjectCollectionExercise: More detailed exercise on object disambiguation support in PAT
    (responsible: Roger Wolf, Pavel Jez) (Jul2014) .
  • [Exercise 06]: SWGuidePATAnalysisTasksExercise: More detailed exercise on embedding extra information in PAT
    (responsible: Roger Wolf, Pavel Jez) (Jul2014) .
• Wednesday:
  • [Exercise 07]: SWGuidePATFWLiteMiniaodExercise: exercise on FWLite and MINIAOD
    (responsible: Heiner Tholen (Jul2015) . (Before the june 2015 tutorial, there was a dedicated exercise on the PF2PAT workflow, SWGuidePATPF2PATExercise.)
• Thursday:
  • [Exercise 08]: SWGuidePATMCMatchingExercise: More detailed exercise on the support of MC truth matching in PAT
    (responsible: Norraphat Srimanobhas) (Jul2015) .
  • [Exercise 09]: WorkBookPATTriggerExercise: more detailed exercise on the consideration of HLT paths in analysis
    (responsible: Volker Adler, Sudhir Malik, Norraphat Srimanobhas) (Jul2014) .
  • [Exercise 10]: SWGuidePATTriggerEventExercise: more detailed exercise on the creation and configuration of the PAT trigger event
    (responsible: Taejeong Kim, Norraphat Srimanobhas) (Jul2014) .
• Friday:
  • [Exercise 11]: SWGuidePATTriggerMatchExercise: more detailed exercise on the support of trigger object matching in PAT
    (responsible: Taejeong Kim, Norraphat Srimanobhas) (Jul2014) .

The WorkBookPAT exercises form a basic set of what you have to know about the production of pat::Tuples and the access to pat::Candidates. The SWGuidePAT exercises are more comprehensive demonstrations and examples of the features and the use of PAT.

More Exercises

You can find some more comprehensive examples of the use of PAT within special POG and PAG applications below:

PAG Applications of PAT:

In this section you can find a set of links to tutorials illustrating the typical use of PAT within your Physics Analysis Group (PAG):

• WorkBookPATExampleQCD: Analysis example for QCD
  (responsible: Keith Rose). (Sep2010)
• WorkBookPATExampleTopQuarks: Analysis example for Top Physics outdated
  (responsible: Roger Wolf). (Apr2011)
• WorkBookPATExampleSUSY: Analysis example for SUSY
  (responsible: Niklas Mohr). (Sep2010)
• WorkBookPATExampleZMuMu: Analysis examples based on Z-->μμ event
  (responsible: Roger Wolf). (Sep2010)
• WorkBookPATExampleElectroweak: Analysis example for EWK Physics
  (responsible: Francesco Fabozzi).
• WorkBookPATExampleExotica: Analysis example for Exotica
  (responsible: Kai-Feng Chen).
• WorkBookPATExampleHiggs: Analysis example for Higgs Physics
  (responsible: Nicola de Filippis).

POG Applications of PAT:

• WorkBookPATExampleJet: how to do a simple analysis with pat::Jets. (Sep2010)
• WorkBookPATExampleMET: how to do a simple analysis with pat::MET.
• WorkBookPATExamplePhoton: how to do a simple analysis with pat::Photons.
• WorkBookPATExampleElectron: how to do a simple analysis with pat::Electrons.
• WorkBookPATExampleMuon: how to do a simple analysis with pat::Muons.
• WorkBookPATExampleTau: how to do a simple analysis with pat::Taus.
• WorkBookPATExampleTrigger: how to do a simple analysis with the pat::TriggerEvent.
• WorkBookPATExampleTrackBJet: how to do a simple analysis including tracking, vertexing and b-tagging.

Note:

These tutorials will cover the typical but only basic use of PAT in a simple POG/PAG specific application. They provide you with the following information:

• A small number of EDAnalyer(s) or EDProducer(s) of manageable complexity.
• A workflow, which highlights one or two PAG specific analysis aspects.
• The typical content of pat::Candidate, which your PAG has agreed upon.
• A short summary how the pat::Candiates were configured (when different from the PAT default).
• The PAG specific use of pat::Candidates and tools (e.g. certain aspects of cleaning, or a special use of isolation variables).
• Links to further PAG specific information.

The examples may refer to other parts of official code.

Review status

Show  Hide