User's Guide

DBSETUP

Data base setup procedure

Function:

The data base setup procedure retrieves information related to the specified AVHRR archive image. This information includes the band to process, the solar zenith angle, a processing time stamp, output archive location, receiving station ID, unique scene ID, and the area to process within the World Data Bank II (WDBII). This information is used by the REFAID procedure to process an archive image to create browse and data base files.

Parameters:

IN
Input image. The AVHRR archive image the information is to be retrieved for. The image must have an associated ahdr file.

INHDR
Archive header. The LAS name of the associated AVHRR archive header file is returned in this parameter.

SCENEID
Scene ID. A unique scene ID generated from the type of data (GAC, HRPT, or LAC), satellite number, and the date and start time of the pass. This scene ID is returned in this parameter.

CEOSID
CEOS ID. A three letter code that identifies the receiving station that acquired the pass. The CEOS ID is returned in this parameter.

BAND
Band number. Band number from the archive image to process. Band two is processed for daytime passes and band four is processed for nighttime passes. The band number is returned in this parameter.

AREA
World Data Bank II area. The area of the WDBII that the pass is over. The following is a list of areas in the WDBII that may be returned in this parameter:


   = NA:  North America
   = EU:  Europe
   = AS:  Asia
   = SA:  South America
   = AF:  Africa

TSTAMP
Time stamp. The current time (HHMMSS) is extracted and returned in this parameter. The time stamp is used to uniquely identify and match the browse and database files.

SUNZEN
Sun Zenith. The solar zenith angle at the center of the pass. This angle determines which lookup table (LUT) is used to enhance the processed image(s).

Examples:

  1. LAS> dbsetup in=al11050192113703 inhdr=inhdr sceneid=sceneid ceosid=ceosid band=band area=area tstamp=tstamp sunzen=sunzen

    The name of the header file associated with the AVHRR archive image "AL11050192113703;arch" is generated and returned in the name parameter INHDR. The scene ID, CEOS ID, band to process, WDBII area, time stamp, and the solar zenith angle are calculated or extracted from the associated header file and returned in the TAE name parameters.

  2. LAS> dbsetup in=ah11021366071530 inhdr=inhdr sceneid=sceneid ceosid=ceosid band=band area=area tstamp=tstamp sunzen=sunzen

    The name of the header file associated with the AVHRR archive image "AH11021366071530;arch" is generated and returned in the name parameter INHDR. The scene ID, CEOS ID, band to process, WDBII area, time stamp, and the solar zenith angle are calculated or extracted from the associated header file and returned in the TAE name parameters.

Description/Algorithm:

DBSETUP creates the name of the AVHRR archive header file; DBSETUP calculates a unique scene ID and time stamp; it determines the appropriate areas within WDBII to process. DBSETUP extracts the CEOS ID, band to process, and the solar zenith angle from the header file for the specified AVHRR archive image.

Nonfatal error messages:

    None.

Fatal Error Messages:

  1. [dbsetup-fatal] Fatal error encountered

    The error message displayed immediately preceding this message is the specific error encountered. Processing is terminated.

  2. [dbsetup-qout] Error sending variable block to TAE

    An error was encountered sending the variable block to TAE. If the error persists, contact the system administrator.

  3. [dbsetup-send] Error sending <xxxxx> to TAE

    An error occurred sending the specified parameter to TAE. If the error persists, contact the system administrator.

User Notes:

  1. The information calculated by DBSETUP is used by the REFAID procedure to create a browse image and database file.

  2. AVHRR Band two is processed for daytime passes and band four is processed for nighttime passes.

  3. The time stamp is used to uniquely identify and match the browse and database files.

  4. A related function is REFAID which calls DBSETUP.