WPCin 2a BNcZTimes Roman#|T co\  PCXP"m^2CRddCCCdq2C28dddddddddd88qqqYzoCNzoozzC8C^dCYdYdYCdd88d8ddddCN8ddddY`(`lC2CC!CCCCCCCCCCd8YYYYYYzYzYzYzYC8C8C8C8ddddddddddYdddddodYYYYYYYdzYzYzYzYddddddddC8C8C8C8Ndz8z8z8z8z8ddddddCCCoNoNoNoNz8z8z8dddddddzYzYzYdz8dCoNz8dddddNF2[dCYddddd7>d<d<$YYdCCddooCYd<d<$YYdCCddooCYd<d<$YYdCCddooCY"m^2CTddCCCd2C28ddddddddddCCdzzzzCYozzdozzooN8NTdCddYdY8dd88Y8ddddNN8dYYYNP7PlC2CC!CCCCCCCCCCd8zdzdzdzdzdYzYzYzYzYC8C8C8C8dddddddddoYzddddoYdzdzdzdzdYYYYdzYzYzYzYddddddddC8C8C8C8YYo8o8o8o8o8ddddddzNzNzNdNdNdNdNo8o8o8ddddddoYoNoNoNdo8dzNdNo8oYoYdddNF2idNdddddd7>d<d<+oodCCddddCo<чnn8!BBnnnyyP7c1RyyXyycnnnѐ~nyRzczXzcyhCBnndhcnnonvyXzXshn~XyBBnss~|y~~~~~~~~~~~~~~~~~~~XXXXXXXyyyyyyyyyyyyyyyyyyyyBBBBBBBBBBBBnnnnnnnsssssssssssszCCn"X^CYmYYYCYCJJJvYhYJY}YvvvYJJJYhJv5YCYY -YYYYYYYYYYJvvvvvvvvvvYJYJYJYJvvvvvvvvvvvvYJYJYJYJhJJJJJYYYhhhhJJJvvvJYhJN]CyYvJSPP0vv YY Yv PJ-XXkIBnunuYXuuuXXuuuuuuuXXXXXXXXXXXXYY"X^CY YYYCYCJYYh YJYYvvYJYJvhYvi;iYCYY -YYYYYYYYYYJ vvvvvhJhJhJhJvvvvvvvvhJhJhJhJJJJJJ vvvhhhhYYY vvvJvhYN]CYPXPPJ YY  Y PJ-XXkIBnunuYXuuuXXuuuuuuuXXXXXXXXXXXXYY"m^:N_uu¶NNNu:N:AuuuuuuuuuuAAhרN[ϨܨNANmuNhuhuhNuuAAuAuuuuN[Auuuuhp/p~N:NN'NNNNNNNNNNuAhhhhhϜhhhhhNANANANAuuuuuuuuuuhuuuuuuhhhhhhhuhhhhuuuuuuuuNANANANA[uAAAAAuuuuuuϨNNN[[[[AAAuuuuuuܨuhhhuAuN[AuuuuuNR:juNhuuuuu@HuFuF*hhuNNuuNhFфA'MM捍]@s:`捍fsѨ`sfszNMuzsffzfMMfffffffMMMMMMMMMMMMNN2PO cAc'E cH cK"m^:NuuNNNu:N:AuuuuuuuuuuNNu٨[uܨ騨NANuNuhhNuANA‚uh[Nuuuh\3\yN:NN'NNNNNNNNNNAuuuuu騨hhhhh[A[A[A[Auuuuuuuuuuuuuhhhhhhhhuuuuuu[A[A[A[AuAAAAAuu騨hhh[[[[NNN騨uhhhAh[NuuuNR:~uNuuuuuuFMuFuFAuuuNNuuNuFхA'MM捍]@s:`捍fsѨ`sfszNMςzsffzfMMfffffffMMMMMMMMMMMMNN"m^.=K\\===\g.=.3\\\\\\\\\\33gggQzzpf=Gpfzfpp=3=V\=Q\Q\Q=\\33\3\\\\=G3\\\\QX%Xc=.============\3QQQQQzzQpQpQpQpQ=3=3=3=3\\\\\\\\\\Q\\\\\f\QQQzQzQzQzQ\pQpQpQpQ\\\\\\\\=3=3=3=3G\p3p3p3p3p3\\\\\\z=z=z=fGfGfGfGp3p3p3\\\\\\\pQpQpQ\p3\z=fGp3\\\\\N@.S\=Q\\\\\39\7\7!QQ\==\\ff=Q7ggee3g<3I333Y! !("d!!31!>3!!!3"X^SooooSoS]]]3o(;o]ooo]]]o]CoSooM8oooooooooo](o]o]o]o]o]o]o]o]]]]]](ooo]]];]o]NuSo\gdd<MooGMoMd]8nnII[[R III[ on( nnnnnnnnnnnnnnoo"X^SoMoooSoS]oo6;Mo]ooo]o]oIoSooM8oooooooooo]M]]]]]]]]]]]]]MoooM]oNuSodndd]MooMMoMd]8nnII[[R III[ on( nnnnnnnnnnnnnnoo2dgF^gnT?xxxx6X@KX@?xxxx `KX 7oC2co\  PCXP7tC2!wt4  p(ACXW!C(#$AC\  PChP<5nC22n*f9 xCXX IYC\  PC P IYC!4  p(AC @N:p\  PCP  @N:!p4  p(ACTr5dddߌd6X@K@ s4dddތd `Ky.]8*]\  PCP y.a8*!a4  p(AC2f=.[f\  PC&P2j=.!j4  p(AC& #md!(.4  p(AC<=N:2˴p*f9 xCX@[oSc|\  PCP[oS!|4  p(AC7[[%_%%#.4  p(AC(# :W V S 7U S E R ' S R8G U I D E #\  PC P#&0*0*0*     j, X INTRODUCTION p!(#h 3  j X CHAPTER 1 p!(#h 4  j XX` `  Running WVS ` p!(#h 4  j XX` ` X #` `  1.1 Running the tape reader program p!(#h 4  j XX` ` X #` `  1.2 Running the display program p!(#h 4  j4 XX` ` X #` `  1.3 Operating the display program p!(#h 5  j` XX` ` X #` `  1.4 Support p!(#h 7  j XX` ` X #` `  1.5 Data Formats p!(#h 7  j X APPENDIX A p!(#h 9  j XX` `  Installation ` p!(#h 9  j< XX` ` X #` `  A.1 Installation Overview p!(#h 9  jh XX` ` X #` `  A.2 Load Software p!(#h 10  j XX` ` X #X* # A.2.1 To receive the software from tape p!(#h 10  j XX` ` X #X* # A.2.2 To receive the software from ftp p!(#h 10  j XX` ` X #` `  A.3 Customize Makefile p!(#h 11  j XX` ` X #` `  A.4 Customize platform.h p!(#h 12  jp X APPENDIX B p!(#h 16  j XX` `  Getting Ready to Run ` p!(#h 16  j XX` ` X #` `  B.1 Changing wvsreader.sav p!(#h 16  j XX` ` X #` `  B.2 WVS Display User Preferences and Defaults p!(#h 17  jL X APPENDIX C p!(#h 20  jx XX` `  City Locations File ` p!(#h 20  j XX` ` X #` `  C.1 Creating a Text Overlay File p!(#h 20  j! X APPENDIX D p!(#h 22  j(# XX` `  Advanced Features ` p!(#h 22  jT$ XX` ` X #` `  D.1 Simplified Startup p!(#h 22  j% XX` ` X #` `  D.2 Running on Multiple Workstations p!(#h 22  j& XX` ` X #` `  D.3 Advanced Compilation p!(#h 23 '0*0*0*  j  , @ta Test - @#\  PC P#6 INTRODUCTION ׃  jX 4 WVS User's Guide ă #o\  PCcXP# This is a guide to using the WVS (WSR88D Visualization System) program. It is assumed the user has experience with UNIX on a specific UNIX workstation. WVS provides the following functionality:  X  a.X Display Images for reflectivity, velocity, spectrum width, and composite reflectivity(#  X  b.X Overlay county lines, city locations, and range rings(#  X  c.X Zoom /unzoom the images(#  Xp  d.X Display azimuth, range, height and data value at mouse click location(#  XB  e.X Display raw data points of near points around a mouse click location(#  X  f.X Automatically update through sweeps of images(#  X  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 standalone 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.  X\  The reader program generates "image" files using Level II data as input. The input is from tape only. The output files consist of resampled radar data (i.e., original polar format converted  X. to cartesian format) on a 501 x 501 km grid domain with 1 km2 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  X 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 WSR88D  X data, or for analysis of phenomena having a scale of at least 10 km2. !0*<(<(  j #\  PC P#8 CHAPTER 1 ׃  jX 7 Running WVS ׃ #p\  PCP#  a  1.1 Running the tape reader program  #o\  PCcXP# For instructions about initial program installation, see appendix A.  X]  To run the wvsreader: 1.XMount a tape in a tape drive.(# 2.XMake sure you're in the directory containing the WVS programs.(#  X  3.XType wvsreader (# 4.XThe 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. (see appendix B).(# 5.XWhen 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.XIf 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 ctrlc.(#  a! #p\  PCP# 1.2 Running the display program  #o\  PCcXP# 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.XMake sure you're in the appropriate directory.(# &0*<(<(Ԍ X  2.XType WVSSERVER directory port(#  X Xdirectory #the directory path where the data files are stored. NOTE: the directory path must have a slash on the end. (e.g., "/scratch/data/")(#  X XportX` ` X #some number > 21000 and < 99999. (see appendix D.2)(#  Xe  3.XType WVSDISPLAY port hostname(#  X9 XportX` ` X #the same number as port in step 1.(#  X Xhostname #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 startup process a little easier (see appendix D).  a #p\  PCP# 1.3 Operating the display program  #o\  PCcXP#  Xx  1.X 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.(#  X  2.X 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.(# XWhen 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.(#  X  3.X 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.(# XThe auto update feature defaults to display every sweep in the volume, but may beP'0*<(<( 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.(#  X X 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.XThere is also program interaction in the image displays. All functions are controlled by mouse buttons:(#  X a.` `  Cursor location and data values: XX` ` 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.(#`  XK b.` `  Zooming the image: XX` ` 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.(#`  X c.` `  Unzooming the image: XX` ` Pressing the 'shift' key while simultaneously clicking the middle mouse button in an image window unzooms the image one magnification, centered on the cursor location. If the image is unzoomed to the original size, the image is centered on the radar.(#`  X7 d.` `  Unzooming the image to original size: (#` XX` ` Pressing the 'control' key while simultaneously clicking the middle mouse button in an image window unzooms the image to the normal (unzoomed) magnification level from any level of magnification, centered on the radar.(#`  X e.` `  Inquiring data values near the cursor: XX` ` 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.(#`  XQ%  5.X To quit the program , click the left mouse button on the 'Quit/Server' button in the control panel.(# #'0*<(<(Ԍ a #p\  PCP#љ 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 #o\  PCcXP##p\  PCP#  a  1.5 Data Formats   X #o\  PCcXP#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 WSR88D 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.'0*<(<(ԌWSR88D 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. y0*<(<(  j #\  PC P#7 APPENDIX A ׃  jX a6 Installation ׃ #p\  PCP#  a  A.1 Installation Overview  #o\  PCcXP# The following steps must be performed in the order listed. 1.XIf you have not already done so, load the software onto your workstation (see A.2 for details).(#  X 2.XModify Makefile (see A.3 for details).(#  X 3.XModify platform.h (see A.4 for details).(#  X 4.XType 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 email to: INTERNET:` `  #esdim@nsslsun.nssl.uoknor.edu Or call:` `  #(405) 366-0533 Or FAX:` `  #(405) 366-0472 # 0*<(<(  a #p\  PCP# A.2 Load Software  #o\  PCcXP# 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.  Xi  A.2.1 To receive the software from tape  1.XMake a directory for the software and change your directory to that directory.(# 2.XLoad the tape into the tape drive.(# 3.XFrom the directory created for the software, extract the files by typing:(#  X X tar xvf tape-device (to extract all the files from the one tar file on the tape)(# or  XW X tar xvf tape-device file1 file2 file3 ... filen (to extract individual files from the one tar file on the tape)(# XPossible file names are:hh2zzzwvstar@ppG(tar software file)(# ` `  #*hh2guide.wp@ppG(Users Guide) ` `  #*hh2README@ppG(copy of announcement) ` `  #* hh2countyLines.XXXXppG(county line files, where XXXX is the radar site acronym)(#p XIf zzzwvstar is tarred in from the tape, it will have to be tarred again to produce the software files. To do so, enter:(#  XE ` `  tar xvf zzzwvstar  X Xtape-device - the tape path name and tape drive name (e.g. /dev/rmt0).(# 5.XUse appendix A of the user's guide to install WVS.(#  X#  A.2.2 To receive the software from ftp  1.XMake a directory for the software and change directories to that directory.(# 2.XFrom the directory created for the software, use ftp (file transfer protocol) to bring theJ' 0*<(<( software into the directory.(#  X 3. Type: ftp hurricane.ncdc.noaa.gov  X 4. login as anonymous 5. use your username as the password  XH 6. Type: cd /pub/nexrad_l2  X 7. Type: binary  X 8. Type: get README  X 9. Type: get zzzwvstar  X 10. Type: get guide.wp 11. To get a county line overlay file,  XK  type: get countyLines. XXXX  X6  where XXXX is the radar name acronym. (Repeat this procedure for each countyline overlay file desired.)  X 12. To end the ftp session, type: quit  X 13. Type: tar xvf zzzwvstar  ai #p\  PCP# A.3 Customize Makefile  #o\  PCcXP#  X\  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). Uncomment the lines (by deleting the '#' at the beginning of the line) for the platform WVS will be compiled on. Figure A1 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 A2 shows the file 'Makefile' modified for a SUN platform. If necessary for your system, change compiler names, paths, etc. Save the edited makefile. _& 0*<(<(Ԍ a #p\  PCP# A.4 Customize platform.h  #o\  PCcXP# Using the editor of your choice, get into the editing mode for 'platform.h'. Before the line  X '#ifdef sun', insert the line "#define platform 1". platform will be either 'SUN', 'IBM', 'HP', or 'SGI'. Figure A3 shows the beginning of the file 'platform.h' as received from NCDC. Figure A4 shows the beginning of the file modified for a SUN platform. Save the edited file.  0*<(<( #f\  PC[&P# J ddx !ddx x J X&X&  ############################################################################## # # C and Fortran compilers # ############################################################################## ##### Sun ##### #CC L L %= acc #FC L L %= /usr/lang/f77-1.4 ##### SGI ##### #CC L L %= cc #FC L L %= f77 ##### HP9000 series ##### #CC L L %= c89 #FC L L %= f77 ##### IBM ##### #CC L L %= cc #FC L L %= f77 ############################################################################## # # Include directories and flags # ############################################################################## ##### Sun ##### #CFLAGS L L %= -c #INCLUDES L L %= ##### SGI ##### #CFLAGS L L %= -c #INCLUDES L L %= ##### HP9000 series ##### #CFLAGS L L %= -c -D_HPUX_SOURCE #INCLUDES L L %= -I/usr/include/X11R4 -I/usr/include/Motif1.1 ##### IBM ##### #CFLAGS L L %= -c #INCLUDES L L %= ############################################################################## # # Libraries: # Library order is important!!!! It MUST be as such or the HP will # generate errors!: -lMrm -lXm -lXt -lX11 # ############################################################################## X_LIBS L L %= -lXm -lXt -lX11 -lm ##### Sun ##### #CLIBS L L %= $(X_LIBS) ##### SGI ##### #CLIBS L L %= $(X_LIBS) ##### HP9000 series ##### #CLIBS L L %= -L/usr/lib/X11R4 -L/usr/lib/Motif1.1 $(X_LIBS) ##### IBM ##### #CLIBS L L %= $(X_LIBS)X& <7 Figure A1 ă& 0*<(<( @ !ddx x Addxx @ X&X&  ############################################################################## # # C and Fortran compilers # ############################################################################## ##### Sun ##### CC L L %= acc FC L L %= /usr/lang/f77-1.4 ##### SGI ##### #CC L L %= cc #FC L L %= f77 ##### HP9000 series ##### #CC L L %= c89 #FC L L %= f77 ##### IBM ##### #CC L L %= cc #FC L L %= f77 ############################################################################## # # Include directories and flags # ############################################################################## ##### Sun ##### CFLAGS L L %= -c INCLUDES L L %= ##### SGI ##### #CFLAGS L L %= -c #INCLUDES L L %= ##### HP9000 series ##### #CFLAGS L L %= -c -D_HPUX_SOURCE #INCLUDES L L %= -I/usr/include/X11R4 -I/usr/include/Motif1.1 ##### IBM ##### #CFLAGS L L %= -c #INCLUDES L L %= ############################################################################## # # Libraries: # Library order is important!!!! It MUST be as such or the HP will # generate errors!: -lMrm -lXm -lXt -lX11 # ############################################################################## X_LIBS L L %= -lXm -lXt -lX11 -lm ##### Sun ##### CLIBS L L %= $(X_LIBS) ##### SGI ##### #CLIBS L L %= $(X_LIBS) ##### HP9000 series ##### #CLIBS L L %= -L/usr/lib/X11R4 -L/usr/lib/Motif1.1 $(X_LIBS) ##### IBM ##### #CLIBS L L %= $(X_LIBS)X&  S& <7 Figure A2 Ѓ&0*<(<( #o\  PCcXP# @ Addxx addxx @   /* * 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 l2flinitL L %,l2flinit_ #define l2flwriteL L %,l2flwrite_ #define l2getmsgL L %,l2getmsg_ #define tpopenL L %,tpopen_ #define tpreadL L %,tpread_ #define c_tpcloseL L %,c_tpclose_  Xh 7 Figure A3 ă @ addxx ddx#x @ Q  /* * 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 SUNL L %,1 #ifdef SUN #define l2flinitL L %,l2flinit_ #define l2flwriteL L %,l2flwrite_ #define l2getmsgL L %,l2getmsg_ #define tpopenL L %,tpopen_ #define tpreadL L %,tppread_ #define c_tpcloseL L %,c_tpclose_Q#  X]# 7 Figure A4 ă F$0*<(<(  j #\  PC P#7 APPENDIX B ׃  jX 2 Getting Ready to Run ׃ #p\  PCP#  a  B.1 Changing wvsreader.sav  #o\  PCcXP# The file 'wvsreader.sav' (Fig. B1) 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. @ ddx#x ddxx @     -99 L L %,3TT:Bthreshold 1 L L %,3TT:Bstarting vol scan number /dev/rmt0 L L %,3TT:Btape path & device name 1 L L %,3TT:Breflectivity 1-generate 1 L L %,3TT:Bvelocity 0-don't gen 1 L L %,3TT:Bspectrum width 1 L L %,3TT:Bcomposite reflectivity 99.0 L L %,3TT:Bmaximum elevation /data/ L L %,3TT:Bdirectory path & name   X 7 Figure B1 ă  X Line 1 ` `  Threshold If reflectivity values are less than this number, the velocity and spectrum width values are set to missing.(#`  XR 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).(#`  X Line 3 ` `  Tape device The tape device path and tape device name are specified here (e.g. /dev/rmt0).(#`  X" 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 notl&0*<(<( wanted, not generating it will save space on the disk.(#`  X 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.(#`  X_ 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.(#`  X 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.(#`  XK Line 8 ` `  Maximum elevation This is the maximum elevation for which images will be generated.(#`  X 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 '/').(#`  a #p\  PCP# B.2 WVS Display User Preferences and Defaults  #o\  PCcXP# 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.  X*  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 B2). #0*<(<( @ ddxx ddxx @   /* * 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 */  Xh 7 Figure B1 ă  X:  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. 0*<(<( !**************************************************************************** ! These are the user preferences !**************************************************************************** ! !range rings center offset in grid units (Km) ! wvsdisp.rangeRingOffsetX:*hh29@ppG0 wvsdisp.rangeRingOffsetY:*hh29@ppG0 ! ! range ring frequency (in grid units) ! wvsdisp.rangeRingFrequency:hh29@ppG50000 ! ! Time interval for Auto Update - this is the initial setting only, ! the time interval can also be changed interactively in the program. ! wvsdisp.updateInterval:*hh29@ppG1 !**************************************************************************** ! These are the application defaults !**************************************************************************** ! ! Control Panel geometry: WIDTHxHEIGHT ! wvsdisp.geometry: #*hh29@ppG340x400 ! ! Default background and foreground ! wvsdisp.*.background:*hh29@ppGLightGrey wvsdisp.*.foreground:*hh29@ppGBlack ! ! Overlay font and color ! wvsdisp.overlayFont: #*hh29*-courier-bold-r-normal--14-*-iso8859-1 wvsdisp.overlayColor:*hh29@ppGNavyBlue wvsdisp.MainWindow.width:hh29@ppG335 wvsdisp.MainWindow.MenuBar.*.MenuLabel.fontList:ppGN\ ` `  #*hh29-*-Helvetica-Bold-r-*-14-*-* wvsdisp.MainWindow.MenuBar.*.Label.fontList:@\ ` `  #*hh29-*-Helvetica-Bold-r-*-14-*-* wvsdisp.*.MainWindow.scrollBarPlacement:@ppGBOTTOM_RIGHT wvsdisp.*.VolScanText.background:9@ppGBlack wvsdisp.*.VolScanText.foreground:hh29@ppGWhite wvsdisp.*.VolScanLabel.fontList:hh29-*-New Century Schoolbook-Bold-r-*-14-*-* wvsdisp.*.VolScanText.fontList:hh29-*-New Century Schoolbook-Bold-r-*-14-*-* wvsdisp.*.ControlBoxSeparator.width:9@ppG335 wvsdisp.*.ControlBoxSeparator.height:9@ppG5 wvsdisp.*.ControlBoxSeparator.shadowThickness:@ppG5 wvsdisp.*.ControlBoxSeparator.separatorType:@ppGSHADOW_ETCHED_IN wvsdisp.*.VolSweepText.width:hh29@ppG335 wvsdisp.*.VolSweepText.fontList:hh29-*-New Century Schoolbook-Bold-r-*-14-*-* wvsdisp.*.DisplayCheckBox.selectColor:9@ppGRed wvsdisp.*.DisplayCheckBox.topOffset:9@ppG0 wvsdisp.*.DisplayCheckBox.leftAttachment:@ppGATTACH_FORM wvsdisp.*.DisplayCheckBox.fontList:9-*-New Century Schoolbook-Bold-r-*-14-*-* wvsdisp.*.DisplayOptionBox.width:hh29@ppG320 wvsdisp.*.DisplayOptionBox.leftAttachment:@ppGATTACH_POSITION wvsdisp.*.DisplayOptionBox.leftOffset:9@ppG15 wvsdisp.*.DisplayOptionBox.fontList:9-*-New Century Schoolbook-Regular-r-*-14-*-* wvsdisp.*.DisplayOptions.width:hh29@ppG320 wvsdisp.*.DisplayOptions.selectColor:9@ppGRed wvsdisp.*.DisplayOptions.leftAttachment:9@ppGATTACH_POSITION wvsdisp.*.DisplayOptions.leftOffset:9@ppG15 wvsdisp.*.DisplayOptions.fontList:hh29-*-New Century Schoolbook-Bold-r-*-10-*-* GraphicShell.*.background:*hh29@ppGBlack GraphicShell.*.foreground:*hh29@ppGWhite wvsdisp.*.Information.textFontList:hh29*-helvetica-bold-r-*-14-*-iso8859-1 wvsdisp.*.Information.labelFontList:9*-helvetica-bold-r-*-14-*-iso8859-1 wvsdisp.*.Information.buttonFontList:9*-helvetica-bold-r-*-14-*-iso8859-1|'0*<(<(  j #\  PC P#7 APPENDIX C ׃  jX 3 City Locations File ׃ #p\  PCP#  a  C.1 Creating a Text Overlay File  #o\  PCcXP# 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.  XF 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,&0*<(<( 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. h$0*<(<(  j #\  PC P#7 APPENDIX D ׃  jX 4 Advanced Features ׃ #p\  PCP#  a  D.1 Simplified Startup  #o\  PCcXP# 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 startup process a little easier, the shell 'WVS' has been included for your use. To start the display program using this shell:  X  1.X WVS directory port hostname(#  X Xdirectory #the path where the data files are stored. NOTE: the path must have a slash on the end. (e.g. "/scratch/data/")(#  X XportX` ` X #some number > 21000 and < 99999.(#  X} Xhostname #the name of the workstation where the program is being run.(#  a: #p\  PCP# D.2 Running on Multiple Workstations  #o\  PCcXP# 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.Xwvsreader must be run on the workstation where the data will reside.(# 2.XStart WVSSERVER on the workstation which contains the data. The correct directory and port number must be specified.(# 3.XStart 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.(#&0*<(<(Ԍ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.  a #p\  PCP# D.3 Advanced Compilation  #o\  PCcXP# 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  X the level II reader portion of WVS. To make wvsdisp, type make wvsdisp. To make wvsserv,  X type make wvsserv. To make wvsreader, type make wvsreader.