XYPLOT (version 2.4, patchlevel 3):
 
xyplot is a two-dimensional graphing and plotting package, that
permits on-screen viewing of the graph in X-windows and SunView,
as well as the ability to generate postscript files for hardcopy
figures.
 
INSTALLING XYPLOT:
 
1. Well, what do you have to begin with?

(a) a large email file with the line "begin 644 xyplot.tar.Z"
somewhere near the beginning.
->save this as file with name "xyplot.tar.Zuu" and go to (b).

(b) the file "xyplot.tar.Zuu"
->decode this into an ordinary compressed tar file using the command
	uudecode xyplot.tar.Zuu
this should generate the file "xyplot.tar.Z"; then you can erase (rm) the
"xyplot.tar.Zuu" file and go to (c).

(c) the compressed tar file "xyplot.tar.Z"
->you should change directory (cd) to where you want the source code
installed, (hereafter I'll call that directory "$HERE"),
move (mv) the file "xyplot.tar.Z" to $HERE, and then type 
	zcat xyplot.tar.Z | tar xvf -
This will extract several files into the $HERE directory, as well as
creating four subdirectories (xyplot, xyview, xysee, and xydoc), with
files in them.  

(d) if you have the ordinary (not compressed) tar file "xyplot.tar"
you can compress it with "compress xyplot.tar" and go to (c), or
else you can use the command
	cat xyplot.tar | tar xvf -
 
2. To install the full xyplot package, it is possible that all you'll
have to do next is type "make install" in this directory.  Before you
do that, though:
 
2(a). It is probably a good idea to look at the "Makefile".  In
particular, you should decide whether you want to make both the
"xyview" AND the "xysee" programs.  The former is for display in
SunView, and the latter for display in X windos.
 
2(b). Edit the file "Make.var" to set which directories you want the
executables, postscript prolog, and man pages installed.  The default
is for a personal (as opposed to system) installation, with
executables in directory "$HOME/bin", postscript prolog in
"$HOME/lib", and man pages in "$HOME/man/manl".
 
Probably the least straightforward of these is the postscript prolog.
What you are setting is the default directory where the program
"xyps" will look to find the prolog file used for making graphs into
publication quality postscript files.  This directory is hard-coded
into "xyps" at compile time.  (It can, however, be over-ridden with
an environment variable; see the manual for details.)
 
2(c). Okay, having edited the "Makefile" and "Make.var" files, you may
prefer to type "make all" next to make sure that everything compiles
correctly.  One common problem at this stage is that include files
either for xyview or xysee are not found.  Sometimes this is because
the variable XVINC is not set right in the "Make.var" file, but more
often, in my experience, it is because the computer you are working on
does not mount the disk that has correct include directories.
Usually, if this is a problem, there will be another computer on your
network that does mount that disk, and the code will compile fine on
the other computer.

2(d). At this point it is possible, if "make all" was successful, to
manually go into each of the appropriate directories and move the
appropriate files to the appropriate directories.  Alternatively, you
can just type "make install" and it should install itself.  If the
installation is complete, you may wish to type "make clean" to remove
a lot of extraneous intermediate files.  In fact you may want to 
remove everything except for the README and xyplot.tar.Z files,
since all the others can be made from them.
 
TESTING:
 
After the executables are installed, they can be tested on the *.xy
files in the xydoc directory.  For example, if you are in X-windows,
type
	xyplot ex1.xy | xysee &
to actually see a plot of the data in file ex1.xy as a separate window
on your screen.  If you hit the left mouse button while the cursor is
in the graphic window, then that window will disappear.  If you are not
in X-windows or OpenWindows, but instead are in SunView, you should type
	xyplot ex1.xy | xyview &
 
An easy way to look at all the *.xy files in this directory, if you are
working in the C-shell (csh), is to type
        
        foreach file (*.xy)
        xyplot $file | xysee
        end
 
Again this assumes you are in X-windows.  Use xyview instead of xysee
if you are in SunView.
 
After typing the foreach line the csh will prompt you with a ``?''; type
in the other two lines.  After the end <carrige return> the first plot
will be displayed on the screen and will remain there until the left mouse
button is pressed while the cursor is on the plot.
 
To test the postscript printing type "xyplot -ps symbols.xy | lpr".
This will produce a plot will all the plotting symbols available on the
default printer (assumed to be a PostScript printer).
 
MAKING DOCUMENTATION
 
1. HardCopy manual:
 
A postscript file of the manual is in the file "xyman.ps" of the "xydoc"
directory.  If the postscript file has not been made, then type "make doc"
in the xydoc directory.
 
2. Man pages:
 
To install the manual pages, copy xyplot.l and xyps.l from the xydoc
directory into a manual directory.  If you have set up the original
"Makefile" correctly, then this will already have been done as part
of the "make install".  Otherwise, if you are installing xyplot in
your own directory, create a manual directory
 
        mkdir $HOME/man
        mkdir $HOME/man/manl
 
and then copy the files "xyplot.l" and "xyps.l" into $HOME/man/manl.
 
After that set the enviornment variable MANPATH to the appropiate value.
This is better done in your .login file by adding the line
 
        setenv MANPATH  $MANPATH:$HOME/man
 
After this, the next time you login, you can type "man xyplot" 
and "man xyps" to see the manual page for xyplot and xyps.
 
QUESTIONS, COMMENTS, BUGS:
 
Contact James Theiler (jt@t13.lanl.gov or james@santafe.edu)
or Ronnie Mainieri (ronnie@goshawk.lanl.gov).
 
