HowTo use MC ED - Monte Carlo Event Display

MC ED was developed to make it easier to get an idea how a Monte Carlo event looks like. Previously this had to be done by looking for example at a HEPG_Bank dump. To reconstruct mother-daughter relations from a HEPG_Bank dump can be very time consuming. MC ED uses this information from the HEPG_Bank to visualize the event in a decay tree.

Currently MC ED is only working with Monte Carlo generated by Pythia or Isajet.

Understanding the decay tree:

MC ED draws the decay from the bottom of the screen to the top.

The horizontal position of the particle in the decay tree has no special meaning, it is used to structure the decay. The vertical position of a particle indicates through how many decays the mother particles went to create it.

The decays drawn at the beginning of the decay tree have to be regarded with caution, since the information stored in the HEPG_Bank does not contain all subprocesses the

Monte Carlo generator went through. Hence, the information is incomplete and can only give a direction of what happened in the event.

Select Button options:
            
     	 o View 
     	   o Left mouse button down and dragging of mouse creates a
             zoom box:
     	      select the region you want to enlarge.
            
     	   o Right mouse click opens menu with the following options:
            
     		 o Zoom In 
     		    zooms in 
     		 o Zoom Out 
     		    zooms out 
     		 o Unzoom  
     		    unzooms 
     		 o SetDisplayMcParticles 
     		    displays the particle names in the decay tree  
     		 o SetDisplayHepgNumbers 
     		    displays the Hepg numbers instead of the particle 
                    names 
     		 o SetDisplayText 
     		    displays event information a the top of the page   
     		   -----
     		 o SetZoomStep 
     		    zoom step (0 < zoom step < 1) 
     		 o SetMoveStep 
     		    move step (0 < move step < 1) 
     		 o SetRubberBand 
     		    if enabled you can make a "rubberband" transformation 
                    by clicking and dragging with the LEFT mouse Button
     		   -----
     		 o SetName 
     		    set name of the root canvas
     		 o SetTitle 
     		    set title of the root canvas
     		   -----
     		 o DrawClass 
     		    draws root class
     		 o Dump 
     		    dumps root canvas information
     		   -----
     		 o SetFillAttributes 
     		    root option to change the background or any other 
                    selected object
     		    
     	 o MC Particle 
     	   o Cursor will turn into a "hand" if it is moved over a line 
             of the decay tree
     		 o Left click
     		    select the corresponding particle. The decay line 
                    will turn black, the particle name red and in the 
                    text window information about this particle will 
                    be displayed. 
     		 o Right click
     		    menu opens with the following options:
     			 o printSelectedParticle
     			    in the text window information about this 
                            particle will be displayed 
     			   -----
     			 o DrawClass
     			    draws root class
     			 o Dump
     			    dumps root canvas information

Line style:
            
     	 line         	 1. mother particle  
     	 dotted       	 2. mother particle   

Particle Color codes:
            
      	 Red          	 Hadrons   
     	 Green        	 Vector bosons   
     	 Yellow       	 Photons   
     	 Grey         	 Mesons   
     	 Cyan        	 Quarks   
     	 Purple       	 Gluons   
     	 Blue         	 Leptons   

Keyboard actions:
     PRESS 
     	 ArrowUp  , 8 	-  to Move Up  
     	 ArrowDown, 2 	-  to Move Down
     	 ArrowLeft, 4 	-  to Move Left
     	 ArrowRight,6 	-  to Move Right
     	 z,-          	-  ZoomOut
     	 Z,+          	-  ZoomIn

				 typed by
				  Andrei Loginov (loginov@fnal.gov) & 
				  Carsten Rott (carott@fnal.gov)