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

cmsShow 4.1

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

  • Your fireworks directory is ~/Documents/cmsShow-vNum
  • 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.

2. Assuming successful execution, a CVS environment will now need to be set up in order to obtain the latest particle flow source code. In your fireworks directory (e.g. ~/Documents/cmsShow-vNum) run the following commands:

  cd src/
  export CVS_RSH=ssh
  rm -rf Fireworks/ParticleFlow
  cvs co Fireworks/ParticleFlow

3. Recompile with the new source code.

  cd ../

4. You should now be able to run Fireworks as normal

Current release with FWlite: 4_1_3

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_1_3_FWLITE-slc5_amd64_gcc434.tar.gz
  cd CMSSW_4_1_3_FWLITE


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

ParticleFlow plugins

The ParticleFlow plugins are not built in to this release and hence need to be added.

  cd wherever-you-installed-fwlite-
  cd work/CMSSW_4_1_3_FWLITE/src
  cvs co Fireworks/ParticleFlow

If you get any problems when running the last line of instruction (e.g. "cvs checkout: CVSROOT is set for a GSSAPI access method but your CVS executable doesn't support it.") then try the following instead:

  export CVS_RSH=ssh
  cvs co Fireworks/ParticleFlow

Note: The environment has to be setup like this every time you want to use this module.


If you wish to start Fireworks with the PF configuration file then a new command line argument must be passed.

   ./cmsShow -c pflow.fwc data.root
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.

-- ColinBernet - 08-Feb-2011

Edit | Attach | Watch | Print version | History: r33 | r12 < r11 < r10 < r9 | Backlinks | Raw View | Raw edit | More topic actions...
Topic revision: r10 - 2011-04-23 - 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