1. You have successfully unbundled ARPACK and are now in the ARPACK directory that was created for you. 2. Upon executing the 'ls | more ' command you should see BLAS DOCUMENTS EXAMPLES LAPACK README SRC UTIL Makefile ARmake.inc ARMAKES The following entries are directories: ARMAKES, BLAS, DOCUMENTS, EXAMPLES, LAPACK, SRC, UTIL The directory SRC contains the top level routines including the highest level reverse communication interface routines ssaupd, dsaupd - symmetric single and double precision snaupd, dnaupd - non-symmetric single and double precision cnaupd, cnaupd - complex non-symmetric single and double precision The headers of these routines contain full documentation of calling sequence and usage. Additional information is in the DOCUMENTS directory. 3. Example driver programs that illustrate all the computational modes, data types and precisions may be found in the EXAMPLES directory. Upon executing the 'ls EXAMPLES | more ' command you should see BAND COMPLEX NONSYM README SIMPLE SVD SYM Example programs for banded, complex, nonsymmetric, symmetric, and singular value decomposition may be found in the directories BAND, COMPLEX, NONSYM, SYM, SVD respectively. Look at the README file for further information. To get started, get into the SIMPLE directory to see example programs that illustrate the use of ARPACK in the simplest modes of operation for the most commonly posed standard eigenvalue problems. The following instructions explain how to make the ARPACK library. 4. Before you can compile anything, you must first edit and correct the file ARmake.inc. Sample ARmake.inc's can be found in the ARMAKES directory. Edit "ARmake.inc" and change the definition "home" to the root of the source tree (Top level of ARPACK directory) The makefile is set up to build a self-contained library which includes the needed BLAS 1/2/3 and LAPACK routines. If you already have the BLAS and LAPACK libraries installed on your system you might want to change the definition of DIRS as indicated in the ARmake.inc file. *** NOTE *** The LAPACK library on your system MUST be the public release. The current release is version 2.0. If you are not certain if the public release has been installed, we strongly recommend that you compile and link to the subset of LAPACK included here. 5. You will also need to change the file "second.f" in the UTIL directory to whatever is appropriate for timing on your system. The "second" routine provided works on most workstations. If you are running on a Cray, you can just edit the makefile in UTIL and take out the reference to "second.o" to use the system second routine. 6. Do "make lib" in the current directory to build the standard library "libarpack_$(PLAT).a" 7. Within DOCUMENTS directory there are three files ex-sym.doc ex-nonsym.doc and ex-complex.doc for templates on how to invoke the computational modes of ARPACK. Also look in the README file for explanations concerning the other documents. Danny Sorensen at sorensen@caam.rice.edu Richard Lehoucq at lehoucq@mcs.anl.gov Chao Yang at chao@caam.rice.edu Kristi Maschhoff at kristyn@caam.rice.edu Good luck and enjoy.