==============================================================================
KUPLOT                                                             Version 4.0
==============================================================================

KUPLOT is an universal potting program for 2D and 3D data sets, especially
suited in combination with DISCUS and PDFFIT. However, the program may
also be used for other applications. The program is controlled by a command 
language with an integrated FORTRAN style interpreter to give maximum 
flexibility. 

==============================================================================

New features of KUPLOT 4.0 :
----------------------------

In version 4.0 of KUPLOT, the plotting routines were replaced by the
freely available plotting library PGPLOT which can be obtained on the
WWW at http://astro.caltech.edu/~tjp/pgplot/. The usage of PGPLOT 
resulted in the following enhancements:

- Screen and printer output are similar in more detail than before
- Escape characters allow better formatting and special characters
- Optional GIF file output
- More line colours (15) which can now be redefined
- Enhanced mouse input routines (command 'mouse')
- Labelling of contour lines 
- Optionally plotting of a wedge for bitmap figures

Other new features (not PGPLOT related) are:

- Calculation of the Fourier transform of a data set
- Easy plotting of a user defined function
- New functions to match, merge and rebin data
- Possibility to read/write variables to/from file

==============================================================================

Main features of KUPLOT in general :
------------------------------------

-- 2D data plots

      The program supports normal line graphs, marker, error bars as
      well as spline interpolation between the data points. Line colour,
      marker colour, line type, line width and various other parameters
      can be adjusted. 

-- 3D data plots

      KUPLOT allows to plot 3D data sets using contour lines, coloured
      bitmaps or both. The colourmap for the bitmap can be freely changed
      using the FORTRAN interpreter (via cmap[] variable). The program
      also allows to define different contour line sets for one data
      set, e.g. finer spaced lines for diffuse scattering and larger 
      space lines in a different colour for the Bragg peaks.

-- Interactive features

      A new set of functions allows the user to select the plotting
      region of obtain coordinates using the computer mouse (or other
      pointer device).

-- Function plots & data manipulation

      The FORTRAN style interpreter allows to create data sets from
      a given function. It also opens the possibility for all kinds
      of data manipulation. Predefined functions allow the user to
      manupulate data, create data sets from functions and calculated 
      the Fourier transform of a given data set.

-- Frames

      KUPLOT allows to divide a page into different plot areas (frame).
      Each frame can contains graphs or the contents of a text file.
      Frames can have different background colours. Each frame has its
      own parameter set like title, axis labels, fonts, etc..

-- Least square fitting

      KUPLOT has an integrated FIT sublevel, which allows to fit the
      following functions to a given data set: polynom, n Gaussian(s)
      and n Lorenzians. 3D data sets can be fitted using a set of
      2D Gaussians. The program also allows the usage of a user defined 
      fit function.

-- Output generated

      The program can produce hardcopies in POSTSCRIPT (incl. colour)
      and GIF format. These formats, however, might be changed to any 
      format supported by PGPLOT when compiling the program. 
      Additionally, read data sets can be saved in various formats 
      including PGM. PGM is a fileformat used by the 'pbmplus' package 
      which provides tools to convert PGM file into (nearly) any other 
      graphics format.

-- Command language

      The program uses a command language to interact with the user.
      No predefined requirement exists for a given sequence of commands.
      The commands can be typed at the KUPLOT prompt, or read from a
      macro file. Macro files may be written by any editor or learned
      during execution.

-- Build in FORTRAN interpreter

      The command language includes a FORTRAN style interpreter that
      allows the user to program loops and logical structures.
      Several real and integer variables as well as structural variables
      can be used to design the intended defect structure.

      You can use the interpreter to modify individual atoms ans thus
      generate any desired defect structure. See the examples on the WWW
      page for some applications.

-- File names

      A special feature of the FORTRAN interpreter is an automatic 
      file name generation process. This allows you to perform multiple
      simulations that can all be saved under individual names.

-- On-line help

      On line help is provided which gives the user information on any of the 
      KUPLOT commands as well as examples for typical KUPLOT sessions.

-- Error Messages

      The program generates error messages for (hopefully) all erroneous 
      situations that should provide enough information to the user in
      order to correct the errors that have occurred.

-- Manual & Tutorial

      The program comes with a detailed manual, HTML version of the online
      help and a tutorial macro package to get started with the use of
      KUPLOT.

===============================================================================
