PAT logo

PAT - Physics Analysis Toolkit


The Physics Analysis Toolkit (PAT) is a high-level analysis layer enabling the development of common analysis efforts across and within Physics analysis groups. It aims at fulfilling the needs of most CMS analyses, providing both ease-of-use for the beginner and flexibility for the advanced user.

The PAT runs in the CMS software framework (CMSSW and FWLite) and it makes use of the algorithms provided by both Offline and Physics object groups.

This documentation contains:

  • A few recipes for a quick start (but reading further is recommended).
  • A brief description of the overall structure of the PAT.
  • More details about the actual content of the PAT.
  • Contact names from PAT, PAG and POGs.
  • Links to various example analyses.

Other sources of documentation:

How to start

Below a number of recipes and examples for users are provided (to be read after the full documentation smile ).

Design of the PAT


The PAT workflow is divided in a series of layers as shown on the figure below:

  • Layer 0 performs the "cleaning" tasks on the standard reconstructed object (in AOD or RECO formats), computes related information (e.g., Monte Carlo and trigger matching), and takes care of the low-level handling of references.
  • Layer 1 collapses the output of layer 0 into compact objects containing all the necessary information.
  • Layer 2 performs event-hypothesis dependent tasks: this is where the analysis starts.

The PAT workflow

PAT workflow

The PAT consists of framework plugin modules: cleaners for layer 0, producers for layer 1. These plugins themselves call standalone algorithms and helper classes.


Tasks performed inside the PAT

PAT configuration defaults

Details of the default PAT configuration can be found in the links below.

Release configuration view
1_6_12 by object by layer
2_1_X by object by layer

Many thanks to KiraGrogg from the EWK group for putting these pages together.

Reducing the event size in PAT

You want to produce smaller files? Recipes for managing the event size in PAT are given in Event Size Management in the PAT.

Contact names

N.B. Please use the Physics Tools hypernews for any questions, requests, etc.

PAT main developers

Task Names
Layer 0 & 1 GiovanniPetrucciani (gpetrucc), StevenLowette (lowette)
MC matching WolfgangAdam (adamwo)
Trigger information VolkerAdler (vadler)
StarterKit SalvatoreRappoccio (srappocc)
Coordination FredericRonga (fronga)

POG contacts

Group Contacts
EgammaPOG Roberto Salerno, Andrew Askew
JetMET Christian Autermann, Attilio Santocchia, Roger Wolf
Particle Flow / tau Colin Bernet (cbern)
MuonPOG Dmytro Kovalskyi (dmytro)
b-tag / vertex Francisco Yumiceva

PAG Examples and contact persons

Group Contacts Link to PAT analysis
B & heavy flavour Keith Ulmer B→Ksμμ analysis
Electroweak Francesco Fabozzi CSA08 Z→μμ analysis
Exotica Kai-Feng Chen b'→tW analysis, HEEP
Heavy Ions Yetkin Yilmaz  
Higgs Nicola de Filippis HiggsPAT in Higgs WGSoftware
Forward Physics Dilson de Jesus Damiao  
QCD Vasu Chetluru  
SUSY John Jones, Jean-Roch Vlimant SusyPat
Top quark Sebastian Naumann Top Analysis examples

Developer Area

Below links to document oriented to PAT developers

Review status

Reviewer/Editor and Date Comments
FredericRonga - 05 Sep 2008 Revamping of the entry page: more synthetic, with examples' section
FredericRonga - 21 Apr 2008 First editing: preliminary content...

Topic attachments
I Attachment History Action Size Date Who Comment
PDFpdf PAT-workflow.pdf r1 manage 40.8 K 2008-04-24 - 17:38 FredericRonga PAT workflow schema (PDF file)
PNGpng PAT-workflow.png r2 r1 manage 200.7 K 2008-04-22 - 09:32 FredericRonga PAT workflow schema
JPEGjpg pat_logo.jpg r1 manage 3.4 K 2008-05-13 - 22:21 SalvatoreRRappoccio  
PNGpng pat_logo.png r1 manage 10.8 K 2008-05-15 - 09:08 FredericRonga PAT logo (cropped)
Edit | Attach | Watch | Print version | History: r62 < r61 < r60 < r59 < r58 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r62 - 2011-10-14 - SebastianNaumann
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    CMSPublic All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2023 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback