gvslist - Displays information about passes for GOES-NEXT sounder data.

SYNOPSIS

gvslist  [ parameter=value ... ] [ inputfile ]

Parameters is: list_all

DESCRIPTION

gvslist displays information about passes for GOES-NEXT sounder data stored in the inputfile. This file is organized as a ring buffer with the new passes overwriting the old ones. Normally, this file is written by wrframe process. The data from this file can be ingested with the gvarin function. The SOUNDER_FILE environment variable is used in standard configuration for sounder data output, and, therefore, can be used to find the inputfile path. The frame number, its first block number in the inputfile, and the total number of blocks, will be reported by gvslist. The frame number is an integer ranging from 0 to 255 and rolling over to 0 following 255.

PARAMETERS

list_all
OPTIONAL. Whether to report all 256 frames, even those that had already been overwritten.
Valid answers are [yes no]. The default answer is yes.

EXAMPLES

% echo $SOUNDER_FILE
/data/sound_data/SOUNDER_DATA
%
% gvslist $SOUNDER_FILE
/data/sound_data/SOUNDER_DATA:
block size: 8192 bytes
num blocks: 16384
complete frame: 167
current frame: 168
last block: 11294
6 active passes
frame 168, block 10438, num_blocks 0856, time 95/05/09 22:29:54
frame 167, block 7045, num_blocks 3393, time 95/05/09 21:50:38
frame 166, block 5523, num_blocks 1522, time 95/05/09 21:29:50
frame 165, block 2166, num_blocks 3357, time 95/05/09 20:50:33
frame 164, block 0653, num_blocks 1513, time 95/05/09 20:29:52
frame 163, block 13658, num_blocks 3379, time 95/05/09 19:50:40
%
% gvslist list_all=yes $SOUNDER_FILE
/data/sound_data/SOUNDER_DATA:
block size: 8192 bytes
num blocks: 16384 bytes
complete frame: 167
current frame: 168
last block: 11294
6 active passes
frame 168, block 10438, num_blocks 0856, time 95/05/09 22:29:54
frame 167, block 7045, num_blocks 3393, time 95/05/09 21:50:38
frame 166, block 5523, num_blocks 1522, time 95/05/09 21:29:50
frame 165, block 2166, num_blocks 3357, time 95/05/09 20:50:33
frame 164, block 0653, num_blocks 1513, time 95/05/09 20:29:52
frame 163, block 13658, num_blocks 3379, time 95/05/09 19:50:40
-----------overwritten--------------
frame 162, block 12103, num_blocks 1555, time 95/05/09 19:29:51
frame 161, block 8748, num_blocks 3355, time 95/05/09 18:50:39
frame 160, block 4640, num_blocks 4108, time 95/05/09 17:50:39
 ..............................................................
frame 001, ....................................................
frame 000, ....................................................
frame 255, ....................................................
 ..............................................................
frame 169, ....................................................
%

FILES

SEE ALSO

gvarin, wrframe

NOTES

Last Update: $Date: 1999/05/10 20:14:13 $