                       GAGS Installation Guide

      GAGS (Genetic Algorithms from Granada, Spain) is a library
and companion programs written and designed to take the heat out
of designing a genetic algorithm. It features a class library for
genetic algorithm programming, but, from the user point of view,
is a genetic algorithm application generator. Just write the
function you want to optimize, and GAGS surrounds it with enough
code to have a genetic algorithm up and running, compiles it, and
runs it.

      GAGS is (for the time being) available at ftp://kal-
el.ugr.es/pub, under the name GAGS.tar.gz.


      GAGS needs several unix utilities whose use is widespread,
and you should make sure you have them in your path before
starting to install it.

      These utilities 
*_g++_ (GAGS is written in c++, so that there's no other way out),
or equivalent at&t c++ 3.0-compliant compiler, 
*_perl_ (used in the application generator; you will not be able
to use it if perl is not installed -- thanks, Larry Wall, for
it!) and 
*_gnuplot_ (for interactive graphical presentations). 

The cshell must also be installed in /bin/csh, since the
installation scripts have been written for it. The installation
procedure checks this, so that it will probably complain if there
is something missing.

      Installation proceeds as follows:

1. Edit install.sh, and change installation directories (LIBDIR,
INCDIR and BINDIR) to the ones you want to actually install GAGS.

2. Run it
      unix_prompt% install.sh {sun|sgi}
I have tested the program in these two machines, and it runs OK,
the only difference being that the Silicon Graphics does not need
ranlib. So, if your machine uses ranlib, use sun; if not, use
sgi.

      This script compiles the library, and copies files to their
proper places. After running it, you are ready to run the
application generator, called GAGS.pl, which will be in the
$bindir directory. If you want to have it handy from then on,
include that directory into your path. 

3. Test the library on the demo fitness files
unix_prompt% makedemos
This program will ask you about the base directory in which you
have installed GAGSlib(the include, bin and lib directories
should hang from the same directory), and then run gags.pl, the
application generator.

There are 2 demo fitness function files, minsqu.ga and
minsqu2.ga; and one training file, nube (spanish for cloud); it
is a more or less gaussian cloud with 40 points centered around
0.02, -0.05, more or less. Both fitness functions try to reach
the center by minimizing the total distance to all the points,
thus, the chromosome contains only 2 parameters, corresponding
to the coordinates of the central point.

4. Print and have a look at the user's manual, _gagsman.ps_ or
_gagsman.txt_