This is the WSR-88D Level 2 Visualization User Guide Toolbar Go to NCDC Home Page Go to Table of Contents (Site Map) Go to Radar Resources Page Go to Radar Products Page Go to Visualization and Analysis Software Go to NCDC Search Page Go to NCDC Help Page

Software

WSR-88D LEVEL II VISUALIZATION USER'S GUIDE

WSR-88D BASE DATA

NCDC | Contents | Radar | Products | Software | Search | Help

Top of Page Table of Contents

INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . .  3

CHAPTER 1. . . . . . . . . . . . . . . . . . . . . . . . . . .  4
     Running WVS . . . . . . . . . . . . . . . . . . . . . . .  4
          1.1  Running the tape reader program . . . . . . . .  4
          1.2  Running the display program . . . . . . . . . .  4
          1.3  Operating the display program . . . . . . . . .  5
          1.4  Support . . . . . . . . . . . . . . . . . . . .  7
          1.5  Data Formats. . . . . . . . . . . . . . . . . .  7

APPENDIX A . . . . . . . . . . . . . . . . . . . . . . . . . .  9
     Installation. . . . . . . . . . . . . . . . . . . . . . .  9
          A.1  Installation Overview . . . . . . . . . . . . .  9
          A.2  Load Software . . . . . . . . . . . . . . . . . 10
               A.2.1  To receive the software from tape. . . . 10
               A.2.2  To receive the software from ftp . . . . 10
          A.3  Customize Makefile. . . . . . . . . . . . . . . 11
          A.4  Customize platform.h. . . . . . . . . . . . . . 12

APPENDIX B . . . . . . . . . . . . . . . . . . . . . . . . . . 16
     Getting Ready to Run. . . . . . . . . . . . . . . . . . . 16
          B.1  Changing wvsreader.sav. . . . . . . . . . . . . 16
          B.2  WVS Display User Preferences and Defaults . . . 17

APPENDIX C . . . . . . . . . . . . . . . . . . . . . . . . . . 20
     City Locations File . . . . . . . . . . . . . . . . . . . 20
          C.1  Creating a Text Overlay File. . . . . . . . . . 20

APPENDIX D . . . . . . . . . . . . . . . . . . . . . . . . . . 22
     Advanced Features . . . . . . . . . . . . . . . . . . . . 22
          D.1  Simplified Start-up . . . . . . . . . . . . . . 22
          D.2  Running on Multiple Workstations. . . . . . . . 22
          D.3  Advanced Compilation. . . . . . . . . . . . . . 23

Top of Page Introduction

    WVS User's Guide

    This is a guide to using the WVS (WSR-88D Visualization System) program. It is assumed the user has experience with UNIX on a specific UNIX workstation. WVS provides the following functionality:

    a. Display Images for reflectivity, velocity, spectrum width, and composite reflectivity

    b. Overlay county lines, city locations, and range rings

    c. Zoom/un-zoom the images

    d. Display azimuth, range, height and data value at mouse click location

    e. Display raw data points of near points around a mouse click location

    f. Automatically update through sweeps of images

    There are two parts to WVS. They are the tape reader and the display. The tape reader program, wvsreader, reads Level II data from a tape and writes it to disk in a format required by the display program. The reader program may be run as a stand-alone program, or may be run while the display program is being executed. As the reader program is writing each sweep on the disk, the display program can be displaying the images.

    The reader program generates "image" files using Level II data as input. The input is from tape only. The output files consist of re-sampled radar data (i.e., original polar format converted to cartesian format) on a 501 x 501 km grid domain with 1 square km grid size. Image files can be generated (user selectable option) for reflectivity, velocity, and spectrum width for each elevation scan (sweep), and composite reflectivity fields for each volume scan. Some sacrifices have been made in data display accuracy in order to maximize program speed. NOTE: Only the last radar sample volume that falls within a grid square is used to define the numerical value of that grid square. Therefore, the output from the program should be used for general perusal of WSR-88D data, or for analysis of phenomena having a scale of at least 10 square km.

Top of Page Chapter 1, Running WVS

    1.1 Running the tape reader program

    For instructions about initial program installation, see appendix A.

    To run the wvsreader:

    1. Mount a tape in a tape drive.

    2. Make sure you're in the directory containing the WVS programs.

    3. Type wvsreader

    4. The program will display parameters to be used. Check these parameters to make sure they are correct. If any are not correct, the program allows you to change them. (seeappendix B).

    5. When prompted to "ENTER BEGINNING DATE AND TIME", enter the beginning date (MMDDYY) and the beginning time (HHMMSS) of the data needed. When prompted to "ENTER ENDING DATE AND TIME", enter the ending date (MMDDYY) and the ending time (HHMMSS) of the data needed. (If the data from the entire tape is needed, "0 0" may be entered for the beginning date and time and "999999 999999" for the ending date and time.) Exact times are not required. The program will select the volume scan that starts on or after the starting time selected and go to the volume scan that ends on or after the ending time selected.

    6. If you wish to end the wvsreader program before the end of the time you specified (i.e. you only want to look at the first couple of volume scans and you entered 999999 999999 for the ending date and time), press ctrl-c.

    1.2 Running the display program

    The display program must be run in an X environment. It was written to run with the Motif window manager on top of X. To start the program from X:

    1. Make sure you're in the appropriate directory.

    2. Type WVSSERVER directory port

    directory
    the directory path where the data files are stored. NOTE: the directory path must have a slash on the end. (e.g., "/scratch/data/")

    port
    some number > 21000 and < 99999. (see appendix D.2)

    3. Type WVSDISPLAY port hostname

    port
    the same number as port in step 1.

    hostname
    the name of the workstation where the program is being run. (If you don't know the hostname, type "hostname" at the Unix prompt to find out.)

    A shell script can be written to make this start-up process a little easier (see appendix D).

    1.3 Operating the display program

    1. The control panel is where the product selection is specified - image products along with associated overlays can be toggled on or off. The buttons will stay on or off until it is clicked again, regardless of whether data is available to be displayed. By leaving an option on when no data is available, once data is available it will be automatically displayed.

    2. Data is retrieved by volume scan and sweep (tilt) numbers. These can be changed by clicking the left mouse button on the respective up or down arrows, or by clicking in the number box and changing the numbers from the keyboard and typing a carriage return.

    When the desired volume scan and sweep numbers are specified, the user should click the left mouse button on the 'Next Request' option at the top of the control panel. This will update the 'Current Volume Scan and Sweep Number' display as well as retrieve and update any products that are enabled (toggled on) in the control panel.

    3. Auto Update will scan the selected directory for the next available volume scan and sweep number starting from the "Current: Volume Scan and Sweep". If WVS display is being run while wvsreader is running, then when the next image is available, it will be displayed. If WVS display is being run after all images have been created with wvsreader, the images will be automatically updated every second. The 'Automatic Update Parameters Display' selection in the control panel is used to change the update parameters. The speed at which the images are updated can be controlled in the 'Time Interval' box.

    The auto update feature defaults to display every sweep in the volume, but may be changed in the 'Auto Update' window. From the 'Auto Update' window, the user may enter the range of sweeps to be displayed (e.g. 1 through 3) or a list of up to 5 desired sweep numbers (e.g. 1, 3, 7, 9). The numbers are entered by clicking the left mouse button in the window, typing the number and pressing the carriage return.

    NOTE: To deselect the 'Auto Update' window, toggle the 'Automatic Update Parameters Display' button to off. The auto update parameters stay active even while the 'Auto Update' window is deselected. NEVER deselect the window any other way (i.e., in Sun's Open Windows environment, deselecting the 'Auto Update' window using the window manager will cause the program to crash).

    4. There is also program interaction in the image displays. All functions are controlled by mouse buttons:

    a. Cursor location and data values:
    Clicking the left mouse button in an image window causes the azimuth, range, height, and data value corresponding to the cursor location to be displayed in the 'Sel az, ran Hgt Val' area at the bottom of the window.

    b. Zooming the image:
    Pressing the 'shift' key while simultaneously clicking the left mouse button in an image window will zoom the image one magnification, centered on the cursor location; the new center azimuth and range will be displayed at the bottom of the window. Each magnification will double the size of the image.

    c. Un-zooming the image:
    Pressing the 'shift' key while simultaneously clicking the middle mouse button in an image window un-zooms the image one magnification, centered on the cursor location. If the image is un-zoomed to the original size, the image is centered on the radar.

    d. Un-zooming the image to original size:
    Pressing the 'control' key while simultaneously clicking the middle mouse button in an image window un-zooms the image to the normal (un-zoomed) magnification level from any level of magnification, centered on the radar.

    e. Inquiring data values near the cursor:
    Pressing the 'control' key while simultaneously clicking the left mouse button in an image window will cause the 'near point display' to pop up based on the cursor location.

    5. To quit the program, click the left mouse button on the 'Quit/Server' button in the control panel.

    1.4 Support

    If there are questions or problems with using WVS that the user's guide does not answer, computer support personnel will be available. When contacting the computer support personnel, give your name, phone number and address (both e-mail and mailing) along with a description of the problem and what you were doing when the problem occurred. Please provide as detailed steps as possible to allow duplication of the error. You can expect a response within 24 hours of when questions are received.

    All suggestions for changes should be e-mailed or mailed to the address listed below. No significant enhancements are expected to be made in FY94.

    TO CONTACT COMPUTER SUPPORT PERSONNEL: 

    Write to: Dept. of Commerce
          WVS Support
          1313 Halley Circle
          Norman, OK.  73069

    
Or e-mail to:
    
INTERNET:     esdim@nsslsun.nssl.uoknor.edu
    

    
Or FAX:   (405) 366-0472
    1.5 Data Formats

    wvsreader reads the Level II data from tape and produces files on disk. These files are used by the display program. The following is a description of the file names.

    The first two letters are always "L2". The next three to four letters are the file type (e.g. dbzi - reflectivity data, veli - velocity data, spwi - spectrum width data, cmpi - composite reflectivity data, imgh - image header, fsi - file set information). The next letter(s) are the volume scan number. Then there is a period. The number after the period is the sweep number.

    When WSR-88D data is collected, there are two operational modes: Precipitation and Clear Air. Each operational mode can have multiple volume coverage patterns (VCPs). During operations, the antenna is controlled by automatic scanning programs. VCPs are matched to an operational mode to optimize product generation for given meteorological situations.

    WSR-88D data is organized by volume scans and sweeps. Within a volume scan, different VCPs have different elevation angles and numbers of elevation angles.

    VCP 11 - contains 16 sweeps, sweeps 1 & 3 have only reflectivity data, sweeps 2 & 4 have only velocity and spectrum width data. All the rest of the sweeps in the volume scan have all three data fields.

    VCP 21 - contains 11 sweeps, sweeps 1 & 3 have only reflectivity data, sweeps 2 & 4 have only velocity and spectrum width data. All the rest of the sweeps in the volume scan have all three data fields.

    VCP 31 - contains 8 sweeps, sweeps 1, 3 & 5 have only reflectivity data, sweeps 2, 4 & 6 have only velocity and spectrum width data. Sweeps 7 & 8 have all three data fields.

    VCP 32 - contains 7 sweeps, sweeps 1 & 3 have only reflectivity data, sweeps 2 & 4 have only velocity and spectrum width data. All the rest of the sweeps in the volume scan have all three data fields.

Top of Page Appendix A: Installation

    A.1 Installation Overview

    The following steps must be performed in the order listed.

    1. If you have not already done so, load the software onto your workstation (see A.2 for details).

    2. Modify Makefile (see A.3 for details).

    3. Modify platform.h (see A.4 for details).

    4. Type make all

    If there are questions or problems with installation that the user's guide does not answer, computer support personnel will be available. When contacting the computer support personnel, give your name, phone number, and address (both e-mail and mailing) along with a description of the problem and what you were doing when the problem occurred. Please provide as detailed steps as possible to allow duplication of the error. You can expect a response within 24 hours of when questions are received.

    TO CONTACT COMPUTER SUPPORT PERSONNEL: 

    Write to: Dept. of Commerce
          WVS Support
          1313 Halley Circle
          Norman, OK.  73069

    
Or e-mail to:
    
INTERNET:     esdim@nsslsun.nssl.uoknor.edu
    

    
Or call:  (405) 366-0533
    

    
Or FAX:   (405) 366-0472

    A.2 Load Software

    Whether receiving the software from tape or ftp, the software will be in one file. The file will be a tar file which is one file containing many files. (Consult your workstation manual if the tar instructions below do not work, your workstation may require something different.) All the software will reside in one directory.

    A.2.1 To receive the software from tape

    1. Make a directory for the software and change your directory to that directory.

    2. Load the tape into the tape drive.

    3. From the directory created for the software, extract the files by typing:

    tar xvf tape-device (to extract all the files from the one tar file on the tape)

    or

    tar xvf tape-device file1 file2 file3 ... filen (to extract individual files from the one tar file on the tape)

    Possible file names are:
    zzzwvstar (tar software file)

    guide.wp (Users Guide)

    README (copy of announcement)

    countyLines.XXXX (county-line files, where XXXX is the radar site ID)

    4. If zzzwvstar is tarred in from the tape, it will have to be tarred again to produce the software files. To do so, enter:

    tar xvf zzzwvstar

    tape-device - the tape path name and tape drive name (e.g. /dev/rmt0).

    5. Use appendix A of the user's guide to install WVS.

    A.2.2 To receive the software from ftp

    1. Make a directory for the software and change directories to that directory.

    2. From the directory created for the software, use ftp (file transfer protocol) to bring the software into the directory.

    3. Type: hurricane.ncdc.noaa.gov

    4. login as anonymous

    5. use your username as the password

    6. Type: cd /pub/nexrad_l2 (where l' is lower case L')

    7. Type: binary

    8. Type: get README

    9. Type: get zzzwvstar

    10. Type: get guide.wp

    11. To get a county line overlay file,

    type: get countyLines.XXXX where XXXX is the radar name ID. (Repeat this procedure for each countyline overlay file desired.)

    12. To end the ftp session, type: quit

    13. Type: tar xvf zzzwvstar

    A.3 Customize Makefile

    Before compiling the programs, the makefile must be customized for your platform. Using the editor of your choice, get into the editing mode for 'Makefile'. For the compilers, includes and flags, and libraries, the makefile has the lines listed for each platform (Sun, SGI, HP, IBM). Un-comment the lines (by deleting the '#' at the beginning of the line) for your platform.

    Figure A-1 shows the file 'Makefile' as received from NCDC. (Only the first half of 'Makefile' is shown because that is where all the changes are made. No changes need to be made in the second half of 'Makefile'.) Figure A-2 shows the file 'Makefile' modified for a SUN platform. If necessary for your system, change compiler names, paths, etc. Save the edited makefile.

    A.4 Customize platform.h

    Using the editor of your choice, get into the editing mode for 'platform.h'. Before the line '#ifdef sun', insert the line "#define platform 1". platform will be either 'SUN', 'IBM', 'HP', or 'SGI'. Figure A-3 shows the beginning of the file 'platform.h' as received from NCDC. Figure A-4 shows the beginning of the file modified for a SUN platform. Save the edited file.

##################################################################
 #
 # C and Fortran compilers
 #

##################################################################

 ##### Sun #####
 #CC           = acc 
 #FC           = /usr/lang/f77-1.4

 ##### SGI #####
 #CC           = cc
 #FC           = f77

 ##### HP9000 series #####
 #CC           = c89
 #FC           = f77

 ##### IBM #####
 #CC           = cc
 #FC           = f77


##################################################################
 #
 # Include directories and flags
 #

##################################################################

 ##### Sun #####
 #CFLAGS       = -c
 #INCLUDES     =

 ##### SGI #####
 #CFLAGS       = -c
 #INCLUDES     =

 ##### HP9000 series #####
 #CFLAGS       = -c -D_HPUX_SOURCE
 #INCLUDES     = -I/usr/include/X11R4 -I/usr/include/Motif1.1

 ##### IBM #####
 #CFLAGS       = -c
 #INCLUDES     =


##################################################################
 #
 # Libraries:
 #    Library order is important!!!! It MUST be as 
 #    such or the HP will
 #    generate errors!: -lMrm -lXm -lXt -lX11
 #

##################################################################
 X_LIBS        = -lXm -lXt -lX11 -lm

 ##### Sun #####
 #CLIBS        = $(X_LIBS)

 ##### SGI #####
 #CLIBS        = $(X_LIBS)

 ##### HP9000 series #####
 #CLIBS        = -L/usr/lib/X11R4 -L/usr/lib/Motif1.1 $(X_LIBS)

 ##### IBM #####
 #CLIBS        = $(X_LIBS)


                            Figure A-1



##################################################################
 #
 # C and Fortran compilers
 #

##################################################################

 ##### Sun #####
 CC            = acc 
 FC            = /usr/lang/f77-1.4

 ##### SGI #####
 #CC           = cc
 #FC           = f77

 ##### HP9000 series #####
 #CC           = c89
 #FC           = f77

 ##### IBM #####
 #CC           = cc
 #FC           = f77


##################################################################
 #
 # Include directories and flags
 #

##################################################################

 ##### Sun #####
 CFLAGS        = -c
 INCLUDES      =

 ##### SGI #####
 #CFLAGS       = -c
 #INCLUDES     =

 ##### HP9000 series #####
 #CFLAGS       = -c -D_HPUX_SOURCE
 #INCLUDES     = -I/usr/include/X11R4 -I/usr/include/Motif1.1

 ##### IBM #####
 #CFLAGS       = -c
 #INCLUDES     =


##################################################################
 #
 # Libraries:
 #    Library order is important!!!! It MUST be 
 #    as such or the HP will
 #    generate errors!: -lMrm -lXm -lXt -lX11
 #

##################################################################
 X_LIBS        = -lXm -lXt -lX11 -lm

 ##### Sun #####
 CLIBS         = $(X_LIBS)

 ##### SGI #####
 #CLIBS        = $(X_LIBS)

 ##### HP9000 series #####
 #CLIBS        = -L/usr/lib/X11R4 -L/usr/lib/Motif1.1 $(X_LIBS)

 ##### IBM #####
 #CLIBS        = $(X_LIBS)


                            Figure A-2


 /*
  *      Definitions to allow the WSR-88D 
  *      Visualization Software package
  *      to work on multiple systems.
  *
  *      In the line above '#ifdef SUN', 
  *      enter '#define "PLATFORM"
1'
  *      e.g. '#define SUN 1'
  */

 #ifdef SUN
 #define l2flinit        l2flinit_
 #define l2flwrite       l2flwrite_
 #define l2getmsg        l2getmsg_
 #define tpopen          tpopen_
 #define tpread          tpread_
 #define c_tpclose       c_tpclose_


                            Figure A-3




 /*
  *      Definitions to allow the WSR-88D 
  *      Visualization Software package
  *      to work on multiple systems.
  *
  *      In the line above '#ifdef SUN', 
  *      enter '#define "PLATFORM"
1'
  *      e.g. '#define SUN 1'
  */

 #define SUN        1

 #ifdef SUN
 #define l2flinit        l2flinit_
 #define l2flwrite       l2flwrite_
 #define l2getmsg        l2getmsg_
 #define tpopen          tpopen_
 #define tpread          tppread_
 #define c_tpclose       c_tpclose_


                            Figure A-4

Top of Page Appendix B: Getting Ready to Run

    B.1 Changing wvsreader.sav

    The file 'wvsreader.sav' (Fig. B-1) has several parameters used by the wvsreader program. The file can be changed as needed by the user. The line position of each parameter is important. Lines cannot be left out and parameters cannot be rearranged.

    When wvsreader starts, it displays a list of parameters and asks if these need to be changed. The list of parameters comes from the wvsreader.sav file. If you have parameters that will remain relatively stable, it is best to set these parameters in the wvsreader.sav file.

    
 -99                          threshold
 1                            starting vol scan number
 /dev/rmt0                         tape path & device name
 1                            reflectivity 1-generate
 1                            velocity     0-don't gen
 1                            spectrum width
 1                            composite reflectivity
 99.0                              maximum elevation
 /data/                            directory path & name


                            Figure B-1
    Line 1 -
    Threshold - If reflectivity values are less than this number, the velocity and spectrum width values are set to missing.

    Line 2 -

    Starting volume scan number - wvsreader will start numbering the volume scans at the number specified on line 2 (sweep numbering is always started at 1).

    Line 3 -

    Tape device - The tape device path and tape device name are specified here (e.g. /dev/rmt0).

    Line 4 -

    Reflectivity - Reflectivity is a measure of the fraction of radiation reflected by a given surface; defined as a ratio of the radiant energy reflected to the total that is incident upon that surface. The user decides whether or not the reflectivity image field will be generated. Enter a '1' to generate the reflectivity image field. Enter a '0' (zero) to not generate the reflectivity image field. If the reflectivity is not wanted, not generating it will save space on the disk.

    Line 5 -

    Velocity - Velocity (radial) is a measure of the radial component (toward or away from the radar) of the motion of detectable scatterers. The user decides whether or not the velocity image field will be generated. Enter a '1' to generate the velocity image field. Enter a '0' (zero) to not generate the velocity image field.

    Line 6 -

    Spectrum Width - Spectrum Width is a measure of dispersion of velocities within the radar sample volume. The user decides whether or not the spectrum width image field will be generated. Enter a '1' to generate the spectrum width image field. Enter a '0' (zero) to not generate the spectrum width image field.

    Line 7 -

    Composite reflectivity - Composite reflectivity is the average of all the reflectivity sweeps of a volume. There is only one composite reflectivity sweep per volume scan. The user decides whether or not the composite reflectivity image field will be generated. Enter a '1' to generate the composite reflectivity image field. Enter a '0' (zero) to not generate the composite reflectivity image field.

    Line 8 -

    Maximum elevation - This is the maximum elevation for which images will be generated.

    Line 9 -

    Data directory - This is the path and name of the directory on the disk where the data will be put (the path name must end with a '/').

    B.2 WVS Display User Preferences and Defaults

    There are some user preferences that can be set for the display of WVS. These preferences can be changed and made effective without recompiling the source code. If the program is running when the changes are made, the changes won't take affect until the program is exited and restarted.

    Color scales - There is a color scale for each field. The colors in these scales can be changed without recompiling the programs. For reflectivity and composite reflectivity, change the colors in the file 'colorTable.ref'. For velocity, change the colors in the file 'colorTable.vel'. For spectrum width, change the colors in the file 'colorTable.sw'. The colors in the color tables can be either a predefined color name (by X11 distribution) or an RGB triplet in hexadecimal preceded by a '#' (see Figure B-2).

     /*
  * Reflectivity Color Table:
  *  Each entry is either a predefined color 
           name (by X11 distribution)
  *  or an RGB triplet in hexadecimal preceded 
           by a '#' of the forms:
  *    #rgb
  *    #rrggbb
  *    #rrrgggbbb
  # where r is 'red', g is 'green', 
          and b is 'blue' values for the color.
  */
 #666666                 /* grey    */
 #00ecec #01a0f6 #0000f6 /* blues   */
 #00ff00 #00c800 #009000 /* greens  */
 #ffff00 #e7c000 #ff9000 /* yellows */
 #ff0000 #d60000 #c00000 /* reds    */
 White                   /* white   */


                            Figure B-1

    User Preferences and defaults - The Wvsdisp file contains parameters that can be changed by the user. The user preferences are at the beginning of the file. These are the range ring parameters and the auto update interval. The setting for the auto update interval is only the initial setting. There is also a provision in the program to change the auto update interval interactively.

    Application defaults are mainly for the control panel and probably should not be changed unless necessary for proper displaying of the control panel.

    
!*****************************************************
! These are the user preferences
!*****************************************************
!
!range rings center offset in grid units (Km)
!
wvsdisp.rangeRingOffsetX:                         0
wvsdisp.rangeRingOffsetY:                         0
!
! range ring frequency (in grid units)
!
wvsdisp.rangeRingFrequency:                  50000
!
!  Time interval for Auto Update - 
!        this is the initial setting only,
!  the time interval can also be changed 
!        interactively in the program.
!
wvsdisp.updateInterval:                      1

!*****************************************************
! These are the application defaults
!*****************************************************
!
! Control Panel geometry: WIDTHxHEIGHT
!
wvsdisp.geometry:                            340x400
!
! Default background and foreground
!
wvsdisp.*.background:                        LightGrey
wvsdisp.*.foreground:                        Black
!
! Overlay font and color
!
wvsdisp.overlayFont:                   
*-courier-bold-r-normal--14-*-iso8859-1
wvsdisp.overlayColor:                        NavyBlue

wvsdisp.MainWindow.width:                    335
wvsdisp.MainWindow.MenuBar.*.MenuLabel.fontList:       \
                              -*-Helvetica-Bold-r-*-14-*-*
wvsdisp.MainWindow.MenuBar.*.Label.fontList: \
                              -*-Helvetica-Bold-r-*-14-*-*
wvsdisp.*.MainWindow.scrollBarPlacement:    BOTTOM_RIGHT

wvsdisp.*.VolScanText.background:            Black
wvsdisp.*.VolScanText.foreground:                 White
wvsdisp.*.VolScanLabel.fontList:        -*-New Century
Schoolbook-Bold-r-*-14-*-*
wvsdisp.*.VolScanText.fontList:         -*-New Century
Schoolbook-Bold-r-*-14-*-*

wvsdisp.*.ControlBoxSeparator.width:              335
wvsdisp.*.ControlBoxSeparator.height:             5
wvsdisp.*.ControlBoxSeparator.shadowThickness:         5
wvsdisp.*.ControlBoxSeparator.separatorType: SHADOW_ETCHED_IN
wvsdisp.*.VolSweepText.width:                335
wvsdisp.*.VolSweepText.fontList:        -*-New Century
Schoolbook-Bold-r-*-14-*-*

wvsdisp.*.DisplayCheckBox.selectColor:            Red
wvsdisp.*.DisplayCheckBox.topOffset:              0
wvsdisp.*.DisplayCheckBox.leftAttachment:   ATTACH_FORM
wvsdisp.*.DisplayCheckBox.fontList:     -*-New Century
Schoolbook-Bold-r-*-14-*-*

wvsdisp.*.DisplayOptionBox.width:                 320
wvsdisp.*.DisplayOptionBox.leftAttachment:  ATTACH_POSITION
wvsdisp.*.DisplayOptionBox.leftOffset:            15
wvsdisp.*.DisplayOptionBox.fontList:    -*-New Century
Schoolbook-Regular-r-*-14-*-*

wvsdisp.*.DisplayOptions.width:                   320
wvsdisp.*.DisplayOptions.selectColor:             Red
wvsdisp.*.DisplayOptions.leftAttachment:    ATTACH_POSITION
wvsdisp.*.DisplayOptions.leftOffset:              15
wvsdisp.*.DisplayOptions.fontList:      -*-New Century
Schoolbook-Bold-r-*-10-*-*

GraphicShell.*.background:                        Black
GraphicShell.*.foreground:                        White

wvsdisp.*.Information.textFontList:         
*-helvetica-bold-r-*-14-*-iso8859-1
wvsdisp.*.Information.labelFontList:  
                       *-helvetica-bold-r-*-14-*-iso8859-1
wvsdisp.*.Information.buttonFontList:   
                       *-helvetica-bold-r-*-14-*-iso8859-1

Top of Page Appendix C: City Locations File

    C.1 Creating a Text Overlay File

    City names, radar locations, SAO stations as well as county names can be displayed using the city overlay function. However, a text file will need to be created before the city overlay will be operational. Before entering WVS, the file should be created using the editor of your choice. The name of the file must be 'cityLocations.radar' where radar is the four letter identifier for the radar name (e.g. KOUN). The letters must be in the correct case. 'cityLocations' must be in all lower case except the "L". The radar name must be in all upper case. The file must be in the same directory as the WVS programs.

    When creating the text file, the following will be input...

    * RANK
    * TYPE
    * STRING
    * LATITUDE
    * LONGITUDE

    The RANK corresponds to the magnification of images, displays certain cities at each magnification...The lower numbers are plotted at bare [default] magnification. The higher numbered cities are plotted as the image is zoomed in. For example, a rank of 1 will display a city name at a magnification of 1 and at every magnification thereafter as the image is zoomed in. On the other hand, a rank of 6 will display the town name at a magnification of 6 and at every magnification thereafter as the image is zoomed in. The location in the last example will not be displayed at magnifications lower than 6. (Magnification is done at intervals of 2 starting with 2. The image is initially displayed at a magnification of 1 and zoomed in to a magnification of 2, 4, 6, 8, etc.)

    The TYPE of marker that will be used to denote a particular string on the display is designated as follows...

    10 = DIAMOND [always plotted]
    11 = TRIANGLE [always plotted]
    15 = DOT [plotted if rank is lower than zoom]
    16 = NO MARKER [text is still plotted (e.g. county names)]
    02 = SQUARE [always plotted]

    It is important to note that the type number will give precedence over rank. That is, 10, 11, 16, and 02 are ALWAYS plotted at each magnification regardless of rank specification. Marker number 15 is the only one that allows the rank number to dictate when that string is plotted.

    The string is the character line to be plotted on the radar display (examples are city names, radar names, SAO stations, county names, etc.). If the string consists of 2 or more words, DO NOT place a space between each one. (e.g. 'Oklahoma City' would be input as 'OklahomaCity' with no space.)

    The LATITUDE (LONGITUDE) is the latitude (longitude) for the location of the string in decimal degrees. A minus sign [-] is placed in front of the lat/lon to indicate west or south of 0 degrees.

    Below is an example of a city overlay file:

    2 10 KOUN 35.23651 -97.46333
    1 11 CIM 35.47533 -97.81314
    1 10 KOKC 35.33306 -97.2775
    1 10 KFDR 34.36222 -98.97611
    3 02 PRC 34.98 -97.52
    3 02 VCI 36.07 -99.02
    3 02 LMN 36.69 -97.48
    4 15 Addington 34.267 -97.983
    6 15 CampHouston 36.817 -99.117
    2 15 Arnett 36.133 -99.767
    4 15 DillCity 35.283 -99.133
    8 15 Criner 34.967 -97.567
    1 16 Oklahoma 35.4 -97.6
    1 16 Kay 36.73333 -97.1

    In the above sample file, the last 2 locations (Oklahoma and Kay) represent County names. Note that the type of marker is designated by a '16' which means, from the explanation above, that there is no symbol yet the text is still plotted (text being the name of the county). However, because the type number is 16, the rank is irrelevant (a '1' was input for the rank number because something must be read as a rank, not because it is matters in this case).

    On the other hand, the town of Dill City is given a type number of 15 which indicates that the text will be plotted only as the rank number dictates and that the text, when plotted, will be denoted by a dot. In this case, the rank number is 4 which means that the text will not be displayed until the image is zoomed in 4X, and will then be plotted at every magnification from there on.

Top of Page Appendix D: Advanced Features

    D.1 Simplified Start-up

    WVS uses two shells to start the display program, WVSSERVER and WVSDISPLAY. These shells are written in C shell, but will run in other shells. To make the start-up process a little easier, the shell 'WVS' has been included for your use. To start the display program using this shell:

    1. WVS directory port hostname

    directory
    the path where the data files are stored. NOTE: the path must have a slash on the end. (e.g. "/scratch/data/")

    port
    some number > 21000 and < 99999.

    hostname
    the name of the workstation where the program is being run.

    D.2 Running on Multiple Workstations

    The display program is in two parts, wvsserv and wvsdisp. wvsserv acts as a server for wvsdisp. Because of this, the data files can reside on one workstation and another workstation can display the radar images. This is why the port number and the hostname are necessary when starting WVSSERVER and WVSDISPLAY. The parameters are used to connect the two programs over the network. The port number is the tcp/ip number the network uses to connect the two programs.

    In order to have the data reside on one workstation and be able to display the data on another workstation:

    1. wvsreader must be run on the workstation where the data will reside.

    2. Start WVSSERVER on the workstation which contains the data. The correct directory and port number must be specified.

    3. Start WVSDISPLAY on the other workstation, entering the same port number as above (this is what connects the two programs over the network), and the name of the workstation WVSDISPLAY is being run on.

    When running WVSSERVER on one workstation and WVSDISPLAY on another workstation, the shell WVS cannot be used. It can only be used when WVSSERVER and WVSDISPLAY are run on the same workstation.

    WVS was written to allow only one display program to run for one server program. If multiple server and display program sets are run, each set must use a different port number. As long as different port numbers are used for each set, as many sets as desired (to the limit of the amount of memory on the machine) can be run on one machine or combination of machines.

    D.3 Advanced Compilation

    To install WVS, "make all" is all that is necessary. "all" is composed of making three executable files. These files are "wvsdisp", "wvsserv", and "wvsreader". These files may be made individually. "wvsdisp" and "wvsserv" are for the display portion of WVS. "wvsreader" is for the level II reader portion of WVS. To make wvsdisp, type make wvsdisp . To make wvsserv, type make wvsserv . To make wvsreader, type make wvsreader .

Top of Page Top of Page

http://www.ncdc.noaa.gov/oa/radar/radarproductssoftwareguide.html
Downloaded Wednesday, 07-Jan-2009 21:36:30 EST
Last Updated Monday, 25-Nov-2002 15:02:23 EST
Please see the NCDC Contact Page if you have questions or comments.