==========================================================================
                   Help notes for modis_L1A_to_L1B.csh
==========================================================================

Usage: modis_L1A_to_L1B.csh L1A_file GEO_file [OPTIONS]

Options:

  -b                        Use base of input filename for output filenames
                            (without -b, output filenames are automatic)
  -o L1B_1KM_filename       Output MODIS L1B 1KM HDF filename
  -h L1B_HKM_filename       Output MODIS L1B HKM HDF filename
  -q L1B_QKM_filename       Output MODIS L1B QKM HDF filename
  -rlut REFL_LUT_filepath   Full path and filename of Reflective LUT file
  -elut EMIS_LUT_filepath   Full path and filename of Emissive LUT file
  -qlut QA_LUT_filepath     Full path and filename of QA LUT file
  -delete-1km               Delete 1km resolution L1B file
  -delete-hkm               Delete 500m resolution L1B file
  -delete-qkm               Delete 250m resolution L1B file
  -save-log                 Save the Level 1B processing log file

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

The modis_L1A_to_L1B.csh wrapper script creates 3 MODIS formatted Aqua or
Terra Level 1B files of 1km, 500m, and 250m resolution. It requires a
MODIS formatted Level 1A file and its corresponding Geolocation file as
input. If no output L1B filename is specified, the filename will be
constructed using the AYYYYDDDHHMMSS or TYYYYDDDHHMMSS prefix format
where YYYYDDDHHMMSS is the calculated pass start time. The Level 1B
filenames will be given ".L1B_LAC", ".L1B_HKM", and ".L1B_QKM" suffixes
for the 1km, 500m, and 250m resolutions respectively. A default Level 1B
file output directory can be defined by setting the MODIS_L1B environment
variable.

If the calibration LUTs are not specified on the command line, the LUTs
defined by the following environment variables will be used during L1B
processing:

AQUA_REFL_LUT
AQUA_EMIS_LUT
AQUA_QA_LUT
TERRA_REFL_LUT
TERRA_EMIS_LUT
TERRA_QA_LUT

The default location of the calibration LUTs is in $SDSDATA/modisa/cal/
and $SDSDATA/modist/cal/. It is MANDATORY that all three LUTS (reflective,
emissive, and qa) reside in the same directory.

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

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

L1A_file (required)
Input MODIS Aqua or Terra L1A file for generating the L1B files.

GEO_file (required)
Input MODIS Aqua or Terra Geolocation file for generating the L1B files.

-b (optional)
Use the base of the input L1A filename (up to first ".") for naming the
output filenames. This allows for filename bases to now be kept identical
through the processing chain instead of the seconds potentially changing.

-o L1B_1KM_filename (optional)
Output filename for the 1km resolution L1B file.

-h L1B_HKM_filename (optional)
Output filename for the 500m resolution L1B file.

-q L1B_QKM_filename (optional)
Output filename for the 250m resolution L1B file.

-rlut REFL_LUT_filepath (optional)
User-specified Reflective LUT file to be used in L1B processing. All three
LUTS (reflective, emissive, and qa) MUST reside in the same directory.

-elut EMIS_LUT_filepath (optional)
User-specified Emissive LUT file to be used in L1B processing. All three
LUTS (reflective, emissive, and qa) MUST reside in the same directory.

-qlut QA_LUT_filepath (optional)
User-specified QA LUT file to be used in L1B processing. All three LUTS
(reflective, emissive, and qa) MUST reside in the same directory.

-delete-1km (optional)
Delete the 1km resolution L1B file.

-delete-hkm (optional)
Delete the 500m resolution L1B file.

-delete-qkm (optional)
Delete the 250m resolution L1B file.

-save-log (optional)
Save the Level 1B processing LogStatus file. (All logs are deleted by
default if processing completes without a fatal error.)

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