Difference: SWGuideVisualization (1 vs. 32)

Revision 312009-01-27 - KatiLassilaPerini

Line: 1 to 1
Changed:
<
<
META TOPICPARENT name="SWGuide04AnalysisAndSoftware"
>
>
META TOPICPARENT name="SWGuide"
 
<!-- PDFSTART -->

Visualization Offline Guide

Complete: 3

Revision 292008-05-30 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide04AnalysisAndSoftware"
<!-- PDFSTART -->

Visualization Offline Guide

Line: 33 to 33
 
Added:
>
>
 
Line: 43 to 44
 

Visualization SandBox

Changed:
<
<
Area in free format for items that the groups wish to add: meetings, to do lists, links etc
>
>
IGUANA Meetings
 

User Feedback

Revision 282008-04-28 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide04AnalysisAndSoftware"
<!-- PDFSTART -->

Visualization Offline Guide

Line: 34 to 34
 
Added:
>
>
 

Documentation

Revision 272008-02-01 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide04AnalysisAndSoftware"
<!-- PDFSTART -->

Visualization Offline Guide

Line: 149 to 149
  "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.
Added:
>
>

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.

 
<!-- PDFSTART -->

Revision 262008-01-18 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide04AnalysisAndSoftware"
<!-- PDFSTART -->

Visualization Offline Guide

Line: 67 to 67
 

Reconstructed Track Display (GsfTrack and Track)

Changed:
<
<
It is observed that a local to global conversion of a direction in an innermost/outermost state gives inconsistent results. The picture beneath shows the GsfTracks in magenta. An ideal helix is drawn from an innermost and an outermost positions based on the corresponding directions. The reconstructed GsfTrack on the left shows how it should look like, the reconstructed GsfTrack on the right shows opposite directions for its innermost and outermost states. The printout of the GsfTracks is shown beneath. Note the sign of local P_z.

GUI

>
>
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.
Deleted:
<
<
This is the same event, but aligned with an YZ plane. The Z axis goes from left to right, e.g. a global P_z in the outermost state should be negative for both tracks.

GUI

 
GsfTrackExtra: Inner State Local Parameters:
0.0227301, -0.0465633, 0.808762, -0.223662, 1.75448

Line: 138 to 132
 Outermost state is OK
Changed:
<
<
The problem occurs in CMSSW_1_6_8.

To be able to reproduce it in iguana:

>
>
The recipe for CMSSW_1_6_8 is as follows:
 
> project CMSSW
> scramv1 p CMSSW CMSSW_1_6_8

Line: 187 to 178
 
META FILEATTACHMENT attachment="iguana-gui-trees.jpg" attr="" comment="" date="1177579413" name="iguana-gui-trees.jpg" path="iguana-gui-trees.jpg" size="77804" stream="iguana-gui-trees.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="iguana-gui-hcal-rechits.jpg" attr="" comment="" date="1177579435" name="iguana-gui-hcal-rechits.jpg" path="iguana-gui-hcal-rechits.jpg" size="115705" stream="iguana-gui-hcal-rechits.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="iguana-gui-provenance.jpg" attr="" comment="" date="1177579453" name="iguana-gui-provenance.jpg" path="iguana-gui-provenance.jpg" size="126026" stream="iguana-gui-provenance.jpg" user="Main.yana" version="1"
Deleted:
<
<
META FILEATTACHMENT attachment="iguana-gsf-tracks.png" attr="" comment="" date="1200646063" name="iguana-gsf-tracks.png" path="iguana-gsf-tracks.png" size="64463" stream="iguana-gsf-tracks.png" user="Main.IannaOsborne" version="1"
META FILEATTACHMENT attachment="iguana-gsf-tracks-z.png" attr="" comment="" date="1200647570" name="iguana-gsf-tracks-z.png" path="iguana-gsf-tracks-z.png" size="64933" stream="iguana-gsf-tracks-z.png" user="Main.IannaOsborne" version="1"

Revision 252008-01-18 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide04AnalysisAndSoftware"
<!-- PDFSTART -->

Visualization Offline Guide

Line: 65 to 65
 GUI The former actions to enable and expand it are not needed.
Added:
>
>

Reconstructed Track Display (GsfTrack and Track)

It is observed that a local to global conversion of a direction in an innermost/outermost state gives inconsistent results. The picture beneath shows the GsfTracks in magenta. An ideal helix is drawn from an innermost and an outermost positions based on the corresponding directions. The reconstructed GsfTrack on the left shows how it should look like, the reconstructed GsfTrack on the right shows opposite directions for its innermost and outermost states. The printout of the GsfTracks is shown beneath. Note the sign of local P_z.

GUI

The Track tracks are shown in blue.

This is the same event, but aligned with an YZ plane. The Z axis goes from left to right, e.g. a global P_z in the outermost state should be negative for both tracks.

GUI

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 problem occurs in CMSSW_1_6_8.

To be able to reproduce it in iguana:

> 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.

 
<!-- PDFSTART -->

Line: 94 to 187
 
META FILEATTACHMENT attachment="iguana-gui-trees.jpg" attr="" comment="" date="1177579413" name="iguana-gui-trees.jpg" path="iguana-gui-trees.jpg" size="77804" stream="iguana-gui-trees.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="iguana-gui-hcal-rechits.jpg" attr="" comment="" date="1177579435" name="iguana-gui-hcal-rechits.jpg" path="iguana-gui-hcal-rechits.jpg" size="115705" stream="iguana-gui-hcal-rechits.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="iguana-gui-provenance.jpg" attr="" comment="" date="1177579453" name="iguana-gui-provenance.jpg" path="iguana-gui-provenance.jpg" size="126026" stream="iguana-gui-provenance.jpg" user="Main.yana" version="1"
Added:
>
>
META FILEATTACHMENT attachment="iguana-gsf-tracks.png" attr="" comment="" date="1200646063" name="iguana-gsf-tracks.png" path="iguana-gsf-tracks.png" size="64463" stream="iguana-gsf-tracks.png" user="Main.IannaOsborne" version="1"
META FILEATTACHMENT attachment="iguana-gsf-tracks-z.png" attr="" comment="" date="1200647570" name="iguana-gsf-tracks-z.png" path="iguana-gsf-tracks-z.png" size="64933" stream="iguana-gsf-tracks-z.png" user="Main.IannaOsborne" version="1"

Revision 242008-01-16 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide04AnalysisAndSoftware"
<!-- PDFSTART -->

Visualization Offline Guide

Line: 30 to 30
 
Added:
>
>
 

Revision 232008-01-16 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide04AnalysisAndSoftware"
<!-- PDFSTART -->

Visualization Offline Guide

Line: 31 to 31
 
Added:
>
>
 

Documentation

Revision 222008-01-16 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide04AnalysisAndSoftware"
<!-- PDFSTART -->

Visualization Offline Guide

Line: 30 to 30
 
Added:
>
>
 

Documentation

Revision 202007-12-19 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide04AnalysisAndSoftware"
<!-- PDFSTART -->

Visualization Offline Guide

Line: 28 to 28
 
Added:
>
>
 

Documentation

Revision 192007-12-17 - JennyWilliams

Line: 1 to 1
 
META TOPICPARENT name="SWGuide04AnalysisAndSoftware"
Added:
>
>
<!-- PDFSTART -->
 

Visualization Offline Guide

Complete: 3
Line: 32 to 33
 

Documentation

Added:
>
>
<!-- PDFSTOP -->
 

Visualization SandBox

Line: 58 to 60
 GUI The former actions to enable and expand it are not needed.
Added:
>
>
<!-- PDFSTART -->
 

Review status

Changed:
<
<
<!-- Add your review status in this table structure with 2 columns delineated by three vertical bars -->

Reviewer/Editor and Date (copy from screen) Comments
>
>
Reviewer/Editor and Date Comments
 
KatiLassilaPerini - 20 Apr 2007 created template page
Deleted:
<
<
<!-- In the following line, be sure to put a blank space AFTER your name; otherwise the Summary doesn't come out right. -->
 Responsible: IannaOsborne
Changed:
<
<
Last reviewed by:
>
>
Last reviewed by: Never reviewed

<!-- PDFSTOP -->
 
META FILEATTACHMENT attachment="geom-sens-1.jpg" attr="" comment="" date="1177321124" name="geom-sens-1.jpg" path="geom-sens-1.jpg" size="182445" stream="geom-sens-1.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="geom-sens-2.jpg" attr="" comment="" date="1177321147" name="geom-sens-2.jpg" path="geom-sens-2.jpg" size="184600" stream="geom-sens-2.jpg" user="Main.yana" version="1"

Revision 182007-12-13 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide04AnalysisAndSoftware"

Visualization Offline Guide

Complete: 3
Line: 26 to 26
 
Added:
>
>
 

Documentation

Revision 172007-12-12 - JennyWilliams

Line: 1 to 1
Changed:
<
<
META TOPICPARENT name="SWGuide"
>
>
META TOPICPARENT name="SWGuide04AnalysisAndSoftware"
 

Visualization Offline Guide

Complete: 3

Revision 162007-10-22 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide"

Visualization Offline Guide

Complete: 3
Line: 25 to 25
 
Added:
>
>
 

Documentation

Revision 142007-09-17 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide"

Visualization Offline Guide

Complete: 2
Line: 25 to 25
 
Added:
>
>
 

Documentation

Revision 132007-08-23 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide"

Visualization Offline Guide

Complete: 2
Line: 12 to 12
 

Introduction

Changed:
<
<
IGUANA - Interactive Graphics for User ANAlysis - is a SCRAMbased project, development since 1999. First public presentation during CHEP 2000. Developed by George Alverson, Giulio Eulisse, Ianna Osborne, Shahzad Muzaffar, Lassi Tuura, and Lucas Taylor.
>
>
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.
 
Changed:
<
<
IGUANACMS - Interactive Graphics and User ANAlysis for CMS - a SCRAM-based project for CMS specific visualization. Now part of the CMSSW project.
>
>
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.

 
Deleted:
<
<
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.
 

Tutorials

Revision 122007-07-04 - JennyWilliams

Line: 1 to 1
 
META TOPICPARENT name="SWGuide"

Visualization Offline Guide

Complete: 2
Line: 27 to 27
 
Deleted:
<
<

Heading 1

Subheading 1

 

Visualization SandBox

Area in free format for items that the groups wish to add: meetings, to do lists, links etc
Line: 67 to 63
 
<!-- In the following line, be sure to put a blank space AFTER your name; otherwise the Summary doesn't come out right. -->

Responsible: IannaOsborne

Changed:
<
<
Last reviewed by: Most recent reviewer
>
>
Last reviewed by:
 
META FILEATTACHMENT attachment="geom-sens-1.jpg" attr="" comment="" date="1177321124" name="geom-sens-1.jpg" path="geom-sens-1.jpg" size="182445" stream="geom-sens-1.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="geom-sens-2.jpg" attr="" comment="" date="1177321147" name="geom-sens-2.jpg" path="geom-sens-2.jpg" size="184600" stream="geom-sens-2.jpg" user="Main.yana" version="1"

Revision 112007-07-03 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide"

Visualization Offline Guide

Complete: 2
Line: 25 to 25
 

Documentation

Added:
>
>
 

Heading 1

Subheading 1

Revision 102007-07-03 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide"

Visualization Offline Guide

Complete: 2
Line: 21 to 21
 

Tutorials

Added:
>
>
 

Documentation

Revision 92007-04-27 - JennyWilliams

Line: 1 to 1
 
META TOPICPARENT name="SWGuide"

Visualization Offline Guide

Complete: 2
Line: 20 to 20
 

Tutorials

Changed:
<
<

1: How to check Geant4 geometry description

Basic concepts

A detector geometry in Geant4 is made of a number of volumes. The largest volume is called the World volume. It must contain, with some margin, all other volumes in the CMS detector geometry. The other volumes are created and placed inside previous volumes, included in the World volume.

Each volume is created by describing its shape and its physical characteristics, and then placing it inside a containing volume.

When a volume is placed within another volume, Geant4 calls the former volume the daughter volume and the latter the mother volume. The coordinate system used to specify where the daughter volume is placed, is the coordinate system of the mother volume.

To describe a volume's shape, Geant4 uses the concept of a solid. A solid is a geometrical object that has a shape and specific values for each of that shape's dimensions. A cube with a side of 10 centimeters and a cylinder of radius 30 cm and length 75 cm are examples of solids.

To describe a volume's full properties, Geant4 uses a logical volume. It includes the geometrical properties of the solid, and adds physical characteristics: the material of the volume; whether it contains any sensitive detector elements; the magnetic field; etc.

To position the volume in Geant4 you create a physical volume, which places a copy of the logical volume inside a larger, containing, volume.

Getting started

This is a recipe which works with a nightly build of 2007-04-23. It will work with any major release, but is not guaranteed if you use any nightly build.

> scramv1 p CMSSW 2007-04-23
> cd CMSSW_2007-04-23/src
> project CMSSW
> cvs co VisDocumentation/VisTutorial
> eval `scram ru -csh`
> iguana -p cmssw-geom-sens.cfg

When IGUANA pops up a GUI, choose CMSSW:

iguana-session-types.jpg

Then ask for an event (geometry is produced on the first event):

iguana-next-event-menu

Note that the OCMS branch appears in the tree browser under the Detector branch. The OCMS is the World volume in Geant4 terminology.

The picture on the left shows the tree browser before asking for an event and the picture on the right - the same tree browser after the event has been requested.

Twig browser before event Twig browser after event

How to expand and collapse geometry tree

To expand the volume hierarchy either click on + (on left from the volume name) or double mouse click on the volume name. When the hierarchy expands, the + changes to - and you will see the daughters. To collapse the volume hierarchy either click on - or double mouse click on the volume name. The following picture shows the result of expanding the CMSE volume hierarchy:

Tree browser after event

Since we build the Geant4 geometry on user request, you may see that some of the volume names are grayed out - the volumes for which IGUANA has not build the geometry yet. It means, that you cannot visualize these volumes untill you request IGUANA to build their geometry. How? Enable them! To enable the daughters of the mother volume right mouse click on the mother volume name (CMSE) to retrieve the object menu and click on "Enable Children". The following picture shows the object menu of the CMSE volume.

Tree browser option menu

How to switch between logical and physical volumes

By default IGUANA shows a logical volume hierarchy. You can switch it to a physical hierarchy for all or some of the volumes.

Use the object menu to switch between physical and logical volumes. This can be done at any level (if applicable). To pop up the menu right mouse click on the volume name. The picture on the left shows the logical children of the CMSE mother volume. The middle picture shows the object menu. The picture on the right shows the physical children of the CMSE mother volume.

Logical volumes Switch to physical volumes Physical volumes

How to look up a volume properties

Select the name of a volume in the tree browser. A list of volume properties appears in the text browser: a volume name, a copy number, whether it is replicated, volume position, rotation, material, density, sensitivity, etc.

The picture below shows the list of properties displayed for a BEAM volume.

Volume properties

How to calculate a logical volume mass

Right mouse click on the volume name in the tree browser to pop up an object menu and choose "Get Mass". This will envoke G4LogicalVolume::GetMass which returns the mass of the logical volume tree computed from the estimated geometrical volume of each solid and material associated to the logical volume and (by default) to its daughters.

NOTE: the computation may require a considerable amount of time, depending from the complexity of the geometry tree.

The result will be shown in a dialog box.

How to visualize volumes

When you have expanded and enabled the volume hierarchy, tick the visibility box on. If the volume does not appear, bring it into the view by clicking on "View All" iguana-view-all-button.jpg tool bar button.

You can also use an object menu: clicking on "Show This" displays selected volume.

"Show Only This" displays selected volume and hides all other already visible volumes.

"Show By Level" allows you to expand the volumes hierarchy and display the volumes by selected level down to the leaves.

"Show By Category" allows you to display the volumes by their sensitivity.

"Show By Material" will pop up a selector dialog window with all available materials to choose from. Only the volumes made of the selected material will be displayed.

Geant4 geometry Geant4 geometry

>
>
 

Documentation

Revision 82007-04-26 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide"

Visualization Offline Guide

Complete: 2
Line: 126 to 126
 

Visualization SandBox

Area in free format for items that the groups wish to add: meetings, to do lists, links etc
Added:
>
>

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): GUI

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

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

 

Review status

Line: 152 to 173
 
META FILEATTACHMENT attachment="geom-sens-twig-volume-properties.jpg" attr="" comment="" date="1177340768" name="geom-sens-twig-volume-properties.jpg" path="geom-sens-twig-volume-properties.jpg" size="40298" stream="geom-sens-twig-volume-properties.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="iguana-view-all-button.jpg" attr="" comment="" date="1177341317" name="iguana-view-all-button.jpg" path="iguana-view-all-button.jpg" size="1214" stream="iguana-view-all-button.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="geom-sens-switch-physical-volumes.jpg" attr="" comment="" date="1177341481" name="geom-sens-switch-physical-volumes.jpg" path="geom-sens-switch-physical-volumes.jpg" size="46461" stream="geom-sens-switch-physical-volumes.jpg" user="Main.yana" version="1"
Added:
>
>
META FILEATTACHMENT attachment="iguana-gui-trees.jpg" attr="" comment="" date="1177579413" name="iguana-gui-trees.jpg" path="iguana-gui-trees.jpg" size="77804" stream="iguana-gui-trees.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="iguana-gui-hcal-rechits.jpg" attr="" comment="" date="1177579435" name="iguana-gui-hcal-rechits.jpg" path="iguana-gui-hcal-rechits.jpg" size="115705" stream="iguana-gui-hcal-rechits.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="iguana-gui-provenance.jpg" attr="" comment="" date="1177579453" name="iguana-gui-provenance.jpg" path="iguana-gui-provenance.jpg" size="126026" stream="iguana-gui-provenance.jpg" user="Main.yana" version="1"

Revision 72007-04-23 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide"

Visualization Offline Guide

Changed:
<
<
Complete: 1
>
>
Complete: 2
 
Line: 20 to 20
 

Tutorials

Changed:
<
<

How to check Geant4 geometry description

>
>

1: How to check Geant4 geometry description

 

Basic concepts

Line: 64 to 64
 

How to expand and collapse geometry tree

Changed:
<
<
To expand the branches either click on + (on left from the branch name) or double mouse click on the name. When the branch expands, the + changes to - and you will see the sub-branches. To collapse the branch either click on - or double mouse click on the name. The following picture shows the result of expanding the CMSE branch:
>
>
To expand the volume hierarchy either click on + (on left from the volume name) or double mouse click on the volume name. When the hierarchy expands, the + changes to - and you will see the daughters. To collapse the volume hierarchy either click on - or double mouse click on the volume name. The following picture shows the result of expanding the CMSE volume hierarchy:
  Tree browser after event
Changed:
<
<
Since we build the Geant4 geometry on user request, you may see some branches grayed out - the branches for which their geometry has not been built yet. It means, that these branches you cannot visualize unless you request to build their geometry. How? Enable them! To enable the sub-branches right mouse click on the CMSE branch name to retrieve the option menu and click on "Enable Children". The following picture shows the option menu of the CMSE branch.
>
>
Since we build the Geant4 geometry on user request, you may see that some of the volume names are grayed out - the volumes for which IGUANA has not build the geometry yet. It means, that you cannot visualize these volumes untill you request IGUANA to build their geometry. How? Enable them! To enable the daughters of the mother volume right mouse click on the mother volume name (CMSE) to retrieve the object menu and click on "Enable Children". The following picture shows the object menu of the CMSE volume.
  Tree browser option menu

How to switch between logical and physical volumes

Changed:
<
<
Use the option menu to switch between physical and logical volumes. This can be done at any level (if applicable). To pop up the menu right mouse click on the branch name. The picture on the left shows a logical children of the CMSE mother volume. The picture on the right shows a physical children of the CMSE mother volume.
>
>
By default IGUANA shows a logical volume hierarchy. You can switch it to a physical hierarchy for all or some of the volumes.

Use the object menu to switch between physical and logical volumes. This can be done at any level (if applicable). To pop up the menu right mouse click on the volume name. The picture on the left shows the logical children of the CMSE mother volume. The middle picture shows the object menu. The picture on the right shows the physical children of the CMSE mother volume.

  Logical volumes Switch to physical volumes
Line: 88 to 90
  Volume properties
Added:
>
>

How to calculate a logical volume mass

Right mouse click on the volume name in the tree browser to pop up an object menu and choose "Get Mass". This will envoke G4LogicalVolume::GetMass which returns the mass of the logical volume tree computed from the estimated geometrical volume of each solid and material associated to the logical volume and (by default) to its daughters.

NOTE: the computation may require a considerable amount of time, depending from the complexity of the geometry tree.

The result will be shown in a dialog box.

 

How to visualize volumes

Changed:
<
<
When you have expanded and enabled the volume branches, tick the visibility box on. If the volume does not appear, bring it into the view by clicking on "View All" iguana-view-all-button.jpg tool bar button.
>
>
When you have expanded and enabled the volume hierarchy, tick the visibility box on. If the volume does not appear, bring it into the view by clicking on "View All" iguana-view-all-button.jpg tool bar button.

You can also use an object menu: clicking on "Show This" displays selected volume.

"Show Only This" displays selected volume and hides all other already visible volumes.

"Show By Level" allows you to expand the volumes hierarchy and display the volumes by selected level down to the leaves.

"Show By Category" allows you to display the volumes by their sensitivity.

"Show By Material" will pop up a selector dialog window with all available materials to choose from. Only the volumes made of the selected material will be displayed.

  Geant4 geometry Geant4 geometry

Revision 62007-04-23 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide"

Visualization Offline Guide

Complete: 1
Line: 22 to 22
 

How to check Geant4 geometry description

Added:
>
>

Basic concepts

A detector geometry in Geant4 is made of a number of volumes. The largest volume is called the World volume. It must contain, with some margin, all other volumes in the CMS detector geometry. The other volumes are created and placed inside previous volumes, included in the World volume.

Each volume is created by describing its shape and its physical characteristics, and then placing it inside a containing volume.

When a volume is placed within another volume, Geant4 calls the former volume the daughter volume and the latter the mother volume. The coordinate system used to specify where the daughter volume is placed, is the coordinate system of the mother volume.

To describe a volume's shape, Geant4 uses the concept of a solid. A solid is a geometrical object that has a shape and specific values for each of that shape's dimensions. A cube with a side of 10 centimeters and a cylinder of radius 30 cm and length 75 cm are examples of solids.

To describe a volume's full properties, Geant4 uses a logical volume. It includes the geometrical properties of the solid, and adds physical characteristics: the material of the volume; whether it contains any sensitive detector elements; the magnetic field; etc.

To position the volume in Geant4 you create a physical volume, which places a copy of the logical volume inside a larger, containing, volume.

Getting started

 This is a recipe which works with a nightly build of 2007-04-23. It will work with any major release, but is not guaranteed if you use any nightly build.

> scramv1 p CMSSW 2007-04-23

Line: 39 to 55
  iguana-next-event-menu
Changed:
<
<
Note that the OCMS branch appears in the tree browser under the Detector branch. The picture on the left shows the tree browser before asking for an event and the picture on the right - the same tree browser after the event has been requested.
>
>
Note that the OCMS branch appears in the tree browser under the Detector branch. The OCMS is the World volume in Geant4 terminology.

The picture on the left shows the tree browser before asking for an event and the picture on the right - the same tree browser after the event has been requested.

  Twig browser before event Twig browser after event
Line: 56 to 74
 

How to switch between logical and physical volumes

Changed:
<
<
Use the option menu to switch between physical and logical volumes. To pop up the menu right mouse click on the branch name. The picture on the left shows a logical children of the CMSE mother volume. The picture on the right shows a physical children of the CMSE mother volume.
>
>
Use the option menu to switch between physical and logical volumes. This can be done at any level (if applicable). To pop up the menu right mouse click on the branch name. The picture on the left shows a logical children of the CMSE mother volume. The picture on the right shows a physical children of the CMSE mother volume.
  Logical volumes
Added:
>
>
Switch to physical volumes
 Physical volumes
Added:
>
>

How to look up a volume properties

Select the name of a volume in the tree browser. A list of volume properties appears in the text browser: a volume name, a copy number, whether it is replicated, volume position, rotation, material, density, sensitivity, etc.

The picture below shows the list of properties displayed for a BEAM volume.

Volume properties

How to visualize volumes

When you have expanded and enabled the volume branches, tick the visibility box on. If the volume does not appear, bring it into the view by clicking on "View All" iguana-view-all-button.jpg tool bar button.

 Geant4 geometry Geant4 geometry
Line: 98 to 129
 
META FILEATTACHMENT attachment="geom-sens-twig-menu.jpg" attr="" comment="" date="1177330007" name="geom-sens-twig-menu.jpg" path="geom-sens-twig-menu.jpg" size="42944" stream="geom-sens-twig-menu.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="geom-sens-twig-physical-volumes.jpg" attr="" comment="" date="1177335723" name="geom-sens-twig-physical-volumes.jpg" path="geom-sens-twig-physical-volumes.jpg" size="23091" stream="geom-sens-twig-physical-volumes.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="geom-sens-twig-logical-volumes.jpg" attr="" comment="" date="1177335904" name="geom-sens-twig-logical-volumes.jpg" path="geom-sens-twig-logical-volumes.jpg" size="22705" stream="geom-sens-twig-logical-volumes.jpg" user="Main.yana" version="1"
Added:
>
>
META FILEATTACHMENT attachment="geom-sens-twig-volume-properties.jpg" attr="" comment="" date="1177340768" name="geom-sens-twig-volume-properties.jpg" path="geom-sens-twig-volume-properties.jpg" size="40298" stream="geom-sens-twig-volume-properties.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="iguana-view-all-button.jpg" attr="" comment="" date="1177341317" name="iguana-view-all-button.jpg" path="iguana-view-all-button.jpg" size="1214" stream="iguana-view-all-button.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="geom-sens-switch-physical-volumes.jpg" attr="" comment="" date="1177341481" name="geom-sens-switch-physical-volumes.jpg" path="geom-sens-switch-physical-volumes.jpg" size="46461" stream="geom-sens-switch-physical-volumes.jpg" user="Main.yana" version="1"

Revision 52007-04-23 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide"

Visualization Offline Guide

Complete: 1
Line: 39 to 39
  iguana-next-event-menu
Changed:
<
<
Note that the OCMS branch appears in the tree browser under the Detector branch:
>
>
Note that the OCMS branch appears in the tree browser under the Detector branch. The picture on the left shows the tree browser before asking for an event and the picture on the right - the same tree browser after the event has been requested.
  Twig browser before event Twig browser after event
Changed:
<
<
To expand the branches either click on + (on left from the branch name) or double mouse click on the name. When the branch expands, the + changes to - and you will see the sub-branches. To collapse the branche either click on - or double mouse click on the name. See the result of expanding the CMSE branch:
>
>

How to expand and collapse geometry tree

 
Changed:
<
<
Twig browser after event
>
>
To expand the branches either click on + (on left from the branch name) or double mouse click on the name. When the branch expands, the + changes to - and you will see the sub-branches. To collapse the branch either click on - or double mouse click on the name. The following picture shows the result of expanding the CMSE branch:
 
Changed:
<
<
Since we build the Geant4 geometry on user request, you may see some branches grayed out - the branches for which their geometry has not been built yet. It means, that these branches you cannot visualize unless you request to build their geometry. How? Enable them! To enable the sub-branches right mouse click on the CMSE branch name to retrieve the menu and click on "Enable Children":
>
>
Tree browser after event
 
Changed:
<
<
Twig browser object menu
>
>
Since we build the Geant4 geometry on user request, you may see some branches grayed out - the branches for which their geometry has not been built yet. It means, that these branches you cannot visualize unless you request to build their geometry. How? Enable them! To enable the sub-branches right mouse click on the CMSE branch name to retrieve the option menu and click on "Enable Children". The following picture shows the option menu of the CMSE branch.
 
Added:
>
>
Tree browser option menu
 
Added:
>
>

How to switch between logical and physical volumes

Use the option menu to switch between physical and logical volumes. To pop up the menu right mouse click on the branch name. The picture on the left shows a logical children of the CMSE mother volume. The picture on the right shows a physical children of the CMSE mother volume.

Logical volumes Physical volumes

  Geant4 geometry Geant4 geometry
Line: 89 to 96
 
META FILEATTACHMENT attachment="geom-sens-twig-after-event.jpg" attr="" comment="" date="1177328693" name="geom-sens-twig-after-event.jpg" path="geom-sens-twig-after-event.jpg" size="23208" stream="geom-sens-twig-after-event.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="geom-sens-CMSE-expanded.jpg" attr="" comment="" date="1177329006" name="geom-sens-CMSE-expanded.jpg" path="geom-sens-CMSE-expanded.jpg" size="22125" stream="geom-sens-CMSE-expanded.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="geom-sens-twig-menu.jpg" attr="" comment="" date="1177330007" name="geom-sens-twig-menu.jpg" path="geom-sens-twig-menu.jpg" size="42944" stream="geom-sens-twig-menu.jpg" user="Main.yana" version="1"
Added:
>
>
META FILEATTACHMENT attachment="geom-sens-twig-physical-volumes.jpg" attr="" comment="" date="1177335723" name="geom-sens-twig-physical-volumes.jpg" path="geom-sens-twig-physical-volumes.jpg" size="23091" stream="geom-sens-twig-physical-volumes.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="geom-sens-twig-logical-volumes.jpg" attr="" comment="" date="1177335904" name="geom-sens-twig-logical-volumes.jpg" path="geom-sens-twig-logical-volumes.jpg" size="22705" stream="geom-sens-twig-logical-volumes.jpg" user="Main.yana" version="1"

Revision 42007-04-23 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide"

Visualization Offline Guide

Complete: 1
Line: 28 to 28
 > cd CMSSW_2007-04-23/src
> project CMSSW
> cvs co VisDocumentation/VisTutorial
Added:
>
>
> eval `scram ru -csh`
 > iguana -p cmssw-geom-sens.cfg

When IGUANA pops up a GUI, choose CMSSW:

Line: 38 to 39
  iguana-next-event-menu
Added:
>
>
Note that the OCMS branch appears in the tree browser under the Detector branch:

Twig browser before event Twig browser after event

To expand the branches either click on + (on left from the branch name) or double mouse click on the name. When the branch expands, the + changes to - and you will see the sub-branches. To collapse the branche either click on - or double mouse click on the name. See the result of expanding the CMSE branch:

Twig browser after event

Since we build the Geant4 geometry on user request, you may see some branches grayed out - the branches for which their geometry has not been built yet. It means, that these branches you cannot visualize unless you request to build their geometry. How? Enable them! To enable the sub-branches right mouse click on the CMSE branch name to retrieve the menu and click on "Enable Children":

Twig browser object menu

 Geant4 geometry Geant4 geometry
Line: 69 to 85
 
META FILEATTACHMENT attachment="geom-sens-2.jpg" attr="" comment="" date="1177321147" name="geom-sens-2.jpg" path="geom-sens-2.jpg" size="184600" stream="geom-sens-2.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="iguana-next-event-menu.jpg" attr="" comment="" date="1177321327" name="iguana-next-event-menu.jpg" path="iguana-next-event-menu.jpg" size="23272" stream="iguana-next-event-menu.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="iguana-session-types.jpg" attr="" comment="" date="1177321410" name="iguana-session-types.jpg" path="iguana-session-types.jpg" size="17722" stream="iguana-session-types.jpg" user="Main.yana" version="1"
Added:
>
>
META FILEATTACHMENT attachment="geom-sens-twig.jpg" attr="" comment="" date="1177328666" name="geom-sens-twig.jpg" path="geom-sens-twig.jpg" size="21515" stream="geom-sens-twig.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="geom-sens-twig-after-event.jpg" attr="" comment="" date="1177328693" name="geom-sens-twig-after-event.jpg" path="geom-sens-twig-after-event.jpg" size="23208" stream="geom-sens-twig-after-event.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="geom-sens-CMSE-expanded.jpg" attr="" comment="" date="1177329006" name="geom-sens-CMSE-expanded.jpg" path="geom-sens-CMSE-expanded.jpg" size="22125" stream="geom-sens-CMSE-expanded.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="geom-sens-twig-menu.jpg" attr="" comment="" date="1177330007" name="geom-sens-twig-menu.jpg" path="geom-sens-twig-menu.jpg" size="42944" stream="geom-sens-twig-menu.jpg" user="Main.yana" version="1"

Revision 32007-04-23 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide"

Visualization Offline Guide

Complete: 1
Line: 20 to 20
 

Tutorials

Added:
>
>

How to check Geant4 geometry description

This is a recipe which works with a nightly build of 2007-04-23. It will work with any major release, but is not guaranteed if you use any nightly build.

> scramv1 p CMSSW 2007-04-23
> cd CMSSW_2007-04-23/src
> project CMSSW
> cvs co VisDocumentation/VisTutorial
> iguana -p cmssw-geom-sens.cfg

When IGUANA pops up a GUI, choose CMSSW:

iguana-session-types.jpg

Then ask for an event (geometry is produced on the first event):

iguana-next-event-menu

Geant4 geometry Geant4 geometry

 

Documentation

Heading 1

Line: 42 to 64
  Responsible: IannaOsborne
Last reviewed by: Most recent reviewer
Added:
>
>
META FILEATTACHMENT attachment="geom-sens-1.jpg" attr="" comment="" date="1177321124" name="geom-sens-1.jpg" path="geom-sens-1.jpg" size="182445" stream="geom-sens-1.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="geom-sens-2.jpg" attr="" comment="" date="1177321147" name="geom-sens-2.jpg" path="geom-sens-2.jpg" size="184600" stream="geom-sens-2.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="iguana-next-event-menu.jpg" attr="" comment="" date="1177321327" name="iguana-next-event-menu.jpg" path="iguana-next-event-menu.jpg" size="23272" stream="iguana-next-event-menu.jpg" user="Main.yana" version="1"
META FILEATTACHMENT attachment="iguana-session-types.jpg" attr="" comment="" date="1177321410" name="iguana-session-types.jpg" path="iguana-session-types.jpg" size="17722" stream="iguana-session-types.jpg" user="Main.yana" version="1"

Revision 22007-04-20 - IannaOsborne

Line: 1 to 1
 
META TOPICPARENT name="SWGuide"

Visualization Offline Guide

Complete: 1
Line: 7 to 7
 

Contacts

Changed:
<
<
>
>
 

Introduction

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

IGUANACMS - Interactive Graphics and User ANAlysis for CMS - a SCRAM-based project for CMS specific visualization. Now part of the CMSSW project.

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.

 

Tutorials

Documentation

Revision 12007-04-20 - CMSUserSupport

Line: 1 to 1
Added:
>
>
META TOPICPARENT name="SWGuide"

Visualization Offline Guide

Complete: 1

Contacts

Introduction

Tutorials

Documentation

Heading 1

Subheading 1

Visualization SandBox

Area in free format for items that the groups wish to add: meetings, to do lists, links etc

Review status

<!-- Add your review status in this table structure with 2 columns delineated by three vertical bars -->

Reviewer/Editor and Date (copy from screen) Comments
KatiLassilaPerini - 20 Apr 2007 created template page

<!-- In the following line, be sure to put a blank space AFTER your name; otherwise the Summary doesn't come out right. -->

Responsible: IannaOsborne
Last reviewed by: Most recent reviewer

 
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