==========================================================================
        Help notes for ms_met.csh, ms_ozone.csh, and ms_oisst.csh
==========================================================================

Usage: ms_met.csh   L1A_or_L1B_file [OPTIONS]
       ms_ozone.csh L1A_or_L1B_file [OPTIONS]
       ms_oisst.csh L1A_or_L1B_file [OPTIONS]

Options for all three utilities:

  -disable-ftp      Turn off the automatic downloading functionality
  -disable-curl     Don't use curl to retrieve remote directory listings
  -verbose-ftp      Enable verbose auto-download messages

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

For a given input L1A or L1B file, each of these three auto-ancillary
scripts searches for the optimal corresponding ancillary data file(s) for
eventual input to l2gen Level-1 to Level-2 processing. If the optimal
ancillary files don't exist on the local hard disk, each script optionally
attempts to find and retrieve them via ftp.

The file search results for ms_met.csh, ms_ozone.csh, and ms_oisst.csh are
written to the respective text files:

 filename.met_list
 filename.ozone_list
 filename.sst_list

where "filename" is the name of the input L1A_or_L1B_file. These text
files contain either the names of the files found in the search, one per
line, or else one line specifying the climatology if no files were found.

See http://oceancolor.gsfc.nasa.gov/seadas/doc/toplevel/anc_info.html for
more information on the MET, OZONE, and OISST data.

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

======================================
Explanation of command line arguments:
======================================

L1A_or_L1B_file (required)
Input L1A or L1B file fo which ancillary data file detection is desired.

-disable-ftp (optional)
Turn off the automatic downloading functionality. The hard disk will
still be searched.

-disable-curl (optional)
This option disables the use of curl to retrieve remote directory
listings. Unless the option is specified, if curl is in the command path
it will be used to retrieve remote directory listings since curl is
capable of grabbing multiple directory listings with one connection as
opposed to wget. Limiting the number of connections is important due to
the limitations imposed by the OBPG firewall.

-verbose-ftp (optional)
Enable verbose wget output messages for all downloads.

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

================================================
Examples of the contents of the list text files:
================================================

-"filename.met_list" when one or more MET files were found:
met1=/Users/seadas/var/metoz/2005/205/S200520518_NCEP.MET
met2=/Users/seadas/var/metoz/2005/206/S200520600_NCEP.MET
met3=/Users/seadas/var/metoz/2005/206/S200520600_NCEP.MET

-"filename.met_list" when no MET files were found:
met1=/Users/seadas/data/common/S19461993_COADS_GEOS1.MET_noon

-"filename.ozone_list" when one or more OZONE files were found:
ozone1=/Users/seadas/var/metoz/2005/205/S200520512_EPTOMS.OZONE
ozone2=/Users/seadas/var/metoz/2005/206/S200520612_EPTOMS.OZONE
ozone3=/Users/seadas/var/metoz/2005/206/S200520612_EPTOMS.OZONE

-"filename.ozone_list" when no OZONE files were found:
ozone1=/Users/seadas/data/common/S19891991_TOMS.OZONE
 
-"filename.sst_list" when an OISST file was found:
sstfile=/Users/seadas/var/oisst/2005/oisst.20050727

-"filename.sst_list" when no OISST file was found:
sstfile=/Users/seadas/data/common/sst_climatology.hdf

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

======
LOGIC:
======

The ms_met.csh script first searches for corresponding NCEP Meteorological
(MET) ancillary data file references within a local MET look-up-table
file. If not found here, the local hard disk and then optionally an ftp
server is searched for files first within +-6 hours of the pass start/stop
times, and then +-12 hours of the pass start/stop times. If no files are
found within +-12 hours, the climatology is set.

======

The ms_ozone.csh script searches for four different types of OZONE data in
the following order of preference:

1) EPTOMS
2) TOAST
3) TOVS
4) N7TOMS

(When OMI data becomes available this data-type will also be added.)

The ms_ozone.csh script first searches for corresponding OZONE ancillary
data file references within four local OZONE look-up-table files. If not
found here, the local hard disk and then optionally an ftp server is
searched for files first within +-36 hours of the pass start/stop times,
and then +-72 hours of the pass start/stop times. If no files are found
within 72 hours, the climatology is set.

======

The ms_oisst.csh script first searches for a corresponding NOAA Optimum
Interpolation Sea Surface Temperature (OISST) ancillary data file
reference within a local OISST look-up-table file. If not found here, the
local hard disk and then optionally an ftp server is searched for a file
within 7 days, and then 70 days of the pass start time. If no file is
found within 70 days, the climatology is set.

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