Installation of the NNPP Package
	      ----------------------------------------

[1] This package contains three neural network algorithms that can be used
    for object identification and pattern recognition.  The packages are 
    'bp' which is a backpropagation network, 'lvq' which is Learning Vector
    Quantization, and 'som' which is the Self-Organizing Map.  Each of
    these tasks has several subtasks which perform certain functions.  There
    are help files for each task in the package.  The help files explain
    how to run that tasks as well as how to format your data for input.
    The backpropagation package is based on NevProp.  See the file
    README.NevProp.  The SOM and LVQ packages are based on the routines 
    SOM_PAK and LVQ_PAK.  See the file README.SOM-LVQ.

    Because it is not practical to explain all the details of these algorithms,
    we refer you to the following references for additional details:

    Hertz, J., Krogh, A, and Palmer, R.G., 1991, "Introduction to the Theory
    of Neural Computation", (Redwood City, CA:  Addison-Wesley)

    Kohonen, T, 1995, "Self-Organizing Maps", (Berlin:  Springer-Verlag)

    These are both excellent texts on the subject and both contain a wealth
    of primary and secondary references. 

    If you have any questions, please contact the author at 
    bazell@jansky.gsfc.nasa.gov.

[2] Create a directory to contain the NNPP external package files.  This
    directory should be outside the IRAF directory tree and must be owned
    by the IRAF account.  In the following examples, this root directory
    is named usr1:[nnpp] (VMS) or  /local/nnpp/ (UNIX).  Make the appropriate 
    file name substitutions for your site.

[3] Log in as IRAF and edit the extern.pkg file in the hlib directory to
    define the package to the CL.  From the IRAF account, outside the CL,
    you can move to this directory with the commands:

	$ set def irafhlib			# VMS example
	% cd $hlib				# UNIX example

    Define the environment variable nnpp to be the pathname to the nnpp 
    root directory.  The '$' character must be escaped in the VMS pathname;
    UNIX pathnames must be terminated with a '/'.  Edit extern.pkg to include:

	reset nnpp      = usr\$1:[nnpp]   	# VMS example
	reset nnpp      = /local/nnpp/	# UNIX example

	task  nnpp.pkg = nnpp$nnpp.cl

    Near the end of the hlib$extern.pkg file, update the definition of helpdb
    so it includes the nnpp help database, copying the syntax already used
    in the string.  Add this line before the line containing a closing quote:
        
                ,nnpp$lib/helpdb.mip\

[4] Log into the CL from the IRAF account and unpack the archive file.  Change
    directories to the NNPP root directory created above and use 'rtar':

	cl> cd nnpp
	cl> softools
	so> rtar -xrf <archive>  where <archive> is the host name of the
				 archive file or the IRAF tape
				 device for tape distributions.

   On VMS systems, an error message will appear ("Copy 'bin.generic' to
   './bin fails") which can be ignored.  Also on VMS systems, the four
   bin.'mach' directories created by rtar under [newimred.bin] can be
   deleted.  UNIX sites should leave the symbolic link 'bin' in the NNPP
   root directory pointing to 'bin.generic' but can delete any of the 
   bin.`mach' directories that won't be used.  The archive file can be
   deleted once the package has been successfully installed.

[5] When the archive has been unpacked, build the NNPP package executable.  
    The compilation and linking of the NNPP package is done using the 
    following command:

	cl> mkpkg -p nnpp update >& nnpp.spool &

    NOTE: Since the package is distributed in a 'gerneric' configuration
    you must configure the system for the desired architecture before issuing
    the above command.  SUN/IRAF sites must execute a pair of 'mkpkg' comm-
    ands for each supported architecture type.  The Unix environment variable
    IRAFARCH must be set as well before compiling.  For example:

	# Assuming IRAFARCH is set to sparc
	cl> mkpkg -p nnpp sparc
	cl> mkpkg -p nnpp update >& nnpp.sparc &

    The spool file(s) should be reviewed upon completion to make sure there
    were no errors.  

[6] An alternative to compiling from sources is to simply install the
    binaries that may also be retrieved from the archive in the same dir-
    ectory.  To do this uncompress and untar the downloaded file in the
    appropriate bin directory.  For example, to install the SunOS sparc
    binaries:

	cl> cd nnpp$bin.sparc
	cl> softools
	so> !uncompress /<path>/nnpp-bin.sparc.Z   # uncompress tar file
	so> rtar -xrf /<path>/nnpp-bin.sparc	    # unpack binaries


------------------------
CHANGES IN THIS RELEASE:
------------------------
This is the first release, May, 1997.