=======================================================================
                      README ScaLAPACK Installer
=======================================================================

Version: 0.92
Release date: 0.92 .... August 8th 2008
              0.91 .... March 17th 2008
University of Tennessee

==========================================================================
INTRODUCTION


The ScaLAPACK installer is a set of python scripts developed to ease
the installation of the ScaLAPACK library. It can automatically
download, configure and compile the ScaLAPACK including all its
dependencies that are BLAS, LAPACK and BLACS libraries. All it needs
is the mpi C and FORTRAN compilers mpicc and mpif77 (note that the
names of these compilers may be different than mpicc and mpif77 on
some systems). Please note that this is an alpha version and, even if
it has been tested on a wide set of systems, may not work. In case you
encounter a problem, your feedback would be greatly appreaciated and
would be very useful to improve the quality of this installer.
Please submit your complaints and suggestions to scalapack@cs.utk.edu
or on the lapack/scalapack forum: http://icl.cs.utk.edu/lapack-forum/


==========================================================================
INSTALL

Here's a list of the flags that can be used to provide the installer
information about the system like, for example, the mpi compilers, the
libraries that are already present on the system and need not be downloaded.

          
          -h or --help         : prints this message

          --prefix             : path where to create the libraries, build and log of the installer

          --mpibindir=[DIR]    : the path to where the mpi
                                 binaries (mpicc and mpif77)
                                 are contained

          --mpicc=[CMD]        : the mpicc command.

          --mpif77=[CMD]       : the mpif77 command.

          --mpiincdir=[DIR]    : the path to the directory
                                 containing mpi.h

          --ccflags=[FLAGS]    : the flags for the C compiler
                                 (default -O3)

          --fcflags=[FLAGS]    : the flags for the F77 compiler
                                 (default -O3)

          --noopt=[FLAGS]      : compilation flags to be used
                                 on machine dependent subroutines
                                 in LAPACK, BLACS and ScaLAPACK.
                                 See LAPACK, BLACS and ScaLAPACK documentation.

          --ldflags=[flags]    : loader flags

          --makecmd=[CMD]      : the make command
                                 (make by default)
          --blacslib=[LIB]     : the BLACS library

          --blacsclib=[LIB]    : the BLACS C interface library

          --blacsf77lib=[LIB]  : the BLACS F77 interface library

          --blaslib=[LIB]      : a BLAS library

          --lapacklib=[LIB]    : a LAPACK library

          --downblas           : if you do not want to provide a BLAS
                                 we can download and install it for you

          --downblacs          : if you do not want to provide a BLACS
                                 we can download and install it for you

          --downlapack         : if you do not want to provide a LAPACK
                                 we can download and install it for you

          --notesting          : disables the ScaLAPACK testing. The
                                 BLAS, BLACS and LAPACK libraries are not
                                 required in this case.

          --clean              : cleans up the installer directory.

Note: If you want use a proxy for downloading, the http_proxy environment variable has to be set.

If the required packages cannot be automatically downloaded (for
example, because no network connection is available on the system),
you can take them any way you like from the following URLs and place
them in the build directory (if the directory does not exist, create
it):

BLAS      : http://netlib.org/blas/blas.tgz
LAPACK    : http://netlib.org/lapack/lapack-lite.tgz
BLACS     : http://netlib.org/blacs/mpiblacs.tgz
ScaLAPACK : http://netlib.org/scalapack/scalapack.tgz

Please note that, in the case where the installer is asked to
automatically download and install the BLAS library, the reference
BLAS is installed and, thus, very low performance is to be expected.
It is strongly recommended that you use an highly optimized BLAS
library (like ATLAS, MKL, GotoBLAS, ESSL etc.) and provide a path to
its location through the --blaslib flag.




==========================================================================
AUTHORS

The authors of the ScaLAPACK installer are:

Alfredo Buttari   (Electrical Engineering and Computer Science Department, University of Tennessee Knoxville)
Julien Langou     (Department of Mathematical Sciences, University of Colorado Denver)
Julie Langou      (Electrical Engineering and Computer Science Department, University of Tennessee Knoxville)