alexp 3/30/06

These instructions presume you are using g77 in the Athena 9.4 release
(3.4.5 20051201) as FORTRAN compiler on Linux, or f77 8.2 in the Sun
Studio 11 release (sunsoft_v11 locker) for Sun- the libraries
themselves were built with those compilers and they will most likely
produce the best results.

For C code, the recommended compilers are analogous- gcc in the Athena 9.4
release for Linux (version 3.4.5 20051201), and Sun C 5.8 2005/10/13 in
the sunsoft_v11 locker for Sun.

Add the sunsoft_v11 locker prior to Sun builds.

To build FORTRAN programs that use LAPACK, i.e. myfile.f:

add lapack_v3.0-06

g77 -O2 -o myfile myfile.f -L/mit/lapack_v3.0-06/lib -llapack -lf77blas \ (Lnx)
                                                              -latlas -lm

f77 -O -o myfile myfile.f -L/mit/lapack_v3.0-06/lib -llapack -lf77blas \ (Sun)
                                                              -latlas -lm

To build C programs that use LAPACK, i.e. myfile.c:

gcc -O2 -o myfile myfile.c -I/mit/lapack_v3.0-06/include \                (Lnx)
    -L/mit/lapack_v3.0-06/lib -llapack -lcblas -lf77blas -latlas -lm -lg2c

cc -O -o myfile myfile.c -I/mit/lapack_v3.0-06/include \                 (Sun)
   -L/mit/lapack_v3.0-06/lib -llapack -lcblas -lf77blas -latlas \
   /mit/sunsoft_v11/SUNWspro/libdynamic/libF77.so.2 \
   /mit/sunsoft_v11/SUNWspro/libdynamic/libfsu.so.1 -lm

and add the following lines at the top of your C code:

#include <g2c.h> (Lnx)
#include "f2c.h" (Sun)

Depending on your code, you may also need to add: 

#include "cblas.h"
#include "clapack.h"

for either Linux or Sun. 

On Suns at runtime for FORTRAN code, you will be likely to need to add
/mit/sunsoft_v11/SUNWspro/libdynamic to LD_LIBRARY_PATH in the shell you
launch your application from to allow it to find libF77.so.2 and libfsu.so.1
against which it may be dynamically linked.

Special note for Sun:

On Suns, you can use versions of LAPACK and BLAS supplied by Sun in the Sun
Performance Library that are part of the Solaris OS installation (i.e. not
using the libraries in the lapack_v3.0-06 locker). These may or may not
provide better performance. To link against those:

f77 -dalign -O -o file file.f -xlic_lib=sunperf -lm    (FORTRAN)
cc -dalign -O -o -I/mit/lapack_v3.0-06/include file file.c \ 
                                       -xlic_lib=sunperf -lm (C)

you may need to add 

#include "f2c.h"

to your C code.