MITgcm/lsopt/README.md

ae17457769 Andr*0001 This directory contains code to generate the libary `lsopt_ecco` need
                0002 for the optimization routine "optim.x" in `../optim`. Please refer to
                0003 rudimentary instructions in `../optim/README.md`.
                0004
                0005 The following are instruction how the different precompiled
                0006 BLAS-libraries in the directory have been obtained. If your compiling
                0007 environment includes the BLAS-library, you do not need to worry about
                0008 this.
                0009
4715ddbe97 Patr*0010 > Obtaining optimized BLAS routines for HPC platforms
                0011 > (e.g. O3K, Altix, Opteron, ...)
                0012 > heimbach@mit.edu, 9-Sep-2004
                0013 >
                0014 > 1.
                0015 > Go to
                0016 > http://www.cs.utexas.edu/users/kgoto/
                0017 > which has a set of high performance BLAS libraries for
                0018 > all kinds of platforms.
                0019 >
                0020 > 2.
                0021 > Download (e.g. for Opteron)
                0022 > http://www.cs.utexas.edu/users/kgoto/libraries/libgoto_opt64p-r0.94-2.so.gz
                0023 > which seems to be the suitable one for your Opteron 64 bit multi-threaded
                0024 > and put them in a directory, e.g. ~/mylib/
                0025 >
                0026 > 3.
                0027 > As per website instruction,
                0028 > also need the file  xerbla.f
                0029 > http://www.cs.utexas.edu/users/kgoto/libraries/xerbla.f
                0030 > Download it into the MITgcm/optim/ directory as
                0031 > xerbla.F (note capital F)
                0032 > (maybe cleaner to generate an object file and keep it in ~/mylib/ )
                0033 >
                0034 > 4.
                0035 > in .bashrc added line
                0036 > export LD_LIBRARY_PATH=~/mylib
                0037 > (consistent with the directory where I keep the library)
                0038 >
                0039 > 5.
                0040 > in MITgcm/optim/
                0041 > edit the Makefile as follows
                0042 > * add xerbla.F to             $SRC
                0043 > * add -L~/mylib/              $LIBDIRS
                0044 > * add -lgoto_opt64-r0.94-2    $LIBS
                0045 > and ignore
                0046 > -lblas1
                0047 >
                0048 > That works.
77dc7078ce Patr*0049
ae17457769 Andr*0050 ```
77dc7078ce Patr*0051 Some BLAS    libraries provided in lsopt/ are
                0052 SGI O3K:     libblas1.a_IRIX64.gz
                0053 SUN:         libblas1.a_SUN.gz
                0054 SGI Altix:   libgoto_it2-r0.95.so.gz
                0055 PC Pentium4: libgoto_p4_512-r0.94.so.gz
ae17457769 Andr*0056 ```