  This is MUTINFO, a program to compute the mutual information from time 
delayed time series. The current version is 1.21 as of June 19, 1992.
This version includes the variant 'muin2ser'.

For a complete description of theory and algorithm, see:

   A.M. Fraser & H.L. Swinney, "Independent Coordinates for Strange
   Coordinates from Mutual Information", Phys.Rev. 33A, 1134 (1986).

  The program is written in mixed C/Fortran language. The user interface is
written in C and implements the program as a UNIX command. The input parameters 
are specified as command line options. The necessary memory is allocated 
dynamically by the C procedure so that the user needs not to change any array 
bounds.

  To install it, simple edit the Makefile changing the variables BINDIR and
MANDIR to your local needs. Type "make" to compile and "make install" to 
install it.

  The file 'test.dat' contains a short strip of Roessler's chaos along with the
results 'test.mutinfo', obtained via the command
        'mutinfo -l 0.0 -u 2.0 -d 0.2 test.dat > test.mutinfo'.
Use the command
        'make test'
to check the integrity of the installed binary.

  The code consists of fairly standard Fortran 77 with very few common VMS 
extensions (long variable names and `!'-comments).  The C code should compile 
on any UNIX system (Ansi or K&R). If you don't have the pipe mechanism (such as 
VMS or DOS), comment out the specific stuff in "mutinfo.c" and set "have_pipe"
to -1.

  The mixed language programming depends on the availability of a common object 
format. We have succeeded in compiling on SUN Sparcstations, DECstations,
HP 9000 and IBM 6000 workstations, but cannot guarantee for other platforms.

  Binaries for these architectures are included in the 'bin'-directory.

  The documentation consists of a man-page (rather bad translation from German 
to English). The subdirectory "german" contains the german man-page and a 
document in LaTeX, which is essentially the theoretical background from the 
Fraser paper.

  The variant 'muin2ser' computes the mutual information from two given time 
series selectable out of an array of n ones. No dependency on the delay time is 
performed.

Comments and bug reports are welcome to the authors.

Happy computing,
Thomas.
<kruel@phys-chemie.uni-wuerzburg.dbp.de>
