User's Guide

FILLTOVS

Fill the holes in a TOVs water vapor image.

Function:

Fill the holes in a TOVs water vapor image from two fill images and create a QC image. Holes in the images are indicated by negative values.

Parameters:

IN
Input image. The water vapor image to be filled.

OUT
Output image. The filled water vapor image.

QC
Quality control image. Contains one of the following values:

    0 - pixel value from input image
    1 - pixel value from fill image 1
    2 - pixel value from fill image 2
    3 - pixel value was interpolated in fill image 2

FILL
The images to be used for filling IN. Priority is given to the first fill image. (See User Note 1)

Examples:

  1. LAS> filltovs in=wv14060196pm fill=(df0601 mf0601) out=wv14060196 qc=wv14060196qc

    Holes in the image wv14060196pm will be filled with data from images df0601 and mf0601. The output image created will be wv14060196 and its associated image wv14060196qc.

Description/Algorithm:

Invalid data or "holes", negative values, are filled with valid, nonnegative, values from the images specified in the FILL parameter. The input image is searched for holes. When a hole is found, it is filled with a value from the fill image. The first fill image listed in the parmameter FILL has priority. The QC image is marked indicating the origin of the data as follows:

    0 - pixel value from input image
    1 - pixel value from fill image 1
    2 - pixel value from fill image 2
    3 - pixel value was interpolated in fill image 2

Nonfatal Error Messages:

  1. [filltovs-clos] Error closing file XXXXX

    An error occurred closing the file XXXXX. The data may still be valid. Processing continues.

Fatal Error Messages:

  1. [filltovs-fatal] Fatal error occurred

    A fatal error occurred. The message immediately preceding this is the specific error encountered. Processing stops.

  2. [filltovs-getbdr] Error retrieving XXXXX band ddr

    An error occurred while trying to read the band ddr for image XXXXX. Insure the band ddr exists for the image and the user has read privileges. Contact system administrator if problem persists.

  3. [filltovs-getddr] Error retrieving XXXXX image ddr

    An error occurred while trying to read the ddr for image XXXXX. Insure the ddr exists for the image and the user has read privileges. Contact system administrator if problem persists.

  4. [filltovs-gtbuf] Error reading from image XXXXX

    An error occurred reading image XXXXX. Insure the image exists and the user has read privileges. Contact system administrator if problem persists.

  5. [filltovs-ptbuf] Error writing to file XXXXX

    An error occurred writing to file XXXXX. Insure there is enough disk space and the user has write privileges. Contact system administrator if problem persists.

  6. [filltovs-putbdr] Error writing XXXXX band ddr

    An error occurred writing the band ddr for image XXXXX. Insure there is enough disk space and the user has write privileges. Contact system administrator if problem persists.

  7. [filltovs-putddr] Error writing the XXXXX image ddr

    An error occurred writing the ddr for image XXXXX. Insure there is enough disk space and the user has write privileges. Contact system administrator if problem persists.

User Notes:

  1. The output image is filled using the two fill images. The first image listed has priority in the fill algorithm and is to typically an image of daily climatological data. The second image is assumed to be completely filled prior to use. and is typically an image of monthly climatological data. The function CREATMF creates a complete monthly climatology image for this purpose.