listimcat - display selected contents of a processed image catalog

listimcat - Display selected contents of a processed image catalog

SYNOPSIS

listimcat  [ parameter=value ... ]

Parameters are: imagecat_file, project, variable, percent_good, start_date, end_date, satellite, use_target, target_lat, target_lon, min_sun_zen, max_sun_zen, names_only, printout.

DESCRIPTION

listimcat selectively reports the contents of a processed image catalog. Search criteria can include project wildcard expression, variable wildcard expression, minimum percent non-missing values, start and end date, satellite name wildcard expression, a target location, and minimum and maximum sun zenith angles at the target. Mulitple search criteria are and'd together.

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 wildcard expression for project name. If no expression is given, project is not used as search criteria.

variable: This is a wildcard expression for variable name. For example, one can look for all raw and calibrated AVHRR channel images using the wildcard expression avhrr_ch*. If no expression is given, variable is not used as search criteria.

percent_good: This is the minimum percentage of non-missing values. The valid range is [0, 100]. If percent_good is zero, it is not used as search criteria.

start_date, end_date: These are the start and end dates. See formats for acceptable date formats. The default start date is 70/01/01. The default end date is 99/12/31. If both the default start and end date are used, then date range is not part of the search criteria.

satellite: This is a wildcard expression for satellite name. For example, one can look for images from NOAA satellites using the wildcard expression "noaa*". If no expression is given, satellite is not used as search criteria.

use_target: This parameter indicates whether or not target visibility location is used as search criteria. Choices are yes or no. The default is no.

target_lat, target_lon: These parameters defines the target's latitude and longitude. See formats for acceptable latitude and longitude formats. There are no defaults.

min_sun_elev, max_sun_elev: These parameters define the minimum and maximum sun elevation angle at the target. The valid range is [-90, 90]. The default minimum angle is -90 degrees. The default maximum angle is 90 degrees. If both the default minimum and maximum angles are used, the sun elevation is not part of the search criteria.

names_only: This parameter determines the output report format. If yes, then for each catalog entry meeting the search criteria, there is a single report line containing the corresponding project, file, and variable name, separated by commas e.g., project, file, variable. These strings point to reduced image files in subdirectory associated with the image catalog.; If no, the report takes on a more verboses format. See Examples below.

printout: This parameter controls the location of the output report, either to the screen (no) or to the line printer (yes). The default is no.

EXAMPLES

List images corresponding to project 'examples' from NOAA satellites.

[1] % 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) ? [] noaa*
use_target     : char(  3) ? [no]
names_only     : char(  3) ? [no] yes
printout       : char(  3) ? [no]
examples,new7,avhrr_ch2
examples,new7,avhrr_ch5

[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) ? [] noaa*
use_target     : char(  3) ? [no]
names_only     : char(  3) ? [no]
printout       : char(  3) ? [no]

Image Catalog  Sun Mar 21 10:56:54 1993  Page 1

 project:  examples
    file:  new7
variable:  avhrr_ch2
   units:  albedo*100%
    date:  84/07/09 (191)
    time:  23:11:30
datatype:  short
 nl X ns:  377 X 628
 use min:  1.22
 use max:  27.73
  %
good:  100
map proj:  sensor_scan

 project:  examples
    file:  new7
variable:  avhrr_ch4
   units:  temp_deg_c
    date:  84/07/09 (191)
    time:  23:11:30
datatype:  short
 nl X ns:  377 X 628
 use min:  10.39
 use max:  49.17
  %
good:  100
map proj:  sensor_scan

FILES