packages icon
			Eigen public release 1.0
			------------------------

Eigen is C-language package of routines for finding the N largest eigenvalues
of an SxS real symmetric matrix, and their respective orthonormal eigenvectors.
The distinction of this package from other packages is that Eigen does not
find all the eigenvalues and eigenvectors of the matrix, but only the ones
that you are looking for.
To read the mathematical formulation of the algorithms used by this package,
either format report.ms with troff -ms, or use the PostScript file report.ps.
The manual of how to use the C routines within your programs is in eigen.3,
and should be read after reading the report.
To create the C library, just type 'make', and the library eigen.a will be
created. Programs using the eigen package should be linked with the eigen.a
library. If your C compiler does not support the -O4 optimization command,
then you might want to use -O or nothing instead of the -O4 in the makefile.

Since this is the first public release of the Eigen package, I couldn't have
yet tested this package with "real" matrices, only with randomly generated
matrices. So, this package might still have some bugs that I didn't notice.
If you get any error messages from the package, notice any peculiar behavior,
any bugs, or just have a comment on the package , please send in the bug report
or comment to nyh@gauss.technion.ac.il, with a detailed explanation of the
problem, and if possible, a sample program recreating the problem, and I'll
try to fix it.
Unfortunately, the Eigen Package is known not to work with matrices of size
about 700x700 or above. I'll try to fix this problem in the next releases.


Getting the Eigen package
-------------------------

If you are reading this README file, than you probably already have the package.
If, however, you want to get the newest version, the official anonymous ftp site
for Eigen is gauss.technion.ac.il (132.68.112.60), on directory /eigen.

For more information about our site's anonymous ftp site, do
 telnet gauss.technion.ac.il 4096


---
Nadav Har'El                         | ######  ########     # | <-- Sorry if
Email: nyh@gauss.technion.ac.il      |      #       #       # |    you can't
Department of Mathematics, Technion  |      #       #       # |    read Hebrew.
Israel Institute of Technology       | ########     #  ###### |    Nadav. ;)