Studying Particle Flow with Fireworks


This page explains how to set up an experimental version of Fireworks, to study the particle flow reconstruction.

The modified version of Fireworks is able to display

  • ECAL and HCAL rechits
  • PFClusters
  • Tracks, with their extrapolated position in the calorimeters
  • PFBlocks
  • PFCandidates
  • PFJets
It is a tool to understand how the particle flow algorithm identifies and reconstructs particles, using these inputs.

To display the particles created by the particle flow algorithm, just use the standard version of Fireworks.

Installation recipes

Two recipes

  • getting the binaries
    • advantages
    • disadvantages
  • getting the source
    • advantages
    • disadvantages

cmsShow 4.2

1. Download the latest stable version of Fireworks, follow the standard installation instructions and test program execution. The following is assumed:

  • You are either:
    • working on a mac with xcode installed,
    • using an slc5 terminal or have access to an slc5 terminal (e.g. ssh
    • using the chroot method explained here.

2. The ParticleFlow package is included in the cmsShow 4.2 release so you should now be able to run Fireworks as normal and have access to all ParticleFlow functionality. Enjoy!

Current release with FWlite: 4_2_3

This recipe is about:

  • installing FWLite
  • getting the FW code from cvs
  • compiling

Most information about this can be found at the standard Fireworks twiki page but the basic instructions for installation are also shown below.


  tar xzf CMSSW_4_2_3_FWLITE-slc5_amd64_gcc434.tar.gz
  cd CMSSW_4_2_3_FWLITE


  curl -OL
  tar xzf CMSSW_4_2_3_FWLITE-osx106_amd64_gcc421.tar.gz
  cd CMSSW_4_2_3_FWLITE

The ParticleFlow package is included in this release and so you should have access to the ParticleFlow functionality without doing anything in addition to the above steps.


How to get a display of PFCandidates and particle-flow based physics objects

  • Simple common how to for both recipes
  • Each recipe should explain how to get the pflow.fwc file (use links) [SIMON, in particular review pflow.fwc]

How to get a display of the particle flow inputs

  • Remind what are the particle flow inputs, and how the PF algorithm works. Links to the particle flow algorithm [COLIN]
  • Simple how-to showing how to start with another pflow_algo.fwc, to be created [SIMON]

If you wish to start Fireworks with the PF configuration file then a few more steps need to be followed. Firstly, you will need access to the CMSSW repositories.

Now, in the 'src' directory (CMSSW_4_2_3_FWLITE/work/CMSSW_4_2_3_FWLITE/src/) run the following commands:

   cvs co Fireworks/Core/macros/pflow.fwc
   mv Fireworks/Core/macros/pflow.fwc ../../../
   cd ../../../

You should now be back in the CMSSW_4_2_3 directory and ready to run cmsShow with your newly acquired configuration file.

   ./cmsShow -c pflow.fwc
This method can also be used to pass other configuration files to Fireworks upon start-up. e.g.
   ./cmsShow -c example.fwc data.root 
The particle flow configuration file can also be loaded during runtime. In the main Fireworks interface go to File and select Load Configuration OR, press Ctrl and l simultaneously. In the new window open pflow.fwc.

Compiling 4_2_3_FWLite Release

Most of that is part of the second recipe

In order compile there are a few prerequisites; you are either:

  • working on a mac with xcode installed,
  • using an slc5 terminal, have access to an slc5 terminal (e.g. ssh
  • using the chroot method explained here.
You must also have setup environment variables that point to the CMSSW repositories (see Acessing CMSSW Repositories ).

In the 'CMSSW_4_2_3_FWLite' directory(e.g. ~/Documents/CMSSW_4_2_3_FWLite) run the following commands:

   cd work/CMSSW_4_2_3_FWLite/src/
   cvs co Fireworks/ParticleFlow
   scram b

Information on scram

Accessing CMSSW Repositories

Also part of the second recipe

In order to access the CMSSW repositories you must set two environment variables NB: It is assumed that you have installed the cvs software on your machine!

   export CVS_RSH=ssh

-- ColinBernet - 08-Feb-2011

Edit | Attach | Watch | Print version | History: r33 | r15 < r14 < r13 < r12 | Backlinks | Raw View | Raw edit | More topic actions...
Topic revision: r13 - 2011-05-25 - ColinBernet



    • 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-2019 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback