### xfarbe-2.1 README file

    "xfarbe" is a contouring program for iso-lines with the
    following characteristics:

                  - high quality nonlinear interpolation with
                    bicubics on a rectangular grid
                  - area filling capability
                  - X- and Postscript output
                  - Customization with resource file
                  - Interactive labeling of contour lines
                  - Interactive data probing for value and
                    derivatives
                  - Placing of symbols according to information
                    read from a file
                  - Exact location extrema and saddle points
                  - Computation of profiles

    It it designed for both: Interactive viewing and analyzing during
    computations, and the presentation of the final results.

    Copyright (C) A.PREUSSER, Fritz-Haber-Institut der MPG, Berlin

    The numerical kernel is based on:

               Preusser,A.
               Algorithm 671 - FARB-E-2D: Fill Area with Bicubics
               on Rectangles - A Contour Plot Program.
               ACM Transactions on Mathematical Software, Vol. 15,
               No. 1, March 1989, p. 79-89.

    To install:
       uudecode xfarbe.taz.uu
       uncompress xfarbe.tar.Z
       tar xvf xfarbe.tar
       cd xfarbe-2.1
       xmkmf
       make

    If you do not have imake or in case of other problems, please
    first try to use "make -f makefile.alt".

    After successful building xfarbe, the Resource file XFarbe must
    be installed:

    One copy should be at a location, where it can be modified by a
    user, for instance in the login directory. Another copy
    should reside in /usr/lib/X11/app-defaults or a similar
    directory, which is used on your system for keeping system-
    wide Resource files for Application Defaults. I recommend
    to deactivate the following two lines in XFarbe by adding the
    character "!" in the first column, before copying it to the
    Application Defaults directory:
        xfarbe.max-heights: 20
        xfarbe.max-annotation: on
    These statements are responsible for annotation of maxima,
    a feature that is not generally required.

    If you prefer to work with a copy of XFarbe in the current
    working directory, use
        "setenv XAPPLRESDIR ."
    or whatever is appropriate on your system. That will allow
    you to have different files XFarbe for different data sets in
    different directories.

    *** Note that the format of the data file "xfarbe.dat" depends
    *** on Resource settings in file XFarbe.

    Possible problems during installation are the following:

    1) xmkmf and imake are not available, or errors during
       compilation. First try "make -f makefile.alt". If there
       are still fatal errors during compilation, please send me
       a mail: preusser@fhi-berlin.mpg.de

    2) cc does not find libraries and/or include files.

       Look for the missing files on your system (a list of
       all needed files is near the end of xfarbe.doc).

        *** The Athena Widget Set (Xaw) is required. ***

       Use the -Ldir and -Idir options for cc in "makefile.alt"
       for specifying the directories of libraries and include
       files.

    3) The default fonts are not found on your server machine.

       Search for the "font"-entries in file XFarbe. Replace them
       by valid specifications for your server, for instance:
       "fixed". The "courier"-fonts should be replaced by
       other mono-spaced (typewriter) fonts.

    If you had to alter one of the C sources to get the
    program running, please give me a note.

    Read xfarbe.doc next.

    =============================================================
    The author requests:
     - that the software should not be redistributed
     - changes to the code be restricted to issues of portability
     - reference be given to the mentioned publication
    =============================================================

    Please send comments, suggestions, bugs to
          PREUSSER@fhi-berlin.mpg.de
    or
          A.PREUSSER
          Fritz-Haber-Institut der MPG
          Faradayweg 4-6
          D-14195 Berlin (Dahlem)
          Germany
          FAX: -49-30-8305-531

    Have a nice contour!