Visualization Offline Guide

Contacts

• Conveners: Ianna Osborne
• Hypernews forum: https://hypernews.cern.ch/HyperNews/CMS/get/visualization.html

Introduction

IGUANA goal is to solve all event display needs of CMS for online and offline monitoring, debugging, simulation, reconstruction, and analysis. Make it trivial to use with a professional quality interface design, possibility to use one command, and wizards to help with configurations and data fetching. Also for developers: easy to extend the functionality. Make it available to all collaborators: e.g. well packaged (together with CMSSW) and Web client to avoid local installations.

The basic idea behind IGUANA is that an application is configured at run-time from iglets (a.k.a. plugins). Say, a user wants to display Tracks, (s)he tells IGUANA (in the configuration file) to load the iglet which knows how to display Tracks. The iglets group a set of twigs (a class which knows how to display a type of a data collection). For example, the CSC iglet contains all related to CSC data twigs, such as a VisCSCStripDigiTwig class which displays CSCStripDigi, etc.

IGUANACMS - Interactive Graphics and User ANAlysis for CMS - a SCRAM-based project for CMS specific visualization based on ORCA and OSCAR. The IGUANACMS code has been migrated to the new Event Data Model and is now part of the CMSSW project.

IGUANA - Interactive Graphics for User ANAlysis - in development since 1999. First public presentation during CHEP 2000. Developed by George Alverson, Giulio Eulisse, Ianna Osborne, Shahzad Muzaffar, Lassi Tuura, and Lucas Taylor.

Tutorials

How to check Geant4 geometry description

How to use IGUANA Control Centre

How to configure IGUANA and use active configurable parameters

How to configure which Twigs to load in IGUANA

How to configure IGUANA in Python

How to use grid

How to display Candidates

How to display simulated data

How to explore Event Content

How to debug with IGUANA

How to (auto) print with IGUANA

IGUANA Tutorial at CERN, August 2007

IGUANA Tutorial at CERN, April 2008: How to run IGUANA on CAF data

Documentation

• https://twiki.cern.ch/twiki/bin/view/CMS/WorkBookEventDisplay

Visualization SandBox

IGUANA Meetings

User Feedback

The new features will be introduced after feedback is collected. Please, send your comments to the Visualization hyper-news forum at https://hypernews.cern.ch/HyperNews/CMS/get/visualization.html

Multiple tree browsers

The default event display tree for displaying both CMS event data and geometry is large. The dynamic event content is even larger. The proposed feature separates the first from the latter in two different tree browsers: "CMS Event and Detector" and "Provenance". The text browser is moved to the bottom docking area to allow better visibility of the tables it usually displays.

The "CMS Event and Detector" tree is open by default. To open another tree the user clicks on the tree title, for example, "Provenance". See the snapshots attached.

This picture shows IGUANA event display at startup (MTCC II setup):

This picture shows HCAL barrel and endcap rechits displayed and selected to display the rechits table:

This picture shows "Provenance tree": The former actions to enable and expand it are not needed.

Reconstructed Track Display (GsfTrack and Track)

The GsfTracks are sown in magenta. An ideal helix is drawn from an innermost and an outermost positions based on the corresponding directions. The printout of the GsfTracks is shown beneath.

The Track tracks are shown in blue.

GsfTrackExtra: Inner State Local Parameters:
0.0227301, -0.0465633, 0.808762, -0.223662, 1.75448
0.0199383, -0.0465345, 0.808754, -0.223644, 1.7545
0.0258312, -0.0467502, 0.808761, -0.223499, 1.7545
0.0260459, -0.0467826, 0.808759, -0.22347, 1.75451
0.0267189, -0.0468062, 0.808765, -0.223422, 1.75449
0.0267198, -0.0467973, 0.808758, -0.223451, 1.75451
0.0170117, -0.0465301, 0.808753, -0.223602, 1.7545
0.0165016, -0.0467918, 0.808761, -0.223437, 1.7545
0.0215195, -0.0467918, 0.808761, -0.223437, 1.7545
0.0221628, -0.0465529, 0.808756, -0.223671, 1.7545
0.0265298, -0.0468217, 0.808769, -0.22337, 1.75448
0.0243262, -0.0467219, 0.80876, -0.223486, 1.7545
GsfTrackExtra: Outer State Local Parameters:
0.028701, -0.0024154, -0.808029, 2.72178, 5.40257
0.0306276, -0.00214451, -0.808029, 2.72114, 5.40272
0.0288776, -0.00232003, -0.808006, 2.72123, 5.40159
0.0280485, -0.00253584, -0.808031, 2.72211, 5.40261
0.0281577, -0.00248797, -0.808027, 2.72183, 5.40225
0.0295314, -0.00221284, -0.808026, 2.72114, 5.40242
0.0417981, -0.00237857, -0.808008, 2.72206, 5.40193
0.0365081, -0.00261901, -0.808027, 2.72239, 5.40239
0.0353425, -0.00250713, -0.808025, 2.72208, 5.40225
0.0284681, -0.00253532, -0.808008, 2.72219, 5.40185
0.028966, -0.00247312, -0.808031, 2.72198, 5.40263
0.0285511, -0.00246275, -0.808009, 2.72186, 5.40217
GsfTrackExtra: Sign of local P_z at outermost state: -1
Innermost state is OK
Outermost state is OK
GsfTrackExtra: Inner State Local Parameters:
-0.0122965, 0.0176972, 1.90946, 0.0787932, 0.126954
-0.0110625, 0.0168945, 1.90946, 0.0804375, 0.126919
-0.0161217, 0.0179424, 1.90946, 0.0786576, 0.126951
-0.0158289, 0.0179153, 1.90946, 0.0786211, 0.126954
-0.0114335, 0.0168241, 1.90946, 0.0805902, 0.126913
-0.0170772, 0.0179681, 1.90946, 0.0786233, 0.126949
-0.00375109, 0.0169369, 1.90946, 0.0796434, 0.126943
-0.00300313, 0.0174158, 1.90946, 0.0793201, 0.126933
-0.00540071, 0.0163279, 1.90949, 0.0810059, 0.126844
-0.00921955, 0.0171213, 1.90947, 0.0796125, 0.126921
-0.00603442, 0.0167686, 1.90948, 0.0804967, 0.126871
-0.00555402, 0.0171267, 1.90945, 0.0794501, 0.126947
GsfTrackExtra: Outer State Local Parameters:
-0.0293957, 0.0277905, -0.523889, -1.80144, 5.32493
-0.0268773, 0.0274208, -0.523893, -1.79943, 5.32119
-0.0313092, 0.0279622, -0.523867, -1.80159, 5.32303
-0.0290053, 0.0277974, -0.523925, -1.80135, 5.32456
-0.0299584, 0.027902, -0.523902, -1.80211, 5.32571
-0.0291696, 0.0278014, -0.523895, -1.80162, 5.32611
-0.0505334, 0.0277446, -0.523871, -1.80078, 5.32213
-0.0348439, 0.0277892, -0.52392, -1.80091, 5.32405
-0.0473936, 0.0275673, -0.523941, -1.80106, 5.32633
-0.0305686, 0.0278488, -0.523881, -1.80144, 5.32401
-0.0344365, 0.0277065, -0.523879, -1.80083, 5.32298
-0.0287801, 0.0276547, -0.523866, -1.80039, 5.32086
GsfTrackExtra: Sign of local P_z at outermost state: -1
Innermost state is OK
Outermost state is OK

The recipe for CMSSW_1_6_8 is as follows:

> project CMSSW
> scramv1 p CMSSW CMSSW_1_6_8
> cd CMSSW_1_6_8/src
> cvs co -r V02-03-05 VisReco/VisTracker
> cvs co VisDocumentation/VisTutorial
> scramv1 b
> cd VisDocumentation/VisTutorial
> (edit cmssw-Darren.cfg to point to your .root file)
> iguana cmssw-Darren.cfg

The reconstructed tracks (Track and GsfTrack) should be selected from the "Event data Collections" browser. See How to explore Event Content tutorial for more information.

"Show all Tracks" option has been disabled due to another problem related to a difference between asking for all the tracks with getManyByType and asking for a specific collection with getMany. As a consequence, the "Tracker event"->"Rec Tracks" branch in "CMS Event and Detector" will not display all reconstructed (Track) tracks. The individual collections should be selected from the "Event data Collections" browser.

Glossary

NURB (NonUniform Rational B-spline) A type of b-spline that is very flexible. NURB curves can represent any shape from a straight line to a circle or ellipse with very little data. They can also be used for guiding animation paths, for approximating data and for controlling the shapes of 3D surfaces. NURBs are known for their ability to control the smoothness of a curve.

Spline In computer graphics, a smooth curve that runs through a series of given points. The term is often used to refer to any curve, because long before computers, a spline was a flat, pliable strip of wood or metal that was bent into a desired shape for drawing curves on paper.

B-spline In computer graphics, a curve that is generated using a mathematical formula that assures continuity with other b-splines.

Review status

Responsible: IannaOsborne
Last reviewed by: Never reviewed