dcslist - Produces a printed report of a DCS dataset.

SYNOPSIS

dcslist  [ parameter=value ... ]  [ inputfile ... ]

Parameters are: hard_copy, tip_format.

DESCRIPTION

dcslist produces a report of the contents of a DCS dataset. The report includes the platform identification, date, time, location (if known), quality indicator, sensor data counter, and raw DCS sensor data. If the quality indicator is non zero, a parity error was detected and the data should not be used. The report is sorted, first by platform ID, and then by date.

The output report is produced in two hexadecimal formats called TIP format and SENSOR format. In the TIP format, the SENSOR data counter represents the number of 4 byte quantities in the message. This number ranges between 0 and 7 and represents the values 1 to 8. Thus, the number of bytes in the message can range between 4 and 32 bytes. Unused portions of the 32 byte records are zero filled. TIP format is listed in 3 byte groups.

The second format is sensor format. In sensor format the range of sensor set is again 0 to 7 representing the values 1 to 8. Again the number of bytes in the data message can range between 4 and 32 bytes. sensor format is listed in 4 bytes groups rather than 3 byte groups.

One or more TeraScan datasets are required as inputs. There are no output TeraScan datasets.

PARAMETERS

hard_copy

Should the output report be printed (yes) or sent to the stdout (no) ?

Valid responses are [yes or no]. The default is [no].

tip_format

Should the output report be printed in tip format or sensor format? Answer yes for tip format and no for sensor format.

Valid responses are [yes or no]. The default is [no].

EXAMPLES

Select platform number 5342 from the dataset named hugo.dcs and list the DCS data in sensor format. First extract the one platform using dcsmix before listing it.

[1] % dcsmix hugo.dcs 5342.dcs
platform_id    : int(50)  ? [0] 5342
start_date     : char(15) ? [70/01/01]
master_file    : char(75) ? [ ]
hugo.dcs:

[2] % dcslist 5342.dcs
tip_format     : char( 3) ? [no]
hard_copy      : char(  3) ? [no] y
5342.dcs:
request id is HC-302 (standard input)
    TeraScan    DCS  PLATFORM  LIST   -  RAW  DATA           File:5342.dcs       Page 1



id     date     time of day qu ct                 data in sensor sets


5342  89/09/21  18:46:02.758  0  6 8969241F 89E8261F 0DEB9600 141C1508 89E92621 8A272721 8969231E

      latitude: 40 45.73 S   longitude: 77 51.51 E    elevation:    0 m

      89/09/21  18:47:40.668  0  6 8969241F 89E8261F 0DEB9600 141C1508 89E92621 8A272721 8969231E

      89/09/21  18:49:18.579  0  6 8969241F 89E8261F 0DEB9600 141C2A08 8E112626 7627261E 4968779F

      89/09/21   18:50:56.49  0  6 8969241F 89E8261F 0DEB9600 141C1508 89E92621 8A272721 8969231E

      89/09/21  18:52:34.401  0  6 8969241F 89E8261F 0DEB9600 141C1508 89E92621 8A272721 8969231E

      89/09/21  18:54:12.312  0  6 8969241F 89E8261F 0DEB9600 141C1508
89E92621 8A272721 8969231E

SEE ALSO

dcsin, dcsloc, dcsmix, tracks, weather, mcmegu, dcs


Last Update: $Date: 1998/05/28 18:15:00 $