User's Guide

Rename AVHRR browse images

Function:

Rename AVHRR browse images to reflect their sceneid.

Parameters:

INFILE
Input file to be renamed. The suffix for this file must be "1KM" (upper-case).

Example:

  1. LAS> brwrenm infile=00140339;1km

    The file "00140339;1KM" will get renamed to "ah14041496153532_120414;brw" assuming the scene id contained in the header record of "00140339;1KM" is "ah14041496153532".

Description/Algorithm:

The header record of the browse image file specified by INFILE is examined to determine the scene id of the image. INFILE must have a suffix of "1KM" (upper-case). The browse image file is renamed to "SCENEID_TSTAMP;brw", where SCENEID is the scene id found in the header record and TSTAMP is the current time stamp (the directory specification remains unchanged).

Nonfatal Error Message:

    None

Fatal Error Messages:

  1. [brwrenm-invl] Invalid browse image name specified

    An invalid browse image name was specified. Verify that the suffix is ";1KM".

  2. [brwrenm-open] Error opening browse image

    An error occurred opening the image specified by INFILE. Verify that the file exists with the proper permissions.

  3. [brwrenm-renm] Error renaming browse image

    An error occurred attempting to rename the browse image. Contact the system administrator.

User Notes:

  1. The suffix of INFILE must be "1KM" (upper-case) due to the LAS support routine's inability to handle upper-case characters. Special provisions are implemented in order for BRWRENM to be able to ingest upper-case suffix names. The AVHRR browse images as archived by GLIS are named "sourcelink;1KM" where sourcelink is the database source link.

  2. The time stamp is added to the scene id to make a unique file name when duplicate scenes exist. The time stamp syntax is HHMMSS where HH = hour, MM = minute, and SS = second.