HOWTO get started with the RootSpy GUI software

From GlueXWiki
Jump to: navigation, search

Overview

This tutorial will show you the steps that are necessary to get the RootSpy GUI up and running.

Note: Make sure that you have the Hall-D drive mounted and the Hall-D software installed on your computer. You will need this to run the reconstruction programs that are necessary for the RootSpy GUI to have histograms to view.

The basic steps to running the RootSpy GUI are as follows:

  1. Retrieving and compiling the RootSpy GUI source code
  2. Running a Hall-D DANA-based reconstruction program.


Retrieving and Compiling the RootSpy GUI Source Code

Checking Out the Code

  1. Check your system to make sure that you are running subversion
  2. To check out the code from the svn repository enter:
svn co https://phys12svn.jlab.org/repos/RootSpy

Setting Up the Environment

The environment variables necessary to compile and run the RootSpy GUI are as follows:

  • ROOTSPY
  • JANA_PLUGIN_PATH
  • CMSGROOT
  • LD_LIBRARY_PATH

Example: Suppose you checked out the RootSpy software into {$HOME}. Then the previous variables would be set to the following:

  • ROOTSPY {$HOME}/RootSpy
  • JANA_PLUGIN_PATH {$ROOTSPY}/bin
  • CMSGROOT: Will be set to the location of the cMsgServer software on your computer
  • LD_LIBRARY_PATH {$CMSGROOT}/lib

Note: You may also want to set your PATH variable to {$ROOTSPY}/bin so you don't have to type in the full path name to run the RootSpy program every time.

Compiling the Code

In your RootSpy directory you must run the configure file by entering the following into the command line:

./configure --prefix=$HOME/RootSpy

Once the configure file has been ran you can run the make files by entering the following command in your RootSpy directory:

make install

You can now use the RootSpy GUI but before you start up the program you must start the cMsgServer by entering the following:

RootSpy/src/RootSpy/start_cmsg_server

a message should be printed to the terminal stating that the cMsgServer was succesfully started.

Now start the RootSpy GUI by entering:

RootSpy/src/RootSpy/RootSpy

Once the GUI is started it needs data from histogram producer(s) to interpret and display.

Running a Hall-D DANA-Based Reconstruction Program

Refer to the section "Running HDGEANT" on the page HOWTO get started with Hall-D Software