==============================================

==========================
How to Install SeaDAS 6.4
==============================================
==========================
NOTES:
* Delete or move any previous versions of SeaDAS. Do not install a new
version of SeaDAS "on top of" an old version. Instead, before installing
SeaDAS remove or move any previous versions and also disable any lines
in your shell initialization files that set up the old SeaDAS environment
(e.g. "export SEADAS=old/path/to/seadas", setenv SEADAS
old/path/to/seadas",
"source old/path/to/seadas/config/seadas.env").
* The processing scripts are written in python and use core functions
introduced with version 2.6. If your system does not have a version 2.6 or
above you will not be able to use the data processing capabilites of
SeaDAS.
(Additionally, python 3.0 is not yet supported)
* If you are NOT using runtime SeaDAS, IDL must be installed on your
computer along with its high resolution coastline database (found under
IDL's Custom Installation section). IDL must also be in your path (i.e.
typing "idl" in an xterm window should start an IDL session). Mac OS X
users please note that if you already have a floating IDL license in a
UNIX environment, a Mac running OS X can also use this floating license.
* Do not install or run SeaDAS as the root user. Doing so is a security
hazard and may also lead to functionality problems. To install one
version of SeaDAS to be shared by multiple users, see:
http://oceancolor.gsfc.nasa.gov/seadas/doc/toplevel/shared.html
* Mac OS X users must have X11 installed in order to use SeaDAS. To
determine if X11 is installed on your computer, look for the
"Applications/Utilities/X11" application. If it is not present, please
install X11 from your OS X Installation Disc.

==============================================
==========================

SEADAS INSTALLATION STEPS:

1. Create a SeaDAS root directory and enter that directory:
> mkdir seadas6.4 (this directory can be named whatever you like)
> cd seadas6.4
2. ftp or copy the required SeaDAS tar files into this directory. (See
http://oceancolor.gsfc.nasa.gov/seadas/download.html for ftp sites.)
3. Uncompress and extract the SeaDAS application tar file:
> gunzip -c seadas_xxx.tar.gz | tar xvpf (where xxx = linux, linux_64, macosx_intel, or macosx_ppc)
4. ***OPTIONAL RUNTIME SEADAS OPTION ***
(If you have not purchased and installed IDL, you must install this!)
Uncompress and extract the embedded IDL runtime license file:
> gunzip -c seadas_idl_rt.tar.gz | tar xvpf 5. ***OPTIONAL FOR DATA PROCESSING CAPABILITIES***
Uncompress and extract the SeaDAS data tar files:
> gunzip -c seadas_processing_common.tar.gz | tar xvpf (Required to enable data processing)
> gunzip -c seadas_processing_xxx.tar.gz | tar xvpf (where xxx = linux, linux_64, macosx_intel...
Required to enable data processing)
> gunzip -c seadas_seawifs.tar.gz | tar xvpf (Required for SeaWiFS processing)
> gunzip -c seadas_seawifs_soa.tar.gz | tar xvpf (Required for the SeaWiFS spectral optimization algorithm)
> gunzip -c seadas_modisa.tar.gz | tar xvpf (Required for MODIS Aqua processing)
> gunzip -c seadas_modist.tar.gz | tar xvpf (Required for MODIS Terra processing)
> gunzip -c seadas_meris.tar.gz | tar xvpf (Required for MERIS processing)
> gunzip -c seadas_octs.tar.gz | tar xvpf (Required for OCTS processing)
> gunzip -c seadas_czcs.tar.gz | tar xvpf (Required for CZCS processing)
> gunzip -c seadas_ocm.tar.gz | tar xvpf (Required for OCM1 and OCM2 processing)
> gunzip -c seadas_dem.tar.gz | tar xvpf -

(Required only for processing over land and high altitude lakes)
> gunzip -c seadas_dem_modis.tar.gz | tar xvpf (Required only for MODIS geolocation terrain correction)
> gunzip -c seadas_source.tar.gz | tar xvpf (Required for recompiling SeaDAS from source)
6. ***OPTIONAL BENCHMARK FILES***
Uncompress and extract SeaDAS benchmark tar file if you have it:
> gunzip -c seadas_benchmarks.tar.gz | tar xvpf 7. Run the SeaDAS setup program and press the Okay button:
-If you are using runtime SeaDAS:
> ./config/seadas_setup -em
-OR, if you have IDL installed with a full license:
> ./config/seadas_setup
8. Activate the Seadas setup just created.
> source config/seadas.env
-If you are running under csh or tcsh, update the hash search tables.
> rehash
9. Depending on your shell, add the following line(s) to the *END* of your
.cshrc, .tcshrc, or .bashrc file, where "PATH_TO_SEADAS" is the full
directory path of your seadas directory (e.g. /home/zaphod/seadas6.1):
source PATH_TO_SEADAS/config/seadas.env
10. Start SeaDAS!
-If you wish to run SeaDAS in embedded IDL mode:
> seadas -em
-If you have IDL installed along with a full IDL development license:
> seadas
11. Depending on how much disk space you have available, you may
want to either move or delete the compressed tar files (*.gz).
12. Check periodically for new SeaDAS updates. You do not need to install
any updates if you have just installed SeaDAS, since the updates are
included in the main tar file distributions. Updates can be
downloaded from the SeaDAS distribution directory via anonymous ftp
from ftp://samoa.gsfc.nasa.gov/seadas/seadas/.

13. If you want to rebuild the SeaDAS application on your system and you
have the proper C and FORTRAN compilers, follow the instructions below
in the REBUILDING SEADAS section.
==============================================
==========================
REBUILDING SEADAS:
* ONLY perform these steps if you are rebuilding SeaDAS, *
* and the proper compilers are installed on your system. *
Required compilers:
SeaDAS can be rebuilt with either the free gcc/g++/gfortran compilers,
or the Intel C and Fortran compilers (The SeaDAS distributions are built
with gcc, g++, and gfortran.) Though the Intel compilers are not free
(an exception being the Linux non-commercial license), they will likely
provide processing speed gains.
Intel Compilers:
http://software.intel.com/en-us/intel-compilers/
http://software.intel.com/en-us/articles/non-commercial-softwaredevelopment/
If using gfortran, the currently supported versions are:
Linux: gfortran 4.4, 4.5, 4.6
Intel Mac: gfortran 4.4, 4.5, 4.6
Current gfortran binary distributions can be downloaded here:
http://gcc.gnu.org/wiki/GFortran
Required system libraries:
The libz compression library is required for some of the third-party libraries
used by SeaDAS. If it is not installed by default on your system, you can
obtain it from http://zlib.net (or use your installations package manager to
install it - the prefered method...)

******************************************
STEPS TO BUILD A SEADAS PROCESSING BINARY:
1. Install SeaDAS. You will need to have also installed the source code:
seadas_source.tar.gz
2. Check to make sure the compilers you want to use are configured via
the OCSSW_CC, OCSSW_CXX, and OCSSW_FC environment variables, e.g.:
$ env |grep OCSSW_
OCSSW_CC=gcc
OCSSW_CXX=g++
OCSSW_FC=gfortran (you may also need to set FC=gfortran)
NOTE: If you choose to use a different compiler (and possibly version of
a compiler) than was used for the distribution you may need to
first rebuild any libraries used by the program. In this situation
it might be simplest to just rebuild the entire SeaDAS package
with your chosen compiler (see the next section, STEPS TO BUILD THE
ENTIRE SEADAS PACKAGE).
3. For linux, you may want to set GCC_TUNE environment variable, e.g.:
export GCC_TUNE="-mtune=opteron"
OR
export GCC_TUNE="-mtune=core2"
4. The SeaDAS processing programs require several third-party libraries. The
sources for these packages are included under the $SEADAS/build/lib3/src
directory. These must be built prior to building the processing programs:
cd $SEADAS/build/lib3/src
./BuildIt
5. All SeaDAS processing programs and libraries are stored under the
$SEADAS/build/src/ directory. To build a particular binary,
change into that program's directory, e.g.:
cd $SEADAS/build/src/l2gen
make clean
make
In this example the l2gen directory actually contains the code for
various binaries, and all will be built when only 'make' is executed.

To build only the l2gen binary you would issue the command:
make -f l2gen.mk
5. If you binary compiles successfully, you can then copy it into the
$SEADAS/run/bin/ directory. BACKUP THE ORIGINAL BINARY FIRST!
cp l2gen $SEADAS/run/bin
Alternatively, you can use cmake if you have it on your system.
To use cmake:
1. Make sure the third party libraries are built (see #4 above)
2. create a directory under $SEADAS/build from which to run cmake
(e.g. mkdir $SEADAS/build/cbuild).
3. change directories to this new "cbuild" directory
cd $SEADAS/build/cbuild
4. set up the cmake environment:
cmake ../
5. run make, make install - you can build individual binaries by entering
the corresponding cbuild subdirectory and run make/make install from
within the subdirectory.
*****************************************
STEPS TO BUILD THE ENTIRE SEADAS PACKAGE:
*
*
*
*

WARNING: The instruction steps below will delete all the distributed *
binaries and libraries before regenerating them. Backup the
*
$SEADAS/run/bin/ and $SEADAS/build/lib/ $SEADAS/build/lib3
*
directories before compiling!
*

1. Install SeaDAS.
2. Check to make sure the compilers you want to use are configured via
the OCSSW_CC, OCSSW_CXX, and OCSSW_FC environment variables, e.g.:
$ env |grep OCSSW_
OCSSW_CC=gcc
OCSSW_CXX=g++
OCSSW_FC=gfortran (you may also need to set FC=gfortran)
3. For linux, you may want to set GCC_TUNE environment variable, e.g.:

export GCC_TUNE="-mtune=opteron"
OR
export GCC_TUNE="-mtune=core2"
4. Build the entire SeaDAS package:
cd $SEADAS
./config/build_seadas
or with cmake:
./config/cmake_build_seadas
5. Check the final lines of the build script's stdout to make sure the
expected number of bins/libs were created. If there was a problem
check the makec4idl.out, makelib3.out, makesrc.out and makeutils.out
build log files.
==============================================
==========================