ParticleFlowFireWorks < CMSPublic

CMSPublic Web>SWGuide>WorkBook>WorkBookParticleFlow>ParticleFlowFireWorks (2019-10-22, CiliciaUzzielPerez) (raw view)

---+ 3.4.4 Studying Particle Flow with Fireworks

%COMPLETE5%
%BR%

%TOC{title="contents"}%

This page is under construction. An archive of an older version is found in [https://twiki.cern.ch/twiki/bin/view/CMSPublic/ParticleFlowFireWorks?rev=27][in this page]].

---++ Overview

This page explains how to set up an experimental version of %FIREWORKS%, to study the particle flow reconstruction. This version of %FIREWORKS% can be used to create a display of the particles created by the particle flow algorithm:
   * PFCandidates
   * PFJets

In addition to this, you can also use a modified version of %FIREWORKS% which is designed to help you understand how the particle flow algorithm identifies and reconstructs particles, using the following inputs:
   * ECAL and HCAL rechits
   * PFClusters
   * Tracks, with their extrapolated position in the calorimeters
   * PFBlocks

---++ Installation recipes and Examples

You can find the latest recipes to install FireWorks [[https://twiki.cern.ch/twiki/bin/view/CMSPublic/WorkBookFireworks][here]].
You can also find the instructions on how to run FireWorks [[https://twiki.cern.ch/twiki/bin/view/CMSPublic/WorkBookFireworks][there]].

---++ How-to

#TheConfigs
---+++ A Quick Example

You can quickly run a sample dataset. In this workbook we'll be using CMSSW_10_2_X data. Follow the instructions for installation  [[https://twiki.cern.ch/twiki/bin/view/CMSPublic/WorkBookFireworks][here]]. Do not forget to install the header files. For Mac OS Mojave, you'd have to download the package, install the header files and then run the hdiutil attach command. 


<verbatim>
open /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg
hdiutil attach fireworks-9.4-1.highsierra.sparseimage 
cd /Volumes/Fireworks/
./cmsShow data.root
</verbatim>

At the top of the window, you can change navigate the different event by changing the event number. There is also a filter field that allows you to select for example events with muons whose transverse momentum is greater than 20 GeV. You can click on the filter button and type in the event filter expression as "$Muons.pt()>20". If you apply "$Tracks.pt()>1$", you will see that only 9 out of the 15 events are left. 

At the left side of the window you should see a summary of the object collections that are shown on the event display. You can check and uncheck the tick boxes to control which collections get displayed. You can also click on the "Add collection" in order to display more collections not currently shown. 

The different viewing windows show the rho-z, rho-phi, and eta-phi projections. Once you are happy with the configurations, you have the option to save the images by clicking on the information button.


---+++ How to load a config file at runtime

In the main interface go to _File_ and select _Load Configuration_ OR, press *Ctrl* and *l* simultaneously. In the new window navigate to, and then open the desired config file (e.g. _pflow.fwc_ or _pflow_algo.fwc_). 


#BlockDisplay
---+++ How to study PF Blocks
In order to study the PF Block objects clearly it's best if you don't display them at the same time as the PF Clusters and/or PF Tracks. Use the collection controller on the left hand side of the main %FIREWORKS% window in order to change a collections visibility. This is done by either ticking or un-ticking the box at the side of the relevant collection.
In this case, you should un-tick the boxes by the side of "PF Tracks", "PF Cluster - ECAL" and "PF Cluster - HCAL" when displaying PF Block objects.

The visibility options are changed because drawing conflicts occur if the aforementioned objects are displayed together i.e. objects will overlap and it will become difficult to select/view any one in particular.

---++ Wish-list & bug reports

This section is used to list bugs that are currently known as well as features that we are currently working towards getting implemented.

---+++ Known Bugs
   * Some of the track objects aren't extrapolated far enough to reach the endcaps
   * Ecal Rechit display in PF Rho Phi view isn't updated correctly after a filter is applied
   * If PFBlock's are displayed with PFTrack and/or PFCluster objects then object overlap may occur. This will make it difficult to select between these objects. See the [[#BlockDisplay][How-to]] for information on studying PFBlocks.

---+++ Bug Fixes
This is a list of known bugs that can be fixed if you use the second [[#RecipeTwo][installation recipe]] and compile the source code acquired from cvs.

---+++ The Wish-list (feature requests)

<!--
Preferences Variables
   * Set FIREWORKS = [[WorkBookFireworks][Fireworks]]
   * Set SCRAM = [[https://twiki.cern.ch/twiki/bin/view/CMSPublic/SWGuideScram#CmsswSCRAMBuildFlags][scram]]
-->

-- Main.ColinBernet - 08-Feb-2011

#ReviewStatus
---++ Review status

<!-- Add your review status in this table structure with 2 columns delineated by three vertical bars; please DON'T remove the spaces between the vertical bars and the asterisks in the first line; it would break the PDF rendering! -->

| *Reviewer/Editor and Date (copy from screen)* | *Comments* |
| Uzziel Perez - 22 June 2019 | Minor updates to installation recipes |
| AntonioMorelosPineda - 17 Apr 2013 | Upgrade to workbook style |
| Main.AljaMrakTadel  -11 Jul 2011 | Created. | 

%TWISTY{mode="div" showlink="Detailed comments 17-Apr-2013&nbsp;" hidelink="Hide&nbsp;"  firststart="hide"
showimgright="%ICONURLPATH{toggleopen-small}%" 
hideimgright="%ICONURLPATH{toggleclose-small}%"}%

Upgrade to workbook style, A.Morelos,17-Apr-2013

%ENDTWISTY%

%RESPONSIBLE% Main.AljaMrakTadel %BR%
<!-- %REVIEW% Main.AljaMrakTadel - 11 Jul 2012 -->
%REVIEW% Main.AntonioMorelosPineda - 17 Apr 2013

Attachments

Topic attachments
I	Attachment	History	Action	Size	Date	Who	Comment
png	AddCollection_AltCand.png	r1	manage	150.0 K	2011-07-26 - 12:23	UnknownUser	Add Collection dialog for Alt Candidates
png	altCandidate_display.png	r1	manage	145.6 K	2011-07-26 - 12:23	UnknownUser	Alternative Candidate display
fwc	pflow.fwc	r1	manage	51.6 K	2019-09-09 - 05:40	CiliciaUzzielPerez
fwc	pflow_algo.fwc	r1	manage	51.3 K	2019-09-09 - 05:40	CiliciaUzzielPerez
png	pflow_algo_fwc.png	r1	manage	205.3 K	2011-05-26 - 18:16	UnknownUser	A screenshot after loading Fireworks with the pflow_algo.fwc config file
png	pflow_fwc.png	r1	manage	218.4 K	2011-05-26 - 17:24	UnknownUser	A screenshot after loading Fireworks with the pflow.fwc config file