User's Guide

GETKEY

Retrieve the key, acquisition year, and CEOS ID from a specified file name.

Function:

Retrieve the key, acquistion year, and CEOS ID from a specified file name.

Parameters:

INFILE
Input file. The LAS file name to be parsed.

KEY
Output key. The first 16 characters of the root file name will be returned in this TAE string variable. In most cases this is the ADAPS scene ID.

YEAR
Acquire year. The last two digits of the year that the data was acquired will be returned in this TAE string variable.

CEOSID
CEOS ID. An alphanumeric code that identifies the station that acquired the AVHRR data will be returned in this TAE string variable.

Example:

  1. LAS> getkey infile=[images]ah11042293124523;sfl key=keyname year=acqyear ceosid=ceosname

    The key "AH11042293124523" will be returned in the TAE variable KEYNAME. The value "93" will be returned in the TAE variable YEAR. The value "SFL" will be returned in the TAE variable CEOSNAME.

Description/Algorithm:

The input file name INFILE is split into a directory name, a root file name, and a file extension. The first 16 characters of the root file name are returned in the TAE variable specified by KEY. Characters 9 and 10 of the root file name are returned in the TAE variable specified by YEAR. The first 3 characters of the file name extension are returned in the TAE variable specified by CEOSID.

Nonfatal Error messages:

    None.

Fatal Error messages:

  1. [getkey-fatal] Fatal error encountered

    A fatal error was encountered. The message displayed preceding this message is the error that was encountered. Processing terminates.

User Notes:

  1. Since GETKEY returns values in TAE variables, it is usually called from a procedure PDF.