======================================================================= 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)