************************************************************************
*                                                                      *
*                              SOM_PAK                                 *
*                                                                      *
*                                The                                   *
*                                                                      *
*                        Self-Organizing Map                           *
*                                                                      *
*                          Program  Package                            *
*                                                                      *
*                   Version 3.1 (April 7, 1995)                        *
*                                                                      *
*                          Prepared by the                             *
*                    SOM Programming Team of the                       *
*                 Helsinki University of Technology                    *
*           Laboratory of Computer and Information Science             *
*                Rakentajanaukio 2 C, SF-02150 Espoo                   *
*                              FINLAND                                 *
*                                                                      *
*                     Copyright (c) 1992-1995                          *
*                                                                      *
************************************************************************
*                                                                      *
*  NOTE: This program package is copyrighted in the sense that it      *
*  may be used for scientific purposes. The package as a whole, or     *
*  parts thereof, cannot be included or used in any commercial         *
*  application without written permission granted by its producents.   *
*  No programs contained in this package may be copied for commercial  *
*  distribution.                                                       *
*                                                                      *
*  All comments concerning this program package may be sent to the     *
*  e-mail address 'som@nucleus.hut.fi'.                                *
*                                                                      *
************************************************************************

This package contains all the programs necessary for the application
of Self-Organizing Map algorithms in an arbitrary complex data
visualization task.  

In the implementation of the SOM programs we have tried to use as
simple a code as possible.  Therefore the programs are supposed to
compile in various machines without any specific modifications made on
the code.  All programs have been written in ANSI C.

The som_pak program package includes the following files:
  - Documentation:
      README             this file
      som_doc.ps         documentation in (c) PostScript format
      som_doc.ps.Z       same as above but compressed
      som_doc.txt        documentation in ASCII format
  - Source file archives:
      som_p3r1.exe       Self-extracting MS-DOS archive file
      som_pak-3.1.tar    UNIX tape archive file
      som_pak-3.1.tar.Z  same as above but compressed

Installation in UNIX (in more detail, see som_doc.ps/txt):
  - Uncompress som_pak-3.1.tar.Z
  - Extract the files with "tar xovf som_pak-3.1.tar" which creates
    the subdirectory som_pak-3.1
  - Copy makefile.unix to the name makefile
  - Revise switches in the makefile, if necessary
  - Execute "make"

Installation in MS-DOS (in more detail, see som_doc.ps/txt):
  - By executing the command som_p3r1 the self-extracting archive
    creates the directory som_pak.3r1 and extracts all the files in it
  - You are supposed to use Borland C++ Version 3.1 and to have
    all the necessary environment settings
  - Copy the file makefile.dos to the name makefile
  - Revise the compiler switches in the makefile, if necessary
  - Execute "make"

Revision history:
  - Version 1.0 was released 9 October 1992.
  - Version 1.1 with a minor modification (in Eq. (3)) was released
    14 October 1992.
  - Version 1.2 with two corrections in the code was released 2 November
    1992.
  - Version 3.0 containing new programs for the visualization of results
    and many advanced features conserning application of the algorithms
    in large problems was released March 1, 1995; for these changes see
    documentation.
  - Version 3.1 containing only a bug fix in random ordering
    was released 7 April 1995.