1README -- BlockSolve95 v3.0 2--------------------------------------------------------------- 3 4The BlockSolve95 package contains routines for solving large 5sparse symmetric systems of linear equations on massively 6parallel distributed memory systems and networks of workstations. 7 8BlockSolve95.tar.Z 9--------------------------------------------------------------- 10 11The compressed tar file includes five directories under the 12main BlockSolve95 directory: 13examples -- contains example programs that call BlockSolve95 14src -- the source for BlockSolve95 15doc -- contains subdirectories with the manual (in tex, dvi and postscript) 16 as well as UNIX man pages for the important BlockSolve95 routines 17include -- the include files for BlockSolve95 18bmake -- the makefile stuff from PETSc 19lib -- the directory for the BlockSolve95 libraries 20 21Also included in the main BlockSolve95 directory are four files: 22README -- this file. 23MACHINES -- information on each of the machines on which BlockSolve95 24 has been tested. You should see if there are any potential 25 problems on the machine you intend to install BlockSolve95. 26MPI -- information some problems and version differences w.r.t. MPI 27COPYRIGHT -- information about the BlockSolve95 copyright 28 29Instructions for installing BlockSolve95 30--------------------------------------------------------------- 31 32First you must unbundle BlockSolve95.tar.Z. 33This file was created with command: 34 tar cf - BlockSolve95 | compress > BlockSolve95.tar.Z 35and the file can be unbundled with the command 36 zcat BlockSolve95.tar.Z | tar xvf - 37 38Instructions for making BlockSolve95 39--------------------------------------------------------------- 40 41The makefiles are set up using the PETSc bmake facility. One can 42build the BlockSolve95 library, make the example programs, delete libs, 43and run the example programs all from the root BlockSolve95 directory. 44 45You need to have the environmental variable PETSC_ARCH set to the 46correct architecture (eg, setenv PETSC_ARCH rs6000). You could also 47include this argument (eg, PETSC_ARCH=rs6000) on the command line 48when calling make. 49 50For more details on specific machines, please read the MACHINES file. 51 52To make the (optimized) libraries one does: 53make ACTION=lib BOPT=O tree 54 55To make the (optimized) libraries faster one can do: 56make ACTION=libfast BOPT=O tree 57make ACTION=ranlib BOPT=O tree 58 59To make the example programs one does: 60make ACTION=examples BOPT=O tree 61 62To delete the libs one does: 63make ACTION=deletelibs BOPT=O tree 64 65To run the BlockSolve95 example programs one does: 66make ACTION=bsrunexamples tree 67 68All the site dependent definitions are in the files 69bmake/$(PETSC_ARCH)/$(PETSC_ARCH).site For example, 70# 71# Fortran libraries the C linker needs 72# 73FC_LIB = /usr/lang/SC1.0.1/libF77.a -lm /usr/lang/SC1.0.1/libm.a 74# 75# Blas and Lapack libraries 76# 77BLAS_LIB = /usr/local/lapack/lib/blas.a $(FC_LIB) 78LAPACK_LIB = /usr/local/lapack/lib/lapack.a 79# 80# MPI libraries and include files and mpirun 81# 82MPI_LIB = /usr/local/mpi/lib/sun4/ch_p4/libmpi.a 83MPI_INCLUDE = -Dmpi -I/usr/local/mpi/include 84MPIRUN = mpirun 85# 86# Where the BlockSolve95 include files are, and the BlockSolve95 library 87# 88BS_INCLUDE = -I/home/plassman/BlockSolve95/include 89BS_LIB = /home/plassman/BlockSolve95/lib/lib$(BOPT)/$(PETSC_ARCH)/libBS95.a 90 91Instructions for UNIX man pages 92--------------------------------------------------------------- 93BlockSolve95 includes UNIX man pages for all its routines. 94These may be accessed by including $BSHOME/BlockSolve95/doc/man 95in your MANPATH environmental variable with setenv (where $BSHOME 96is your local directory path to the BlockSolve95 directory. 97We recommend using "xman" to view the man pages; the routine 98pages may be found under "BlockSolve95 routines" (section 3) 99and the include files in "BlockSolve95 include files (section h). 100 101The BlockSolve95 users manual 102--------------------------------------------------------------- 103A postscript (manual.ps) and dvi (manual.dvi) version of the 104user's manual may be found in the directory doc/manual. 105 106Problems with BlockSolve95 107--------------------------------------------------------------- 108Email any problems with BlockSolve95 to either 109jones@cs.utk.edu or plassman@mcs.anl.gov. 110Please include the version number as found in the 111file include/BSsparse.h. 112 113