D0CAFVis: Event display for D0
Common Analysis Framework Data

A. Introduction

     D0CAFVis is a ROOT based 3D interactive event display for viewing events in D0's Common 
     Analysis Framework trees (CAFTrees).  It is built using TEve classes in ROOT's Event Visualiza-
     tion Environment.  The application consists of a single ROOT macro, the D0 detector geometry
     contained in a ROOT geometry file,  and some basic packages from the CAF environment.  It
     does not require the D0 software environment and runs "standalone" on Linux or Mac OSX.  It
     requires ROOT version 5.26 or higher.


B. Getting and Installing D0CAFVis

     There are two ways to run D0CAFVis:

• on Clued0

• on your own desktop or laptop

    To run on Clued0

    1) Copy the following directory to your own area:

        % cp -r /work/barracuda-clued0/mwang/d0cafvis.

      * If your clued0 machine is an SLF5 machine, copy this area instead:

        % cp -r /work/barracuda-clued0/mwang/d0cafvis.slf5.

    2) The application expects an input CAFTree or symlink to it named "caftree.root":

        % cd d0cafvis

        % ln -s /path/to/your/caf/event/file caftree.root

    3) Set up the appropriate version of root and gcc:

        % unsetup D0RunII (may be good to do this)
        % source setup

       This last step executes the following two setup commands:

        setup gcc v3_4_4_dzero_so
        setup root v5_26_00 -q GCC_3_4_6

      * For SLF5, do not do the setup command above, instead do the following:

        setenv ROOTSYS /work/barracuda-clued0/mwang/root
        setenv PATH ${ROOTSYS}/bin:${PATH}

    4) Run the application

        % root -l d0cafvis.C

     * For optimum performance, use the local console or display of the machine on which the applica-
       tion is running.  Make sure you have a decent 3D graphics card (Nvidia or ATI) preferably with 
       OpenGL drivers  provided by the manufacturer.  You can check to see if your card supports 
       OpenGL with the "glxinfo" command.

    To run on your own desktop or laptop

    1) Make sure you have ROOT  version 5.26 or higher and that $ROOTSYS is set to the location 
       of your ROOT installation.

    2) If you have a Linux PC, download the tar file d0cafvis.tar.gz onto your desktop or laptop.

       If you have a Mac, download this tar file d0cafvis-mac.tar.gz instead.  After unpacking,
       please read 000readmac, item #5, in particular.  (Thanks to Sehwook Lee for getting this to 
       work on the Mac.)

    3) Unwind the tar file and go into the directory d0cafvis created after unpacking:

        % tar zxvf d0cafvis.tar.gz
        % cd d0cafvis

    4) Source the setup script for building standalone CAFe and build it:

        % source tmb_tree/tools/setup-standalone.csh (or .sh)
        % make

       After this last step, you should find the following libraries in ./lib:

        % ls lib/

        libmet_util.so  libtmb_tree.so

    5) You are now ready to run d0cafvis.  Follow steps 2 and 3 of the previous section describing how 
        to run on clued0.


C. Using D0CAFVis

     The graphical user interface of D0CAFVis is fairly intuitive to use as it uses standard widgets 
     provided by ROOT.  The GUI consists of two main portions, (a) a main display area where the
     a 3D representation of the the event and static detector components are displayed, and (b) a 
     control pane on the left with various widgets for event control and graphics scene manipulation.

     One can use the mouse to directly  manipulate the graphics scene in the main display area.  
     For a three button mouse, the buttons function as follows:

• Left button:  hold down and move the mouse to change the viewing direction

• Middle button: hold down and move the mouse to pan across the scene

• Right button:  hold down and move the mouse to zoom in or out

     More detailed instructions on the use of the GUI are available below:

        GUI and main display area
        The control pane
        Producing hard copies of the scene

D. Custom versions

     d0cafmuvis.tar.gz:  Special version for viewing special CAFTrees with additional muon hit information
                           produced by Dave Cutts and Yunhe Xie using a modified version of TMBMuon.


     If you require more information or assistance, please send comments or questions to mwang@fnal.gov.

Last Updated on 10August10
By Mike Wang