Folks,

  For what it's worth, here's the first attempt at a guide to 
  running the displays, and paw histogram analysis.  Good luck.

            Cheers,

                 Mike



--------------------------------------------------------------------

                 TB03 FORTRAN DISPLAY AND ANALYSIS 

              QUICK GUIDE - Version 1.0. June 21, 2003.

                                            Michael Shupe
                                        shupe@physics.arizona.edu


CAVE CANUM:  If things are not working, or you have suggestions for
             improvements, please send email to the above address.

               
                   ***** RUNNING THE DISPLAY *****

On pcfcal01, from the directory /home/shupe/tb03, copy the
following files to an area of your choice on psfcal01:

  tb03_displays.out
  FCAL*.txt
  rgb.txt
  run1451.inp

Then edit the run1451.inp to point to the data file you want
to look at, and run the program as follows:

  tb03_displays.out <run1451.inp

If the menu comes up black, click near the bottom to exit, and
try again. (I am working on a fix for this startup balkiness.)

The menu has the following items.  The starred items are the ones needed
for 99% of the browsing:

     *   'DISPLAYS',  ! Select a page (may be one display) to be shown
     *   'NextDisp',  ! Next page
     *   'PrevDisp',  ! Previous page
         'SelGroup',  ! Limit the page menu to a particular group
         'Visiblty',  ! Toggle the visibility of modules  
         'Paramtrs',  ! View and/or modify all adjustable parameters  
         'EDITING ',  ! Edit (create/modify) pages
         'Reset Vw',  ! Reset display or active zone to default viewpoints
         'Transfrm',  ! Transformations:  linear, log, fisheye
         'ZoomRect',  ! Zoom in to rectangle chosen in rubber band mode
         'MoveToPt',  ! Put center of view on picked point
         'End View',  ! Select view along Z axis, Y up
         'SideView',  ! Select view along X axis, Y up
         'Top View',  ! Select view down Y axis, X up
         'AnglView',  ! Select some view from a convenient view angle
         'Zoom    ',  ! Move in and out using pointer up/down
         'Move    ',  ! Pan using pointer differential from center
  (fun)  'Spin    ',  ! Rotate display using pointer diff. from center
         'Grab    ',  ! Grab and rotate using mouse and left button
         'Rol <-->',  ! Roll display about the vertical view axis
         'Rol UpDn',  ! Roll display about the horizontal view axis
         'Rol Y Ax',  ! Roll display about the world vertical axis
         'Rol Z Ax',  ! Roll display about the world Z axis 
         'Rol Axis',  ! Pick and item to serve as a roll axis and roll     
         'JumpInto',  ! Jump to the coordinate system of the picked item
         'Distance',  ! Rubberbands:  Distances, closest approach, posns
         'RubrZone',  ! Rubberbands:  Pick out a section to fill a zone
         'Picking ',  ! Give information on the picked item
         'DetailVw',  ! Jump to a more detailed display of the picked item
         'ViewData',  ! Get into the bank viewer
     *   'Hardcopy',  ! Send to a hardcopy ps file (.ps or .pscolor)
     *   'DumpEvnt',  ! Make a printout of data from this event (.dat)
         'FindEvnt',  ! Exit and find a particular event
     *   'NextEvnt',  ! Exit and get the next event
     *   'Proceed ',  ! Continue running for 100 events (for summing)
     *   'End Run ',  ! End the run

For printable images and event dumps, make liberal use of 'Hardcopy', and
'DumpEvnt'.  These produce .ps, .pscolor, or .dat files in your area,
uniquely named with run and event, for printing latter.

If you click on 'DISPLAYS', the following selection comes up.  The first 
two
are not complete (but useable), and the third doesn't exist yet.  The 
others
work.  You can bump up and down this list with the 'NextDisp' and 
'PrevDisp'
buttons.

        'TB03 Side View  ',
        'TB03 Top View   ',
        'TB03 Angle View ',
        'FCal1 Front     ',
        'FCal2 Front     ',
        'FCal3 Front     ',
        'FCal123 Front   ',
        'FCal1 Tilt      ',
        'FCal2 Tilt      ',
        'FCal3 Tilt      ',
        'FCal123 Tilt    ',
        'FCal1 Front Sum ',
        'FCal2 Front Sum ',
        'FCal3 Front Sum ',
        'FCal123 Frnt Sum',
        'FCal1 Tilt Sum  ',
        'FCal2 Tilt Sum  ',
        'FCal3 Tilt Sum  ',
        'FCal123 Tilt Sum'/

Status:
  (1)  The runs I have been looking at lately don't seem to have
       beam counter and tailcatcher information, so not all of this
       is operational in the displays.  If it appears, it should be
       in the event dump.
  (2)  There are two cluster finders in the package (a) iterative
       R cone 8 cm diameter, and (b) nearest neighbor, roughly
       3 X 3 depending on cell neighbor configurations.  These are
       not in the displays yet, but appear in event dumps.
  (3)  Lots of stuff yet to hook up and cross-compare...
   

                   
           ***** RUNNING THE PAW HISTOGRAM ANALYSIS *****

On pcfcal01, from the directory /home/shupe/tb03, copy the
following files to an area of your choice on psfcal01:

  tb03_analyze.out
  FCAL*.txt
  run1451.inp
  run1451.kumac

Then edit the run1451.inp to point to the data file you want
to look at, and run the program as follows:

  tb03_analyze.out <run1451.inp >log1451.txt &

Whan the job completes, it will produce a file tb03_hists.dat
This can be viewed in a PAW session.  run1451 is a sample
kumac to convert the current output to a .ps file.

NOTE:  The histograms are under rapid development, and it is worth
       checking periodically for updates

Status:
  (1) There are BPC histograms with beam profiles, but the
      calibrations have not yet been applied so the X,Y 
      positions are unphysical (about a factor of 2 too big)
  (2) I don't have the FCal information, seen in the displays,
      routed properly to the histograms.  In the works...
  (3) Many counter and bit histograms are empty.  Some of
      it is my problem (the trigger bits appear in the displays),
      and some may be data not there yet??  In the works...



    ***** BUILDING THE DISPLAY OR HISTOGRAM ANALYSIS PACKAGES *****

For those interested in adding histograms to tb03_hists.f, or doing any 
other development, the software is very compack and complete within two
subdirectories.

For the analysis package, copy the contents of /home/shupe/tb03 to your
local directory. To build, or rebuild the analysis package:

   source tb03_analyze.lnk

For the display package, create a subdirectory below your above directory
and copy the contents of /home/shupe/tb03/graf to this directory.  Then
to build the executable, get into your original directory and:
   
   source tb03_displays.lnk