addimcat - add records to a processed image catalog

addimcat - Add records to a processed image catalog

SYNOPSIS

addimcat  [ parameter=value ... ]  [ file ... ]

Parameters are: imagecat_file, project, include_vars, replace_dups.

DESCRIPTION

addimcat catalogs image variables in a processed image catalog. Each selected variable from each input dataset results in a separate catalog record. Only non-string valued variables with exactly two dimensions can be cataloged.

Catalog fields are computed from variable and dataset attributes in the input files. The record format of a processed image catalog is described in imagecat.

PARAMETERS

imagecat_file: This is the name of the processed image catalog file. If the file Imagecat exists in the current directory, it is the default. Otherwise, if $PASSDIR/Imagecat exists, it is the default. Otherwise, there is no default.

project: This is a name to be associated with the cataloged variables. This name can be at most 31 characters long. The default value is blank.

include_vars: This is a list of variables to include in or (exclude from) the catalog. If the list of prefixed with a minus sign, the listed variables are excluded from the cataloging process. Wildcards * and ? are allowed. The default is to include all variables in the catalog.

replace_dups: This parameter indicates whether or not new records should overwrite existing duplicate records (e.g., same project, file, and variable). If replace_dups=n, and a duplicate existing record is found for a new record, the new record is NOT added to the catalog.

EXAMPLES

Add an entry to the catalog for all variables named 'avhrr...' from the dataset /extra/jhf/n11.90277.2123. Note that the entire path name of the dataset is not included in the catalog record.

[1] % addimcat /extra/jhf/n11.90277.2123
imagecat_file  : char(255) ? [Imagecat]
project        : char( 31) ? [] examples
include_vars   : char(255) ? [] avhrr*
replace_dups   : char(  3) ? [yes]

[2] % listimcat
imagecat_file  : char(255) ? [Imagecat]
project        : char( 31) ? [] examples
variable       : char( 31) ? []
percent_good   : real      ? [0]
start_date     : char( 15) ? [70/01/01]
end_date       : char( 15) ? [99/12/31]
satellite      : char( 11) ? []
use_target     : char(  3) ? [no]
full_report    : char(  3) ? [no]
printout       : char(  3) ? [no]

Image Catalog  Tue Mar 16 16:06:07 1993  Page 1

 project:  examples
    file:  n11.90277.2123
variable:  avhrr_ch2
   units:  albedo*100%
    date:  90/10/04 (277)
    time:  21:17:21
datatype:  short
 nl X ns:  668 X 727
 use min:  -0.25
 use max:  36.47
  %
good:  100
map proj:  sensor_scan

 project:  examples
    file:  n11.90277.2123
variable:  avhrr_ch4
   units:  temp_deg_c
    date:  90/10/04 (277)
    time:  21:17:21
datatype:  short
 nl X ns:  668 X 727
 use min:  -21.94
 use max:  50.3
  %
good:  100
map proj:  sensor_scan

FILES

Imagecat