User's Guide

REFAID_GET

Retrieve the highest priority AVHRR image for REFAID processing.

Function:

Retrieves the highest priority AVHRR image from the ADAPSING directory for REFAID processing.

Parameters:

PRIORITY
Priority CEOS IDs. List of CEOS IDs that have processing priority. They must be specified from highest priority to lowest. Images acquired by other CEOS IDs will be returned only if none of the images in ADAPSING were acquired by the specified stations. To specify no priority, set PRIORITY to NULL (--).

OUTFILE
Output file. The LAS name of the highest priority image will be returned in the specified TAE variable. This variable should be a string variable with a count of (0:1) since an image may not be found.

Examples:

  1. LAS> refaid_get priority=-- outfile=img

    No receiving stations were specified to have priority, so the first AVHRR archive image found in ADAPSING will be returned in the TAE variable IMG.

  2. LAS> refaid_get priority=(sfl ngc) outfile=img

    All of the AVHRR archive images in ADAPSING will be examined. The first image acquired by SFL will be returned in the TAE variable IMG. If there are no SFL images found, the first image acquired by NGC will be returned. If there are no images acquired by either SFL or NGC, the first image in the directory will be returned.

Description/Algorithm:

REFAID_GET searches the ADAPSING directory for an image to be processed by REFAID. It examines the images in alphabetical order and returns the first one with the highest priority.

Nonfatal Error Messages:

    None.

Fatal Error Messages:

  1. [refaid_get-env] Error retrieving ADAPSING

    An error occurred retrieving the value of the environment variable ADAPSING. Set ADAPSING to the ADAPS ingest directory.

  2. [refaid_get-fatal] Fatal error encountered

    A fatal error was encountered. The message preceding this message is the specific error encountered.

  3. [refaid_get-ids] Station IDs must be 3 characters

    Each priority CEOS ID specified in PRIORITY must be three characters long. Respecify the IDs in PRIORITY.

  4. [refaid_get-hdr] Error reading header for <xxx>

    An error occurred reading the AVHRR archive image's associated AHDR file. This file is required to assign a CEOS ID to the image. Ensure that for the specified archive image, there exists an associated AHDR file.

  5. [refaid_get-parm] Error returning image

    An error occurred returning the image to TAE. Contact the system administrator.

User Notes:

  1. REFAID_GET is used by REFAID_DAEMON to retrieve images for reference aid processing.