Welcome to KUPLOT 2.99b,

KUPLOT is a plot program driven by a command language which includes 
a FORTRAN style interpreter. The principle syntax is similar to the
'diffuse scattering simulation' program DISCUS [1].
The program can be used with X11 and TEK4014 terminals, hardcopies
can be made in POSTSCRIPT and HPGL.


How to install KUPLOT ?

The source code of the program is in the directory 'prog'. To compile
the program, you'll need a c-compiler, a f77-compiler (or f2c) and
X11 libraries. If no X11 support is wanted, edit the file 'graph.f' 
and remove (comment) all lines which call X11 routines and remove the
'x11.*' and 'cx11.*' entries in the Makefile. Here is a step by step
guide to compile and install KUPLOT:

   (1) cd prog

   (2) cp Makefile.f77 Makefile    (if you have a f77 compiler)
       cp Makefile.f2c Makefile    (if you want to use f2c)
       cp Makefile.g77 Makefile    (if you want to use g77)

   (3) Edit the Makefile change install location and uncomment the
       appropriate lines for your platform. If your machine isn't
       listed, try one close to your hardware.

   (4) Edit 'config.f' and change default print commands

   (5) Edit 'kuplot.inc' and adjust array sizes to your needs

   (6) make

   (7) make install


Using KUPLOT ?

If you have successfully build the program, you can try the tutorial to
get started. Or just run the program and use the 'help' command. Before
you can start, you have to set a KUPLOT environment variable to the
location of the installed KUPLOT files. On a csh it goes like this

   setenv KUPLOT dir/where/kuplot/is/installed

After doing this, go to the 'tutorial' directory, start KUPLOT by typing
'kuplot' and start the tutorial with the command "@tutorial". It contains
a brief intoduction how to use KUPLOT and demonstrates most of its 
features.
       

Documentation ?

The directory ./doc contains additional information about KUPLOT. 
See README in the subdirectory for more information.


Problems ?

If you have any problems or question installing and using the program,
you can contact the programs author via email at:

    proffen@pa.msu.edu

But there shouldn't be any problems :-))

------------------------------------------------------------------------------
[1] http://rschp2.anu.edu.au:8080/discus/discus.html
