Glen Cowan
Royal Holloway, University of London
4 September, 1999


                                 PAWN

The PAWN macros for PAW, written by Gerry Lynch and Ed Oltman of LBL, 
are based on the program DISPLAY used by the TPC/Two-gamma (aka PEP4) 
collaboration [1].  The following new commands are defined:

  AVX   (2D) fits each x bin to a Gaussian and puts out AVX and SGX plots
  AVY   (2D) fits each y bin to a Gaussian and puts out AVY and SGY plots
  BLOW  (1D) x1 x2; makes a new histogram with x limits of x1 and x2
  BLO2  (2D) x1 x2; y1 y2 cuts in both directions
  CHBN  (1D) nx; combines bins in groups of nx.
            When errors are root(N), CHBN sums; otherwise it averages.
  CHBN2 (2D) nx ny; can reduce the number of bins in both directions
  CHTI  allows one to change the histogram (bottom) title
  MAMI  (1D) y1 y2; changes the y limits of the display
  MEAN  (1D) p1 p2; gets mean between % limits
  MED   (1D) calculates the median and its errors
  PDEF  reports the number of channels and boundaries of the histogram
  PROX  (2D) does a projection of a plot in the x-direction
  PROY  (2D) does a projection of a plot in the y-direction
  REGX  (2D) makes RGX and SDX plots with the mean and rms of each x bin
  REGY  (2D) makes RGY and SDY plots with the mean and rms of each y bin
  SCAL  (1D) S; scales the points by a factor S
  SOM   (1D) makes a histogram that is the integral


Installation (Unix systems)
---------------------------

You will need a PAW initialization file called .pawlogon.kumac in your
home directory and a subdirectory where you keep your paw macros.  If, for 
example, you create a subdirectory for your macros called paw, then the line

MACRO/DEFAULT '.,~/paw' AUTO

in your .pawlogon.kumac file will put the subdirectory into the search path 
for PAW macros.  (The way it is currently set up, the file pawn.f must be in 
a subdirectory called ~/paw.  If you call this directory something else, 
you must edit the file pawn.kumac accordingly.)

Copy the files pawn.f, pawn.kumac and pawn_alias.kumac to the directory
where you keep your paw macros.  Then include the line

exec pawn_alias

in your .pawlogon.kumac file to define the names of the new commands.



References
----------

[1] DISPLAY, B. Gabioud et al., Group A Physics Programming Note P-269,
    TPC Note No. TPC-LBL-80-37, Lawrence Berkeley Laboratory, July 1980.