catcover - Search pass catalog for passes that match given parameters, including master dataset coverage.

SYNOPSIS

catcover  [ parameter=value ... ]

Parameters are:  master_filetelemetrystart_dateend_datesort_by_dateprintout.

DESCRIPTION

catcover selectively reports the contents of the archive pass catalog. Selection criteria includes master coverage, a date range, and the telemetry type.

PARAMETERS

master_file

This is the name of the master dataset used to specify the region of interest.

Valid responses are any TeraScan dataset that contains an earth transform.

The default is [ Master ].

telemetry

This is the telemetry type entered in lower case. Only passes with the specified telemetry type are listed. If a telemetry is not specified, all telemetry types will be listed.

The default is [ all telemetry types ].

start_date

This is the start search date. Telemetry data starting after this date will be listed.

Any valid date is allowed.

The default is [ 70/01/01 ].

end_date

This is the last search date. Only telemetry data before this date will be listed.

Any valid date is allowed.

The default is [ 99/12/31 ].

sort_by_date

Should the output report be sorted by date or should it be sorted by tape label and the data frame number? Answer yes to sort the listing by date and enter no to sort by tape label/frame number.

Valid responses are [ yes or no ].

The default is [ yes ].

printout

This parameter controls the location of the output report. Answer yes to direct listing to line printer. Answer no to view listing on terminal.

Valid responses are [ yes or no ].

The default is [ no ].

EXAMPLES

List all passes along with their start line, start sample, number of lines and number of samples that intersect a master dataset centered over the Hawaiian Islands.

[1] % catcover
master_file    : char(75) ? [Master] Hawaii
telemetry      : char(75) ? []
start_date     : char(15) ? [70/01/01]
end_date       : char(15) ? [99/12/31]
sort_by_date   : char( 3) ? [yes]
printout       : char( 3) ? [no]

Pass Catalog Fri Aug  4 20:58:35 1989  Page 1

Label     #  satel   telem    date    day    time     sl   nl    ss   ns
argos001  2  noaa-11 hrpt   89/05/15  135  22:35:00  1218  493  2003   46
hawaii.1  1  noaa-10 hrpt   89/08/10  222  17:45:30  2029 1164    61 1175

Run again ? [no]

FILES

passcat

SEE ALSO

listcat

NOTES

Is very resource and time intensive if many records must be processed.


Last Update: $Date: 1998/05/28 19:43:34 $