GEMPAK Manual |
Programs
DCWCN
DCWCN decodes watch county notification reports from a real-time data
feed, or from a file fed to the program through standard input,
and writes the data to an ASCII file. The program is controlled
by inputs to the command line.
The inputs are program options and the output file name or template.
For example, for real-time data feeds:
DCWCN [options] output_file
If running the program interactively with standard input, the -c
option must be used. The input file must also be specified.
For example:
DCWCN -c YYMMDD/HHNN [other_options] output_file < input_file
A template may be used to specify the output file name. The file
name template uses the date and time of the bulletin or report
to replace the following characters.
YYYY or YY Year with or without the century
MM Month number
DD Day
HH Hour
NN Minute
PROGRAM METHODOLOGY FOR TIME STRINGS
When decoding WCNs, assumptions on time varibles are made for those cases
where the watch start time is '000000T0000Z'.
For 'NEW' reports, the watch starting and ending times are decoded
from the VTEC line.
For 'CON' reports, where the watch starting time is '000000T0000Z'
in the VTEC line, the start time is set equal to the bulletin issue time
and the ending time is decoded from the VTEC line.
For 'CAN' reports, where the watch starting time is '000000T0000Z'
in the VTEC line, the ending time is decoded from the VTEC line and
the starting time is set equal to the ending time.
OUTPUT FORMATING
The format of the output ASCII file is as follows:
|Watch|Issue|Start|Stop|Watch |Bulletin |Action;Significance|Corr|Cancel|Test
|type |time |time |time|number|originator|code code |flag|flag |flag
County/marine zone table entries, one per line, formatted as shown in the
example below (county/marine zone information lines should appear just as they
do in $GEMTBL/stns/mzcntys.tbl)
. . . . . . . . . .
. . . . . . . . . .
. . . . . . . . . .
where:
Watch type is TSM thunderstorm watch
TOR tornado watch
Issue time is YYMMDD/HHMM - GEMPAK date/time format - time of the
of the WCN bulletin
Start time is YYMMDD/HHMM - GEMPAK date/time format - Start time
of the WCN bulletin
Stop time is YYMMDD/HHMM - GEMPAK date/time format - End time of
of the WCN bulletin
Bulletin originator is KALY, KBGM, etc. from 2nd field of 1st line of bulletin
Watch number is the decoded watch number
Action code is the action on the counties listed
NEW - new counties in the watch
CON - continuing counties in the watch
EXT - extending the time of the watch
EXA - extending the area of the watch
EXT - extending the area and time of the watch
EXP - normal expiration of counties
CAN - canceling counties from the watch
Significance code A Watch
Correction flag 0 Not a correction
1 A correction
Cancel flag 0 Not a cancellation or expired report
1 A cancellation or expired report
Test flag 0 Not a test report
1 A test report
Example
-------
|TOR|020807/1701|020807/1716|020807/2100|0002|KLSX|CON;A|0|0|1
ILC121 17121 Marion IL US 38.65 -88.92 0.00 0 LSX
ILC051 17051 Fayette IL US 39.00 -89.03 0.00 0 LSX
ILC189 17189 Washington IL US 38.35 -89.41 0.00 0 LSX
LHZ361 743610 LHZ361 LH US 45.65 -83.88 0.00 0 APX
ANZ335 673350 ANZ335 AN US 41.04 -73.35 0.00 0 OKX
ANZ338 673380 ANZ338 AN US 40.54 -74.08 0.00 0 OKX