Announcement:  SeaDAS 5.0 now available!

Dear SeaDAS Users,

SeaDAS 5.0 is now available on our ftp site.  This update provides:

Major Changes from SeaDAS 4.9:

* New msl12 Version 5.5.2:

        - Provides MODIS high-resolution 250-meter and 500-meter processing support.

        - Instead of creating a parameter file named msl12.par, it now creates a parameter
          file whose name is based on the output filename.  This allows you to run multiple
          instances of msl12 simultaneously.

        - The command-mode now works correctly when mixing a parameter file with other
          parameters on the command-line.  Parameters on the command-line will override
          any of the same parameters defined within the parameter file.

* New l2bin, l3bin, and smigen programs.

* Display support for AVHRR Version 5 data.

* Processing support for new ocean color formatted CZCS data.

* Direct Broadcast code improvements:

        - New write_5min_gran utility will split Level 0 granules into separate chunks
          of length specified by the user.

        - Bug fixes to fix_L0 and write_constructor_file to handle incomplete scans.

        - Added the fix_L0 functionality directly into the Level 0 processing script
          modis_L0_to_L1A_GEO.csh.

* New LUT features:  Custom LUTs are now distributed with SeaDAS.  When loading a color
  LUT, SeaDAS will now list custom LUTs along with the  standard IDL LUTs.  Using SeaDAS,
  users can easily create and save their own LUTs and place them in the
  $SEADAS/data/common/luts/custom/ directory in order to access them automatically from
  SeaDAS.  We hope this will lead to community-standardized LUTs including case-2,
  region-specific, holiday-themes, etc.  If anyone has some LUTs they want to include,
  please let us know.

* New Aqua and Terra LUTs.

* New data test suite and benchmarking script.

The SeaDAS Development Group

  ========================================================================
                         How to Install SeaDAS 5.0
  ========================================================================

NOTES:

* Delete or move any previous versions of SeaDAS. Do not install a new
   version of SeaDAS "on top of" an old version.

* The following installation instructions are for users using the C-shell
   (csh or tcsh) or bash shell (bash). (To determine your shell-type
   execute the command "echo $SHELL" in an xterm window.)

* 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.

* 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 OS X Panther Install Disc 3. For versions of OS X
   earlier than 10.3, check for the application "Applications/XDarwin",
   and if it is not present download XDarwin from:
   http://sourceforge.net/project/showfiles.php?group_id=18034

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

SEADAS INSTALLATION STEPS:

  1. Create a SeaDAS root directory and enter that directory:

         > mkdir seadas5.0 (this directory can be named whatever you like)
         > cd seadas5.0

  2. ftp or copy all the SeaDAS tar files into this directory.

  3. Uncompress and extract the SeaDAS application tar file:

         > gunzip -c seadas_xxx.tar.gz | tar xvpf -
           (where xxx = irix6.5, solaris2.7, solaris2.8, rhlinux7.3,
           fedcore2, fedcore4, centos4.2, or macosx10.3)

  4. ***OPTIONAL FOR DATA PROCESSING CAPABILITIES***
     Uncompress and extract the SeaDAS data tar files:

         > gunzip -c seadas_processing.tar.gz | tar xvpf -
           (Required for all 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)

  5. ***OPTIONAL RUNTIME SEADAS OPTION***
     Uncompress and extract the embedded IDL runtime license file:

         > gunzip -c seadas_idl_rt.tar.gz | tar xvpf -

  6. ***OPTIONAL FOR DEMO FILES***
     Uncompress and extract SeaDAS demo tar files if you have them:

         > gunzip -c seadas_demo.tar.gz | tar xvpf -
         > gunzip -c seadas_demo_modis.tar.gz | tar xvpf -
         > gunzip -c seadas_demo_modis_db.tar.gz | tar xvpf -
         > gunzip -c seadas_demo_osmi.tar.gz | tar xvpf -

  7. Depending on how much disk space you have available, you may
     want to either move or delete the compressed tar files (*.gz).

  8. Set the SEADAS environment variable, where "PATH_TO_SEADAS" is
     the full directory path to seadas (e.g. /home/arthur/seadas5.0):

     -If you are running under csh or tcsh:
         > setenv SEADAS PATH_TO_SEADAS
     -If you are running under bash:
         > export SEADAS=PATH_TO_SEADAS

  9. Run the SeaDAS setup program and press the Okay button:

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

     -OR, if you have IDL installed with a full license:
         > ./seadas_setup

10. Activate the Seadas setup just created.

     > source config/seadas.env

     -If you are running under csh or tcsh, update the hash search tables.
         > rehash

     -If you are a Mac OS X user running under csh or tcsh:
         > limit stacksize unlimited
     -If you are a Mac OS X user running under bash:
         > ulimit -Ss unlimited

11. 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/seadas5.0):

         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 shells)
         ulimit -Ss unlimited      (for bash shells)

12. 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

13. 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/.

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

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

LINUX NOTES: See the README.rhlinux file in this directory.

---

MACINTOSH NOTES: See the README.macintosh file in this directory.

---

SUN NOTES:

  1. For SUN users compiling from scratch you will need to make sure that
     cpp is being picked up from /usr/ccs/lib.  Also, you will need to
     make sure that the C compiler (cc) is being picked up from
     /opt/sunwspro/bin, instead of /usr/ucb.

  2. For SUN/Solaris 2.7 compiling from scratch, in order to pick up the
     X11 include files and the shareable Motif library (libXm.so.x) for
     the l1abrsgen and spreadsheet programs, you will need to set up the
     OPENWINHOME and LD_LIBRARY_PATH environment variables. Sample lines
     in your .cshrc file:

         setenv OPENWINHOME /usr/openwin
         setenv LD_LIBRARY_PATH $OPENWINHOME/lib:/usr/dt/lib/

---

SGI NOTES:

   1. If running IRIX 6.5, you may receive the error:
      "rld: Fatal Error:Cannot Successfully map soname 'libblas.so'". This
      means IRIX 6.5 did not install the libblas libraries by default. You
      will need to install these libraries from your IRIX installation CD.

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

REBUILDING SEADAS:

* 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 delete all the distributed *
* libraries and binaries before regenerating them.                      *

To build SeaDAS on Linux systems, the Intel Fortran compiler is required:

   http://www.intel.com/software/products/compilers/flin/noncom.htm

To build SeaDAS on Macintosh, the IBM XL Fortran v8.1 compiler is required:

   http://www.absoft.com/Products/Compilers/Fortran/Macintosh/XLF/xlf.html

A free 60-day full-functioning version of IBM XL Fortran 8.1 is available:

   http://www-306.ibm.com/software/awdtools/fortran/xlfortran/features/macosx/xlf-mac.html

STEPS TO BUILD SEADAS:

  1. Install SeaDAS, setting up the SeaDAS environment, and "cd" into the
     $SEADAS root directory.

  2. Prepare for the installation. The following command will generate all
     the Makefiles for your specific platform. (WARNING: This command also
     deletes all SeaDAS distributed binaries and libraries.)

        > make pre_install

  3. Build and install all binaries and libraries.

        > make install >&log.txt

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

MODIS High-Resolution Processing Instructions

Interactive instructions:

    * Start SeaDAS.

    * Click on Process->MODIS->msl12,4.

    * Select a Level-1B MODIS input file which contains high-resolution data. (Note: this      must originate from a Direct Broadcast Level 0 file.)

    * Select a GEO file.

    * Select one or more output filenames.

    * Click on the Processing Options tab.

    * Select one of the following Resolutions:
          o 1km (1km ocean + averaged 500m/250m)
          o 500m (interpolated 1km + 500m + averaged 250m)
          o 250m (interpolated 1km/500m + 250m)

    * Select one or more of the following for Gaseous transmittance bitmap selector:
          o Ozone (Default)
          o CO2
          o NO2
          o H2O

    * Select a value for shortest wavelength for aerosol model selection.

    * Select a value for longest wavelength for aerosol model selection.

    * If you select aerosol mode option "Multi-scattering with 2-band model selection, SWIR     corr":
          o Select a value for shortest wavelength for SWIR-based NIR Lw correction.
          o Select a value for longest wavelength for SWIR-based NIR Lw correction.

    * Click on the File Selection tab.

    * Click on Select L2 Products.

    * You will see that extra high-resolution band wavelengths are available now in the     lower section of the Product Selection Widget. Select your desired products and     click Okay.

    * Continue on as you normally would, modifying whatever other parameters you wish.

Command-mode instructions:

# Make sure to include the following parameters:

resolution: Resolution of the output file.

  250   250-meter resolution.
  500   500-meter resolution.
  1000   1000-meter resolution.

gas_opt: Gaseous transmittance bitmap value. Sum of values selected.

  None (0)
  Ozone (1)
  CO2 (2)
  NO2 (4)
  H2O (8)

aer_wave_short: Shortest wavelength for aerosol model selection.

  645
  667
  678
  748 (default)
  859
  869
  1240
  1640
  2130

aer_wave_long: Longest wavelength for aerosol model selection.

  645
  667
  678
  748
  859
  869 (default)
  1240
  1640
  2130

aer_swir_short: Shortest wavelength for SWIR-based NIR Lw correction. (Note: Only valid if       aer_opt=-9)

  645
  667
  678
  748
  859
  869
  1240 (default)
  1640
  2130

aer_swir_long: Longest wavelength for SWIR-based NIR Lw correction. (Note: Only valid if       aer_opt=-9)

  645
  667
  678
  748
  859
  869
  1240
  1640
  2130 (default)

Example:
msl12,ifile='/home/yourname/seadas5.0/A2004356175510.L1B_LAC_sub',geofile='/home/yourname/seadas5.0/A2004356175510.GEO_sub', ofile1='/home/yourname/seadas5.0/A2004356175510.L2_LAC_sub',resolution=250,gas_opt=15,aer_wave_short=748,aer_wave_long=869, aer_swir_short=1240,aer_swir_long=2130, .......

      (in this example gas_opt=15=1+2+4+8 meaning Ozone, CO2, NO2, and H20 are selected)