The decoder GET_DHR_DATA returns information on the radar site, volume scan time, radar operating mode, and on the radar data itself. The array IFIELD() contains values 0-255, which can be converted to physical units (dBZ) by using the relationship:
dBZ = ((IFIELD-2)/2) - 32
An IFIELD value of 255 indicates 'missing' data beyond 120 nautical miles from the radar site.
Note that all input and output variables are INTEGER*4 except:
IVAL() : BYTE or CHARACTER*1;
IFIELD(,) : INTEGER*2
EXPLANATION OF CALLING SEQUENCE:
CALL GET_DHR_DATA(IVAL,MSGLEN,ISITE,
1 ISITE_LAT,ISITE_LON,ISITE_ELEV,
2 IYR,IMONTH,IDAY,
3 IHR,IMINIT,IPROD,MAXVAL,IVCP,IFIELD,MAXRADIALS,MAXBINS,
4 IAZMUTH,NBINS,NRADIALS,ICODE)
IVAL( ) = BYTE OR CHARACTER*1 VECTOR OF LENGTH MSGLEN,
HOLDING THE DIGITAL HYBRID SCAN MESSAGE (INPUT)
MSGLEN = LENGTH OF THE MESSAGE (SHOULD BE 85100) (INPUT)
ISITE = WSR-88D SITE ID (OUTPUT)
ISITE_LAT = SITE LATITUDE (DEG E), DEG X 1000 (OUTPUT)
ISITE_LAT = SITE LONGITUDE (DEG N), DEG X 1000 (OUTPUT)
ISITE_ELEV = SITE ELEVATION, M MSL (OUTPUT)
IYR,IMONTH,IDAY= PRODUCT DATE (OUTPUT)
IHR,IMINIT = PRODUCT TIME, UTC (OUTPUT)
IPROD = PRODUCT CODE NUMBER (OUTPUT)
MAXVAL = MAXIMUM DIGITAL VALUE IN PRODUCT (OUTPUT)
IVCP = OPERATING VOLUME COVERAGE PATTERN (OUTPUT)
IFIELD(,) = RETURNED VALUES (DATA LEVELS) FOR THE FIELD
(OUTPUT); AN INTEGER*2 ARRAY DIMENSIONED
MAXBINS,MAXRADIALS IN CALLING ROUTINE
RAW DIGITAL VALUES OF IFIELD 0-255,ARE CONVERTED
TO DBZ BY THE RELATIONSHIP:
DBZ = ((IFIELD-2)/2) - 32
MAXRADIALS = DIMENSION FOR IFIELD(), IAZMUTH(), INDICATING
MAXIMUM NUMBER OF RADIALS SHOULD BE SET .GE.
370 (INPUT)
MAXBINS = DIMENSION FOR IFIELD(), INDICATING MAXIMUM
NUMBER OF RANGE BINS. SHOULD BE SET .GE. 230 (INPUT)
IAZMUTH() = ANTENNA AZIMUTH DIRECTIONS (DEG X 10) FOR EACH
RADIAL (OUTPUT, INTEGER*2). DIMENSIONED BY
MAXRADIALS IN CALLING ROUTINE.
NBINS,NRADIALS = NUMBER OF RANGE BINS AND RADIALS IN THE PRODUCT(OUTPUT)
ICODE = OUTPUT RETURN CODE, CONDITIONS AS FOLLOWS:
0 : MESSAGE DECODED OK
2 : NOT A DHR (ID CODE 32) PRODUCT
3 : MAXRADIALS OR MAXBINS IS TOO SMALL
4 : PRODUCT LENGTH IS GREATER THAN MSGLEN
Interface Control Document for Product Specification (Document Number 2620003A, WSR-88D OSF, June 26, 1998)
Interface Control Document for the RPG Associated PUP ( Document Number 2620001A, WSR-88D OSF, June 26, 1998)
WSR-88D Raster Product Decoder
| Version | Date | Summary of Changes |
|---|---|---|
| 1.0 | 03/01/2000 | Initial Version |
The latest version of the WSR-88D Digital Hybrid Scan Radial product decoder can be downloaded and utilized free of charge, subject to the usual NWS disclaimer, click here to download a copy.