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
* 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
* 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:
10. Activate the Seadas setup just created.
> source config/seadas.env
-If you are running under csh or tcsh, update the hash search tables.
-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):
-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:
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
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.
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/
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.
* 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
* 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)
* 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.
# 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.
aer_wave_short: Shortest wavelength for aerosol model selection.
aer_wave_long: Longest wavelength for aerosol model selection.
aer_swir_short: Shortest wavelength for SWIR-based NIR Lw correction. (Note: Only valid if aer_opt=-9)
aer_swir_long: Longest wavelength for SWIR-based NIR Lw correction. (Note: Only valid if aer_opt=-9)
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)