SeaDAS Installation Instructions

SeaDAS 5.4 Installation Instructions

INSTALLATION NOTES:

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").

If you encounter difficulties downloading the large distribution files you can download them in 10MB pieces and then join them back together. See the FAQ for instructions.

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 the SeaDAS shared installation page.

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), and the "idl" command must also be in your path (i.e. typing "idl" in an xterm window should start an IDL session).

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. The installation instructions below should be done in an X11 window, not in the "Terminal" application window.

Some Linux distributions(e.g. Ubuntu) come without csh initially installed. The seadas_setup script and other data processing scripts require csh in order to run successfully. If you do not have csh installed, you must install it yourself prior to SeaDAS installation. You can determine if you have csh installed by either running the command "which csh" or "ls /bin/csh". If you have root permission on your computer, try "yum install csh" or "sudo apt-get install csh", otherwise ask your system administrator to install csh.

Step

What To Do

How To Do It

In an xterm window, create a SeaDAS root directory and enter that directory (name it anything you like):

> mkdir seadas5.4
> cd seadas5.4

ftp the compressed SeaDAS tar files into your new directory (mirrors may take a while to host a new SeaDAS version):

USA:
samoa.gsfc.nasa.gov
(dir: seadas/seadas)

UK:
seadasuk.pml.ac.uk
(dir: seadas/seadas5.4)

Brazil:
orion.io.usp.br
(dir: pub/seadas)

Japan:
odyssey.fish.hokudai.ac.jp
(dir: SeaDAS_v5.4)

Australia:
ftp.marine.csiro.au
(dir: mirror/samoa.gsfc.nasa.gov/seadas/seadas_5.4)

> ftp samoa.gsfc.nasa.gov

anonymous

user@hostname

binary

cd seadas/seadas

get seadas_xxx.tar.gz (where xxx is your operation system)

get seadas_processing.tar.gz (optional for data processing)

get seadas_idl_rt.tar.gz (optional for runtime SeaDAS)

get seadas_dem.tar.gz (required for land/lake processing)

get seadas_dem_modis.tar.gz (optional for geolocation terrain correction)

get seadas_demo.tar.gz (optional)

get seadas_demo_modis.tar.gz (optional)

get seadas_demo_modis_db.tar.gz (optional)

quit

Uncompress and extract the SeaDAS tar files:

Determine your shell, and then set the SEADAS environment variable, where "PATH_TO_SEADAS" is the full directory path to seadas (e.g. /home/arthur/seadas5.4):

> echo $SHELL

> setenv SEADAS PATH_TO_SEADAS (for csh or tcsh)
OR
> export SEADAS=PATH_TO_SEADAS (for bash)

Run the SeaDAS setup program (seadas_setup) and click on the Okay button.

NOTE: You must have csh installed first before running seadas_setup!

If you have IDL installed with a *FULL* license:
> ./config/seadas_setup

OR

If you are using runtime SeaDAS:
> ./config/seadas_setup -em

Activate the Seadas setup just created:

> source config/seadas.env

If you are running under csh or tcsh, execute:
> rehash

If you are a Mac OS X user, execute:
> limit stacksize unlimited (for csh or tcsh)
> ulimit -Ss unlimited (for bash)

Depending on your shell, add the following line 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/seadas5.4):

Add this text to one of your shell init files:

     source PATH_TO_SEADAS/config/seadas.env

If you are a Mac OS X user, also add the line:
     limit stacksize unlimited (for csh or tcsh)
OR
     ulimit -Ss unlimited (for bash)

Start SeaDAS.

> seadas (if you have IDL installed)

OR

> seadas -em (to use runtime SeaDAS)

Depending on your disk space, you may want to remove the compressed tar files:

> rm *.gz (optionally do this if SeaDAS is working)

10.

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 samoa.gsfc.nasa.gov.

11.

If you want to rebuild the SeaDAS application on your system and you have the proper C and Fortran compilers, follow the instructions in the REBUILDING SEADAS NOTES section below.

12.

If you want to share SeaDAS among multiple users follow the instructions on the SeaDAS shared installation page.

REBUILDING SEADAS NOTES:

WARNING: ONLY perform these steps if you are rebuilding the SeaDAS application and you have the proper vendor C and FORTRAN compilers available on your system. SeaDAS does not support rebuilding with the g77 FORTRAN compiler. The instruction steps below will remove all the distributed libraries and binaries before regenerating them.
STEPS TO BUILD SEADAS:

Read the platform-specific Linux or Mac notes below!

Install SeaDAS, make sure it is working correclty, and then change into the $SEADAS root directory:
cd $SEADAS

Build and install all binaries and libraries by typing:
./config/build_seadas

LINUX NOTES:

Hardware/Software Requirements:

SeaDAS 5.4 for PC Linux has been developed and tested with:

   -IDL 7.0
   -Ubuntu Linux 7.10 (kernel 2.6.22)
   -Fedora Core 10 Linux (kernel 2.6.27)
   -CentOS Linux 5.2 (kernel 2.6.18)

Requirements to rebuild SeaDAS on Linux platforms:

   -C compiler (gcc). This is already included in Linux.
   -Fortran compiler. The Intel Fortran Compiler 8.0 for Linux is recommended:
         http://www.intel.com/cd/software/products/asmo-na/eng/340679.htm

MACINTOSH NOTES:

Hardware/Software Requirements:

SeaDAS 5.4 for Mac OS X has been developed and tested with:

   -IDL 7.0
   -Intel Mac OS X 10.4/10.5
   -PowerPC Mac OS X 10.4/10.5

Requirements to rebuild SeaDAS on Intel-based Mac OS X 10.4 or 10.5 computers:

   -The full (free) Apple Xcode Tools package (includes gcc 4.0):
         http://developer.apple.com/tools/xcode/
   -Intel Fortran Compiler for Mac OS X:
         http://www.intel.com/cd/software/products/asmo-na/eng/compilers/267426.htm

Requirements to rebuild SeaDAS on PowerPC-based Mac OS X 10.4 or 10.5 computers:

   -The full (free) Apple Xcode Tools package (includes gcc 4.0):
         http://developer.apple.com/tools/xcode/
   -Fortran compiler. The IBM XL Fortran v8.1 is recommended. This is a commercial package distributed by Absoft:
         http://www.absoft.com/Products/Compilers/Fortran/Macintosh/XLF/xlf.html
     (A free 60-day full-functioning version is also available):
         http://www-306.ibm.com/software/awdtools/fortran/xlfortran/features/macosx/xlf-mac.html

Curator: OceanColor Webmaster

Authorized by: gene carl feldman

Updated: Tuesday, 02-Jun-2009 22:03:32 EDT