How to create a .ig file for ISpy visual event reconstruction...

Introduction

This is a tutorial on how to create a .ig file for use with the ISpy event reconstruction tool. First, know that the only file type that ISpy can take as input is the .ig file type (I believe it stands for 'iguana'). ISpy offers a few unique advantages over the cmsShow/Fireworks tool:

1. ISpy is a completely web based tool and thus it is not effected by updates to the CMSSW package (the process of creating .ig files could be affected)
2. ISpy is capable of incorporating DIGI information into event reconstruction (I don't believe that Fireworks can, or it is at least more difficult)
3. It tends to look a little prettier

The ISpy Web Tool

The online ISpy web tool (as of 12/10/15) is located at: http://ispy-webgl.web.cern.ch/ispy-webgl/

To use the tool, you must first select some run data to visualize. Click the open folder icon in the top left to select data to load. You can choose to either select some example data that is stored online, or to select a local data file. Until we have created a local file, you may want to select some online data to visualize and use to get a feel for the tool.

When you select a data file the dialog window will first show all of the Runs contained in the file - select one. Then, all events in that run will be displayed - select one.

Now the event will be displayed. The left/right arrows in the toolbar will display the other events in the selected run. In the dropdown menus, you can select the detector components, tracks, and detector hits to display.

Click on the image to adjust the view.

Creating .ig Files

These instructions will illustrate how to create a .ig file that incorporates DIGI information into the ISpy event display of the file (i.e. to display the wires and strips in the CSCs).

1. Select an appropriate CMSSW release (the one in use at P5 is usually a good choice, e.g. CMSSW_8_0_16 at this moment)
2. install and build the ISpy/Analyzers and ISpy/Services packages

cd CMSSW_8_0_16/src
cmsenv
git clone https://github.com/cms-outreach/ispy-analyzers.git ISpy/Analyzers
git clone https://github.com/cms-outreach/ispy-services.git ISpy/Services
scram b

• Copy the FEVT .root files or RAW-RECO to your CMSSW release /src folder. This can be done by copying from eos or with edmPickEvents.py (https://twiki.cern.ch/twiki/bin/view/CMSPublic/WorkBookPickEvents) to if you want to get specific events.
• Copy the add_digis.py file to the /src folder. Update the input file (line 42), output file, and global tag according to your information.
• cmsRun the add_digis.py file. This will add the DIGI information to the FEVT .root file.
• Add the ispyMakeIg.py file to the /src folder. Update the input file (line 20), output file, and global tag according to your information.
• cmsRun the ispyMakeIg.py file. This will create the .ig file in the folder that you run it from.
• Copy the .ig file to your local machine. (i.e. scp the file...)
• Load the .ig file from your local machine into the ISpy web tool.
• View your data!