image_catalog - processed image catalog functions

image_catalog - Processed image catalog functions

DESCRIPTION

Users can maintain one or more processed image catalogs. A processed image catalog consists of a catalog file (Imagecat), and a corresponding snapshot directory (Imcatdir) filled with reduced images.

      anydirectory/Imagecat
      anydirectory/Imcatdir/snapshot1
      ...
      anydirectory/Imcatdir/snapshotN

Processed image catalogs can be located in any directory. Users can have separate catalogs for different projects, or use the project field for discriminating between unrelated images in the same catalog.

Each catalog record contains key fields project, file, and variable. No two catalog records can have the same (project, file, variable) tuple. The file field contains no directory information, only the file name. The remaining contents of the Imagecat files fully are described in imagecat.

The following functions are currently available for accessing processed image catalogs:

initimcat: Creates a new Imagecat file and corresponding Imcatdir in a user specified directory.

addimcat: Adds images to a processed image catalog. Several variables from one or more datasets can be cataloged at once.

listimcat: Lists entries in a processed image catalog. Search criteria can include project, variable and satellite wildcard expressions, date range, target coverage and sun elevation, and percentage of non-missing values.

delimcat: Deletes (actually marks for deletion) entries from a processed image catalog. Reduced images in the corresponding snapshot directory are physically removed.

packimcat: Physically removes entries in processed image catalog previously marked for deletion.

No function currently exists for browsing the reduced images in the Imcatdir directories.

FILES

Imagecat, Imcatdir