home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / GENERAL / WXVIE25B.ZIP / WXVIEW.DOC < prev    next >
Text File  |  1993-10-21  |  45KB  |  986 lines

  1.                         W e a t h e r V i e w
  2.                             Version 2.5b
  3.                    (c) Copyright 1993 Jim Haywood
  4.                                   
  5.  
  6. NOTICE TO REGISTERED USERS: 
  7.  
  8. BE SURE THAT THE FILE 'WXVIEW.KEY' FOUND ON YOUR REGISTRATION DISK IS
  9. LOCATED ON YOUR WORKING DIRECTORY FOR ALL UPDATES.  OTHERWISE WXVIEW
  10. WILL ASSUME THIS IS A DEMONSTRATION VERSION AND HAVE LIMITED GRAPHICS
  11. (OTHER THAN THE DEMO DATA SET).  
  12.  
  13.  
  14. NOTICE TO ALL USERS:
  15.  
  16. UPGRADE FROM VERSION 2.5a TO 2.5b INCLUDES:
  17.  
  18.      ·    COMMAND LINE ENTRY OF RAW DATA FILE TO AUTOMATICALLY REFORMAT
  19.           RAW DATA AND GRID PRESSURE
  20.  
  21.      ·    RETAINS LAST ZOOM BOX SIZE AND LOCATION WHEN RE-STARTING
  22.           WXVIEW
  23.  
  24.      ·    REMEMBERS CURRENT DISPLAY PARAMETER BETWEEN ZOOM UP AND DOWN
  25.  
  26.      ·    PROVIDE STATION ID WITH DATA IN ZOOM DISPLAY
  27.  
  28.  
  29. 1.0 WHAT IS WEATHERVIEW?
  30.  
  31. WeatherView was written to provide anyone with a MS-DOS based personal
  32. computer and a modem the ability to view and analyze real-time National
  33. Weather Service (NWS) hourly data.  WeatherView is offered as a
  34. shareware program therefore registration cost is held to a minimum. 
  35. This program rivals or beats expensive commercial programs and other
  36. shareware programs designed for non-technical weather surface
  37. depiction.  Without the coded 'key' file provided to registered users,
  38. the program will be a demonstration version and allow any user to 'kick
  39. the tires' before expending any hard earned cash.  The demo version
  40. will work 100% with the supplied demo data set but have limited
  41. graphics with user supplied NWS data.  
  42.  
  43. Minimum computer hardware required to operate WeatherView:
  44.  
  45.           MS-DOS Environment
  46.           512K or more available memory
  47.           EGA video (minimum)
  48.           80286 Processor Minimum (80386 or better recommended)
  49.           Math Coprocessor not necessary but highly recommended
  50.  
  51. Running WeatherView is as easy as 1,2,3:
  52.  
  53.      1)   Download NWS data
  54.      2)   Reformat NWS data to column oriented format
  55.      3)   Graphically display weather or search station data by event
  56.  
  57. Specific capabilities of the WeatherView program include:
  58.  
  59.      o    Format raw NWS surface airways (SA) data and digital radar
  60.           (SD) data to a column oriented format;
  61.  
  62.      o    Graphically display the following data in national or zoom
  63.           mode:
  64.  
  65.                -    Current observations
  66.                -    Cloud cover and base height
  67.                -    Visibility in statute miles
  68.                -    Pressure (with optional isobar plot)
  69.                -    Temperature
  70.                -    Dew point
  71.                -    Wind direction and speed flags
  72.                -    Digital radar map
  73.                -    Available NWS cities
  74.                -    Relative humidity
  75.                -    Wind chill
  76.                -    Apparent temperature (heat index)
  77.  
  78.      o    NWS data can be searched and displayed in common,
  79.           understandable text by the following criteria:
  80.  
  81.                -    Search by city name or NWS code
  82.                -    Search by state
  83.                -    Search for extremes in data set
  84.                -    Search by following precipitation types:
  85.  
  86.                          Rain
  87.                          Drizzle
  88.                          Snow                     
  89.                          Thunderstorm
  90.                          Ice
  91.                          Freezing precipitation
  92.                          Hail
  93.  
  94.                -    Search for temperatures greater than
  95.                -    Search for temperature less than
  96.  
  97.           User configuration allows user to search U.S. data only or
  98.           search both U.S. and Canadian data.
  99.  
  100.      o    Program can be user configured with the following options:
  101.  
  102.                -    Define parameter to overlay pressure isobar
  103.  
  104.                -    User choice for map parameter colors
  105.  
  106.                -    Include or exclude Canadian data in searches
  107.                -    Specify isobar smoothing passes (minimum of 1,
  108.                     maximum of 3)
  109.                -    Specify isobar spacing in zoom window (minimum of
  110.                     1, maximum of 4)
  111.                -    Toggle on/off 3-D shadowing
  112.                -    Define time zone 
  113.                -    Define text editor to correct faulty data (public
  114.                     domain editor provided with WeatherView)
  115.  
  116.      o    Ability to archive and retrieve data sets 
  117.  
  118. Each of these options will be detailed in following sections along with
  119. typical benchmark time tests from various machines.
  120.  
  121. THE CATCH: The user has to provide his/her own NWS data.  In this
  122. modern age of data at your fingertips, this is not a problem unless you
  123. don't have a modem.  The three cheapest sources of NWS hourly data I've
  124. found and used are:
  125.  
  126.           -    Compuserve ($8.95 per month for basic service)
  127.           -    Weathermation (free locally if available)
  128.           -    GTE Contel DUAT (free 800 number)
  129.  
  130.  
  131. 2.0 THE HISTORY OF WEATHERVIEW
  132.  
  133. As a Penn State graduate (Meteorology 1979) and professional
  134. meteorologist working in the field of industrial air pollution, I have
  135. missed working with forecasting and observation (the first love of all
  136. meteorologists).  As such, WeatherView was born in 1986 as a BASIC
  137. program which reformatted NWS surface airways (SA) data and plotted the
  138. basic parameters on rough regional maps.  With the desire to expand
  139. capabilities and increase speed, the BASIC program was scrapped and re-
  140. written in a combination of Microsoft Quick C and Microsoft Assembler. 
  141. Originally intended for my own self-gratification as a meteorological
  142. hobby, I shared it with friends in the NWS and various state
  143. Departments of Natural Resources with whom I associate.  Through their
  144. encouragement and the fact that there are few comparable shareware
  145. programs, it is now released as a low cost program to hobbyist who also
  146. love having up-to-the-minute weather access.
  147.  
  148. 3.0 RETRIEVING THE NWS DATA SET
  149.  
  150. I am assuming that the user has a modem and is familiar with the fine
  151. art of telecommunications and text data capture.  If this is a false
  152. assumption, the user must learn telecommunications before this program
  153. will be of any use.
  154.  
  155. There are many sources of NWS and Canadian weather data.  As mentioned
  156. in Section 1.0, the three cheapest sources of data I know are:
  157.  
  158.      o    Compuserve - The basic service price of $8.95 per month
  159.           allows unlimited access to NWS hourly surface airways data
  160.           (SA) and digital radar data (SD).  From within Compuserve,
  161.           type GO AWX to get to the aviation weather menu.  This is the
  162.           service I use most frequently.
  163.      o    Weathermation - This is a free dial-in service provided by
  164.           many state's Bureau of Aviation for pilots.  All SA and SD
  165.           data for U.S. and Canada are available.
  166.  
  167.      o    GTE Contel DUAT - This is provided by a toll free number (1-
  168.           800-767-9989).  Although all SA and SD data are available,
  169.           data must be retrieved on a state-by-state basis.  This pilot
  170.           service is also free but the most time consuming service.
  171.  
  172. After getting into your NWS data source, turn on the text capture
  173. ability of your communications program.  By entering a SA or SD
  174. command, hourly data will be displayed and captured to a file on your
  175. local disk.  For example, SA MN,IA,WI will display surface data for
  176. Minnesota, Iowa, and Wisconsin while entering SD MN,IA,WI will display
  177. digital radar for Minnesota, Iowa, and Wisconsin.  Within the
  178. Compuserve database, entering SA US will display data for the entire
  179. U.S.  Entering SA @ALL will trigger all data for all North America. 
  180. Entering SD US will display all digital radar data readings from the
  181. U.S.  
  182.  
  183. I have macros set up within my telecommunications program to specify
  184. the 48 continental states, Canadian border provinces, and U.S. digital
  185. radar.  Use of macros makes data retrieval very easy and quick.
  186.  
  187. The NWS takes SA hourly readings at approximately 5 to 10 minutes
  188. before each hour.  The accumulation of all SA data gives a 'snapshot'
  189. of the weather at that moment in time.  Typically, the SA data is
  190. available for download at 10 to 15 minutes after the hour.  Canadian
  191. data usually is available around half past the hour.
  192.  
  193. The data retrieved in the SA format is interpreted from its raw format
  194. in the following manner.
  195.  
  196. Weather & Visibility Codes         Prefixes        Suffixes
  197. -------------------------         ---------       --------
  198. hAil           drizzLe            Blowing         shoWers
  199. Dust           saNd               freeZing        + heavy
  200. Fog            Rain                               - light
  201. Ground Fog     Snow                               ++ very heavy
  202. Haze           Snow Grains
  203. Ice Crystals   Snow Pellets
  204. Ice Fog        Thunderstorms
  205. Ice Pellets    spraY
  206. smoKe          freeZing Rain
  207.                shoWer
  208.  
  209. Cloud Abbreviations                             Ceiling Prefixes
  210. -------------------------------------           ----------------
  211. CLR       CLEAR: <10% sky cover                   E-Estimated
  212. SCT       SCATTERED: 10-50% sky cover             M-Measured
  213. BKN       BROKEN: 60-90% sky cover                W-Indefinite
  214. OVC       OVERCAST: >90% sky cover                V-Variable
  215. -         THIN (prefix)
  216. X         OBSCURATION: sky obscured
  217. -X        PARTIAL OBSCURATION: sky partially obscured
  218.  
  219.  
  220. SA data Example:
  221.  
  222. LGA SA 1352 15 SCT M25 OVC 1R-F 132/58/56/1815G21/993/R28LVR20
  223.  
  224. LGA      =     LaGuardia  SA=regular hourly Surface observAtion
  225.                [SP=special]
  226. 1352     =     time of observation 13:52 UCT [EDT+5; EST+4]
  227. 15 SCT   =     scattered clouds 1500' above ground(airport) elevation
  228. M25 OVC  =     overcast clouds measured at 2,500 AGL
  229. 1R-F     =     visibility 1 statute mile, with restriction to
  230.                visibility identified as light rain and fog
  231. 132      =     barometric pressure in millibars=1013.2
  232. 58/56    =     temperature / dew point in F
  233. 1815G21  =     wind from 180 degrees magnetic at 15 knots; peak gust 21
  234. R28LRV20 =     runway 28 left visual range 2000 feet
  235.  
  236.  
  237. The data retrieved in the raw SD format is decoded in the following
  238. manner.
  239.  
  240. Format:
  241. Station ID/time/location intensity azimuth and range/movement/
  242. tops/precipitation type-intensity trend/remarks/end
  243.  
  244. Example: NYC 1930 AREA 2 TRW++/+ 297/130 152/115 160W C2620
  245. MT 300 AT 254/39 HAIL REPORTED THIS CELL
  246.  
  247. NYC RADAR 1930 UCT; AREA OF ECHOES 2/10 COVERAGE, VERY HVY
  248. THUNDERSTORMS FROM 297 DEGREES/130 NM TO 152 DEGREES/115 NM; AREA IS
  249. 160NM WIDE;MAX TOP 30,000' AT 245 DEG/39NM; RMKS PLAIN LANGUAGE;
  250.  
  251. Intensity Decoder
  252.  
  253. Level          Echo Intensity      Precip Intsy    Rainfall Rate
  254. -----          --------------      -------------   -------------
  255.   1               Weak             None or light    <.1-.2
  256.   2             Moderate           Moderate          .1-1.1
  257.   3              Strong            Heavy             .5-2.2
  258.   4           Very Strong          Very Heavy       2.2-4.5*
  259.   5              Intense           Intense          4.5-7.1*
  260.   6              Extreme           Extreme          >7.1 in/hr
  261.   *= only in convective situations
  262.   8            Unknown but associated with severe wx
  263.   9            Unknown
  264.  
  265. Abbreviations
  266. -------------
  267. HOOK - signature "tail" usually associated with tornadoes
  268. HAIL - radar indicated hail
  269. LINE - echoes are in a line
  270. LEWP - Line Echo Wave Pattern - wavy line
  271. FNLN - FiNe LiNe; narrow non-precipitation echo pattern
  272. BWER - Bounded Weak Echo Region - echo free vault within a cell
  273. ALFT - precipitation ALoFT
  274. MALF - Mostly ALoFt precipitation
  275. PALF - Partly ALoFt precipitation
  276. MLVL - Melting LeVeL; radar detection of melting of frozen precip
  277. PCLL - Persistent CeLLs
  278. SLD  - SoLiD areas of 80% or more
  279.  
  280. PPINE - equipment normal; No Echoes
  281.    OM - inOp or out of service for Maintenance
  282.    NA - observation Not Available
  283.    NS - equipment normal; No Significant echoes
  284. ROBEPS  Radar Operating BElow Performance Standards
  285. ARNO  - Azimuth Range indicator iNOperative
  286. RHINO - Radar Height Indicator iNOperative      
  287.  
  288. Note: above SA and SD decoding information was taken from the
  289. Compuserve file WXDECO.TXT.
  290.  
  291. The NWS radar stations take the SD digital radar reading at
  292. approximately 25 minutes past the hour.  It is usually available for
  293. download at 45 minutes after the hour.
  294.  
  295. The provided file 'DEMO.DAT' is a demonstration file of a Compuserve
  296. data download session which captured the 48 continental states,
  297. Canadian border provinces, and U.S digital radar.  THE PROVIDED
  298. DEMONSTRATION DATA FILE 'DATA.DAT' IS ENCODED TO WORK 100% WITH
  299. WEATHERVIEW V2.5b.  DATA DOWNLOADED BY THE USER WILL HAVE GRAPHIC
  300. CAPABILITIES LIMITED TO 50% OF USER THE SUPPLIED DATA WITH NO ZOOM OR
  301. PRESSURE ISOBARS.
  302.  
  303. 4.0 RUNNING WEATHERVIEW
  304.  
  305. Simply enter the command "WXVIEW" (or WXVIEW 'raw filename') to begin
  306. the program.  Entering the raw data file on the command line will
  307. automatically reformat the raw data then grids the pressure data after
  308. 10 seconds or after the user presses a key.  The following files must
  309. be present in the local directory for WeatherView to run properly:
  310.  
  311.  
  312.      WXVIEW.EXE -   Executable program file
  313.      WXVIEW.FIG -   Configuration file (Demo version)
  314.      WXCITY.NAM -   Available station names and NWS codes
  315.      WXNATL.CRD -   Station coordinates for national map
  316.      WXNATL.BIN -   National map file (binary format)
  317.      WXZOOM.CRD -   Station coordinates for zoom map
  318.      WXZOOM.BIN -   Zoom map file (binary format)
  319.      WXRADAR.CRD -  Station coordinates for digital radar
  320.      WXVIEW.SA -    Current formatted SA surface data set
  321.      WXVIEW.SD -    Current formatted SD radar data set
  322.  
  323. Other files included but not critical to the program operation are:
  324.  
  325.      WXVIEW.PRS -   Current isobar grid array
  326.      WXVIEW.DOC -   Documentation file (what you are reading)
  327.      TED3.COM -     Public domain text editor.  May be substituted for
  328.                     user's choice editor in program configuration
  329.                     option.
  330.      DEMO.DAT -     Demonstration raw data which is encoded to be 100%
  331.                     operational for demonstration purposes. 
  332.                     WXVIEW.SA, WXVIEW.SD and WXVIEW.PRS bundled with
  333.                     the program were generated by formatting this demo
  334.                     data set.  User supplied data will have limited
  335.                     use in the graphic display section.
  336.      REGISTER.TXT - Registration information.
  337.      READ.ME -      Any upgrade information.
  338.      ZOOMBOX.POS -  Last size and location of the zoom box.
  339.  
  340.  
  341.      STATION.EXE -  Stand-alone utility program for adding or deleting
  342.                     stations from graphic display maps.
  343.      STATION.DOC -  Documentation for STATION.EXE 
  344.  
  345. Provided to Registered Users only...
  346.  
  347.      WXVIEW.KEY -   Encoded key file which unlocks WeatherView for
  348.                     100% usage.  This file must be present in the
  349.                     working directory otherwise, WeatherView assumes
  350.                     you are a demo user and will have limited graphics
  351.                     other than provided by the demo data.  This way,
  352.                     upgrades can be quickly and easily provided to
  353.                     registered users on Compuserve and other BBS's
  354.                     while other users will have a new demo to test. 
  355.                     This file must not be modify or corrupted in any
  356.                     way.
  357.  
  358. After entering the WXVIEW command, the WeatherView program will present
  359. a title screen while loading configuration.  During configuration
  360. loading, the program loads all city names, coordinates, and user
  361. configuration data into memory.  Time to load varies with the type of
  362. computer used.  Typical loading times are as follows:
  363.  
  364. 8Mhz 286 w/coprocessor   25 Mhz 386 wo/coprocessor     25 Mhz 486
  365.  
  366.      7 sec                         2 sec                  1 sec
  367.  
  368.  
  369. Use the cursor keys to highlight the desired choice and then press
  370. enter key.
  371.  
  372. 4.1 Reformatting NWS data set
  373.  
  374. THIS OPTION MUST BE PERFORMED BEFORE WXVIEW CAN GRAPHICALLY VIEW OR
  375. SEARCH ANY USER PROVIDED NWS DATA.
  376.  
  377. To analyze or display the NWS data in the fastest, most efficient
  378. method, the rough format of the SA and SD raw data is formatted to a
  379. column oriented format.  This format is easily readable by the
  380. WeatherView program and any other database management program requiring
  381. column oriented text data.  The data is formatted into the following
  382. format:
  383.  
  384. Parameter                          Start column   Stop column
  385.  
  386. NWS city code                            1              3
  387. Greenwich mean time                      5              8
  388. Current weather                         10             17
  389. Visibility (Statute miles)              18             21
  390. Abbreviated pressure (millibars)        24             26
  391. Temperature (Degrees Fahrenheit)        28             30
  392. Dew Point (Degrees Fahrenheit)          32             34
  393. Wind direction/Wind speed (Deg/Knots)   37             40
  394. Abbreviated altimeter (inches)          42             44
  395. Cloud cover                             47             80
  396.  
  397.  
  398. This option reads ALL valid NWS/Canadian SA/SP/RS data, formats it and
  399. stores the results in a temporary file.  An on-screen counter informs
  400. the user of how many observations are being formatted.  During the
  401. formatting step, WeatherView determines which hour has the most
  402. observations.  The temporary file is re-read and ONLY observations for
  403. that hour are written to the final file (WXVIEW.SA).  An on-screen
  404. counter keeps track of how many observations are written to the final
  405. file.  If several observations are reported for a single station during
  406. the same hour, WeatherView accepts the first observation in the raw NWS
  407. data file and ignores the rest.  
  408.  
  409. A vigorous error screening protocol is applied to the final WXVIEW.SA
  410. data set.  If WeatherView suspects an error in a station observation
  411. for the valid hour, that observation is rejected and written to an
  412. alternate file named BAD.OUT.  The user may wish to review this file
  413. and apply corrections if desired.  The user is prompted to press a key
  414. after the SA data set is processed.  A similar process to format the SD
  415. digital radar set follows.  
  416.  
  417. The internal computer system date is used to date stamp the formatted
  418. WXVIEW.SA file.  The observation date and Greenwich mean time make up
  419. the first line of WXVIEW.SA and WXVIEW.SD.
  420.  
  421. Formatting a NWS data set need not be repeated until a NEW data set is
  422. downloaded.
  423.  
  424. Typical times to reformat SA and SD data from the 48 states and 9
  425. Canadian border provinces are:
  426.  
  427. 8Mhz 286 w/coprocessor   25 Mhz 386 wo/coprocessor     25 Mhz 486
  428.  
  429.      1 min 34 sec                  20 sec                15 sec
  430.  
  431.  
  432. The user is recommended to download both the SA and SD data into the
  433. same file.  However, if the user wishes to download just the SA or just
  434. the SD data, WeatherView will preserve the last formatted session of
  435. the non-downloaded parameter.
  436.  
  437. Please note that temperature and dew point in the downloaded Canadian
  438. weather data are in degrees Celsius.  These data are converted into
  439. degrees Fahrenheit in all WeatherView displays and text searches.  
  440. Also note that ALL NWS/Canadian wind speeds are in knots.  All wind
  441. speeds are converted to miles per hour (mph) for graphic wind staff
  442. displays and text searches.
  443.  
  444. 4.2 View the Graphic Data Set
  445.  
  446. For demo users, the WeatherView program works 100% with the provided
  447. demo data set.  HOWEVER, FOR USER SUPPLIED DATA, GRAPHIC DISPLAY
  448. OPTIONS ARE LIMITED TO 50% OF USER SUPPLIED DATA WITH NO ZOOM OR
  449. PRESSURE ISOBAR CAPABILITY.
  450.  
  451. This is the only limitation between the demo version and the registered
  452. version.  Only registered users receive the 'WXVIEW.KEY' file which
  453. unlocks the fully functional program.  
  454.  
  455. When chosen, this option graphically displays the last formatted or
  456. retrieved data set.  WeatherView will take a few seconds (depending on
  457. machine speed) to load applicable station data into memory.  Expected
  458. times to load the national data set are as follows:
  459.  
  460. 8Mhz 286 w/coprocessor   25 Mhz 386 wo/coprocessor     25 Mhz 486
  461.  
  462.        20 sec                      4 sec                 2 sec
  463.  
  464. The national data array is loaded into memory only once per session
  465. unless the current data set is edited or a new data set is loaded.
  466.  
  467. If this is a NEW data set or an EDITED data set, WeatherView will
  468. attempt to grid pressure data for isobar plotting.  The grid array
  469. contains 31 x 26 grid points.  Depending on the type of machine used
  470. and whether or not a math coprocessor is used, this can be a time
  471. consuming ordeal.  Expected times are as follows:
  472.  
  473. 8Mhz 286 w/coprocessor   25 Mhz 386 wo/coprocessor     25 Mhz 486
  474.  
  475.      1 min 57 sec             1 min 31 sec               10 sec
  476.  
  477.  
  478. The isobar plotting option can be aborted by pressing the escape (ESC)
  479. key.  Smoothing passes to 'iron out' the rough edges of the isobar
  480. plots are determined in the user configuration section.  Gridding needs
  481. to be done only once per data set unless the user edits the formatted
  482. data file.  If reviewing previously gridded data, isobar gridding will
  483. not be redone.  Note: if there is less than 100 stations in the SA data
  484. array, WeatherView will NOT grid data or plot isobars due to
  485. insufficient data.
  486.  
  487. After the pressure gridding routine is completed, aborted, or skipped
  488. (if previously gridded), WeatherView displays the national weather map
  489. with current observations and the first menu bar.  The two menu bars
  490. are toggled by the  (up) and  (down) cursor keys.  Any menu option
  491. can be chosen by moving the cursor and pressing enter or instantly
  492. chosen by pressing the displayed 'hot key' for that option.
  493.  
  494. Menu Bar 1 options:
  495.  
  496.      OBS -     Current weather in the same code as provided in the raw
  497.                NWS data set.
  498.  
  499.      SKY -     Cloud cover.  Clear circle indicates clear skies.  Blue
  500.                in upper right quadrant indicates scattered cloud cover. 
  501.                Orange covering 2/3 of circle indicates broken cloud
  502.                cover.  Dull white in all or part of circle indicates
  503.                overcast. Combinations of cloud covers can occur. 
  504.                Number appearing below circle for broken and/or overcast
  505.                skies is cloud base in hundreds of feet (i.e. 250
  506.                implies cloud base at 25,000 ft).  Circle with an 'X'
  507.                indicate obscured sky.
  508.  
  509.      VIS -     Visibility in statute miles.  Fractional distances are
  510.                interpreted in the following manner: 11/2 indicates 1
  511.                and 1/2 statute miles.
  512.  
  513.      PRESS -   Pressure in millibars.  If pressure gridding was
  514.                completed for a data set, isobars are drawn.  National
  515.                map isobars are spaced four millibars apart (ranging
  516.                from 952 to 1056).  The user can change the isobar
  517.                spacing in the zoom display window via the configuration
  518.                menu.  
  519.  
  520.                The default pressure screen overlay is numeric pressure
  521.                in millibars but can be temporarily changed in the
  522.                configuration option.  Highs and lows are calculated
  523.                from the pressure grid and displayed.  Positioning of
  524.                the highs and lows are approximate due to grid spacing. 
  525.                The best way to identify the EXACT position of a low
  526.                pressure system is to check the wind field.  If the
  527.                isobar gridding option was aborted, only numeric
  528.                pressure in millibars is displayed.
  529.  
  530.                When displaying the isobar plot on the national map,
  531.                isobars are 'flashed' off the Atlantic, Pacific, and
  532.                Mexican areas.  No stations are plotted for these areas
  533.                so isobar gridding is erratic and unrepresentative.
  534.  
  535.      TEMP -    Temperature in degrees Fahrenheit.  Color of temperature
  536.                display changes every 10 degrees to provide quick color
  537.                overview of the temperature pattern.
  538.  
  539.      DEW -     Dew point in degrees Fahrenheit.  Color of dew point
  540.                display changes every 10 degrees to provide quick color
  541.                overview of the dew point pattern.
  542.  
  543.      WIND -    Wind direction and wind speed are graphically displayed
  544.                as wind flags similar to those found on NWS maps.  The
  545.                flags can be thought of as arrows pointing in the
  546.                direction the wind is blowing toward.  Each full barb on
  547.                the wind flag represents 10 mph of wind speed (there is
  548.                a conversion in the wind data from knots to mph, 1 knot
  549.                equals 1.15 mph).  With limited pressure grid spacing,
  550.                the wind field is the best way to locate the center of
  551.                a low pressure system.  A strong low, in a field of wind
  552.                flags, can resemble water going down the drain.  At the
  553.                center of the swirl is the low.
  554.  
  555.      RADAR -   Digital radar.  Color indicates precipitation intensity
  556.                as shown on top of screen bar.  User will need to press
  557.                any key after viewing to return to primary menu bar. 
  558.                Digital radar data can overlap if reporting radar
  559.                stations are in close proximity to each other.  
  560.  
  561.                Since SD radar readings occur approximately 30 minutes
  562.                after the SA surface observation, radar and current
  563.                weather may not always agree.
  564.  
  565.      CITY -    Display all available NWS and Canadian stations
  566.                available for graphic display.
  567.  
  568.      EXIT -    Return to previous menu.
  569.  
  570.  
  571. Menu Bar 2 options:
  572.  
  573.      ZOOM -    Available from national map only.  Zoom box appears in
  574.                center of U.S. map.  Move box in straight line or
  575.                diagonally with cursor keys to desired zooming location. 
  576.                Press enter key.  WeatherView will take a few seconds
  577.                (about the same time it takes to load the national map)
  578.                to load data from the zoom area stations into memory. 
  579.                All available NWS and Canadian stations are displayed in
  580.                the zoom mode to provide better resolution of the
  581.                mesoscale/microscale weather picture.
  582.  
  583.                The first zoom box shown is the maximum size of the zoom
  584.                window.  By pressing the keypad minus key (-) or the
  585.                keypad plus key (+), the zoom window size can be
  586.                adjusted.
  587.  
  588.      GROUP -   Available from the zoom map only.  This option is for
  589.                those who want it all on one screen.  All reported
  590.                parameters in the SA data set are reported on one
  591.                screen.  The format of the layout for each station is as
  592.                follows:
  593.  
  594.                          (temp)       (pressure (abbreviated))
  595.               (current weather) (sky) (visibility (miles))
  596.                        (dew pt)       (cloud base (hundreds of ft))
  597.  
  598.  
  599.      RELATIVE
  600.      HUMIDITY- Relative Humidity in percent.  Color of percentage
  601.                changes every 10 degrees to provide quick color overview
  602.                of the relative humidity pattern.
  603.  
  604.      WIND
  605.      CHILL -   Wind chill temperature in degrees Fahrenheit.  Color of
  606.                wind chill temperature changes every 10 degrees to
  607.                provide quick color overview the wind chill temperature
  608.                pattern.  Wind chill is NOT calculated if wind speed is
  609.                3 mph or less.  Wind chill is also NOT calculated when
  610.                ambient temperature is 60 degrees or greater.  
  611.  
  612.                Algorithms to calculate the relative humidity and wind
  613.                chill were gratefully received from Mr. Dan Noah of the
  614.                Madison, WI National Weather Service.
  615.  
  616.      APPARENT
  617.      TEMP. -   Apparent temperature in degrees Fahrenheit.  The NWS has
  618.                adopted the apparent temperature index (heat index) as
  619.                a summertime measure of sultriness.  Color of apparent
  620.                temperature changes every 10 degrees to provide quick
  621.                color overview the apparent temperature pattern. 
  622.                Apparent temperatures are NOT calculated when ambient
  623.                temperature is less than 60 degrees.  
  624.  
  625.                The algorithm for the apparent temperature calculation
  626.                was obtained from the August 1985 Weatherwise magazine.
  627.  
  628. Pressing the escape (ESC) key or pressing the 'E' key will return the
  629. user to the previous menu.
  630.  
  631. GRAPHIC SCREEN DUMPS TO PRINTER AFTER USING <F1> KEY COLOR TOGGLE:
  632. Since many screen dump utilities are readily available from MS-DOS or
  633. other third-party softwares, WeatherView does not provide a print
  634. routine.  Third-party programs of this type can usually be found on
  635. your local BBS.  These programs work best when graphics are shown in
  636. black and white.  The user can toggle graphic colors on/off with the
  637. <F1> key to serve this purpose.  For version 2.5b, set screen type to
  638. EGA.  Use the DOS graphics screen print utility of check your local BBS
  639. for screen dump utility programs.
  640.  
  641. 4.3 WEATHER EVENT SEARCH
  642.  
  643. This section of the WeatherView program allows the user to search the
  644. weather data by several criteria and receive an expanded version of
  645. station data in easy to read text.  Matches to the search criteria are
  646. displayed in half screen segments while prompting the user to press a
  647. key to continue.  When the next search match is found, the top screen
  648. information is scrolled down to the bottom half screen. 
  649. The user can only search forward through the data (i.e. you can not
  650. back up and review data which have already scrolled of the screen).  
  651.  
  652. The user can break away at any time between search matches by pressing
  653. the escape (ESC) key or the 'E' key.
  654.  
  655. The various search criteria are detailed in the following subsections.
  656.  
  657.      4.3.1 Search by City of NWS Code
  658.  
  659.      The user is prompted for an entry.  For example, if the user
  660.      wishes to review the weather for Nashville, TN (NWS code is BNA),
  661.      the user can type either BNA or an abbreviated part of the name
  662.      'Nashville' (i.e. Nash).  If the user is typing an abbreviated
  663.      portion of the city name, it must be the beginning portion of the
  664.      name.  WeatherView does not perform imbedded text searches.  
  665.  
  666.      User entry can be in either upper or lower case.
  667.  
  668.      All matches fitting the entry will be displayed until no more
  669.      matches are found or the user aborts the search.  If no match is
  670.      found in the city/code database, the user is notified.  If an
  671.      entry match is found in the city/code database but no data is
  672.      found in the current weather file, the user is also notified.  
  673.  
  674.      This option includes data search for Alaska and Hawaii stations. 
  675.      If the user has chosen to allow Canadian data to also be searched
  676.      (in the configuration section), Canadian city/code matches will
  677.      also be displayed.  
  678.  
  679.      4.3.2 Search by State
  680.  
  681.      The user is prompted for a 2 letter state abbreviation.  Entering
  682.      TN will display all matches for the state of Tennessee.  If the
  683.      user has chosen to allow Canadian data to also be searched,
  684.      entering a 2 letter Canadian province will allow the provinces
  685.      data to be displayed (i.e. MB for Manitoba).
  686.  
  687.      User entry can be in either upper or lower case.
  688.  
  689.      4.3.3 Search by Extremes
  690.  
  691.      This option will search the entire database (including or
  692.      excluding Canadian data depending on user configuration) for
  693.      weather extremes and list them on a single screen display. 
  694.      Parameters searched and displayed are: highest temperature, lowest
  695.      temperature, highest wind speed, highest pressure, and lowest
  696.      pressure.  Also displayed are any stations listing heavy
  697.      precipitation.
  698.  
  699.      If more than one station reports the same extreme or heavy
  700.      precipitation, the additional stations are also listed (up to six
  701.      stations).
  702.  
  703.      4.3.4 Search by Precipitation
  704.  
  705.      The user can search the data for stations reporting specific
  706.      precipitation.  The precipitation choices available for search
  707.      are: Rain, Snow, Drizzle, Thunderstorm, Ice, Freezing
  708.      precipitation, and Hail.  If no stations report the searched
  709.      event, the user is returned to the precipitation menu. 
  710.  
  711.      4.3.5 Search for Temperatures Greater Than
  712.  
  713.      WeatherView will search and display all stations reporting a
  714.      temperature greater than or equal to the value entered by the
  715.      user.
  716.  
  717.      4.3.6 Search for Temperatures Less Than
  718.  
  719.      WeatherView will search and display all stations reporting a
  720.      temperature less than the value entered by the user.
  721.  
  722.  
  723. 4.4 SAVE/REVIEW WEATHER DATA
  724.  
  725. Occasionally, a viewed map is special because of some significant
  726. weather event.  The user has the option to save the current map and
  727. retrieve it for later viewing.  The user is prompted to enter 'S' to
  728. save the current file, or 'R' to retrieve an archived file.  If 'S' is
  729. chosen, the user is prompted to enter a filename (without any
  730. extension).  The files saved to disk will be:
  731.  
  732.           filename.SA  - Saved SA data
  733.           filename.SD  - Saved SD digital radar
  734.           filename.PRS - Saved isobar grid (if grid was created)
  735.  
  736. Do not use the name WeatherView to archive because these are reserved
  737. filenames.
  738.  
  739. If retrieving an archived file using the 'R' option, the user is
  740. prompted to enter a filename (without any extension).  If the files do
  741. not exist, the user is notified.  
  742.  
  743. WeatherView does not provide any means to delete archived files or do
  744. a directory search.  The user can easily delete unwanted archive files
  745. from the DOS prompt by entering 'DEL filename.*' (using the correct
  746. filename, of course).
  747.  
  748. 4.5 EDIT CURRENT DATA SET
  749.  
  750. Occasionally bad data gets through the screening routine during the
  751. formatting of raw NWS data.  One of the most frequent I've seen is
  752. faulty pressure data which can result in bizarre isobar plotting.  If
  753. the faulty station can be identified, the user can use this editing
  754. option to correct or delete the faulty data.
  755.  
  756. A public domain text editor has been included with WeatherView to serve
  757. this purpose.  This editor (TED3 for tiny editor version 3.0) is
  758. limited to files less than 64K in size.  To work, the formatted SA data
  759. file, WXVIEW.SA, must be less than 64K.  If you have downloaded just
  760. the 48 states and border provinces of Canada, the formatted WXVIEW.SA
  761. should be less than 64K.  If you have downloaded the entire North
  762. American database (i.e. entered SA @ALL in Compuserve), the formatted
  763. file may be larger than 64K.  
  764.  
  765. After exiting the text editor, the user is prompted whether or not to
  766. re-grid the pressure data when attempting to graphically display data. 
  767. If pressure data has not been changed, there is no need to repeat the
  768. gridding process.  WeatherView will assume some data has been changed
  769. and will re-load the national data array before displaying any maps.
  770.  
  771. The user can opt to substitute his/her own favorite text editor in the
  772. user configuration section.
  773.  
  774. If there is not enough remaining memory to load the text editor or the
  775. WXVIEW.SA is larger than 64K (using the TED3 editor), editing is
  776. aborted and the user is immediately returned to the menu.
  777.  
  778. CAUTION: Do not edit the demonstration file 'DEMO.DAT'.  This file has
  779. been encoded to allow for 100% use in the demonstration version of
  780. WeatherView.  Editing may disrupt the encoding.
  781.  
  782. 4.6 CONFIGURE PROGRAM
  783.  
  784. WeatherView has several user configurable options as detailed in the
  785. following subsections.
  786.  
  787.      4.6.1 Change U.S. Isobar Overlay Option
  788.  
  789.      The default isobar overlay parameter at the beginning of each
  790.      WeatherView session is the numeric pressure in millibars.  At
  791.      times it is interesting to overlay a different parameter on the
  792.      isobar field.  Available overlay parameters are: Wind
  793.      direction/speed flags, cloud cover, temperature, current weather,
  794.      and digital radar.
  795.  
  796.      4.6.2 Change Graphic Display Colors
  797.  
  798.           -    Change Numeric Data Colors: Color changes for each 10
  799.                increments.  The user can change colors by choosing
  800.                numeric increment with menu bar and pressing enter. 
  801.                User is prompted for new color.  Pick new color from
  802.                choices provided at the top of the menu.  Gray is not
  803.                allowed because of conflict with the map gray
  804.                background.
  805.  
  806.           -    Change Observation Data Colors: Color changes for each
  807.                weather observation.  The user can change colors by
  808.                choosing observation with menu bar and pressing enter. 
  809.                User is prompted for new color.  Pick new color from
  810.                choices provided at the top of the menu.  Gray is not
  811.                allowed because of conflict with the map gray
  812.                background.
  813.  
  814.           -    Change Pressure Symbol Colors: Color changes for isobars
  815.                and High/Low pressure symbols.  The user can change
  816.                colors by choosing the correct choice with menu bar and
  817.                pressing enter.  User is prompted for new color.  Pick
  818.                new color from choices provided at the top of the menu. 
  819.                Gray is not allowed because of conflict with the map
  820.                gray background.
  821.  
  822.           -    Change Radar Intensity Colors: Color changes for each
  823.                intensity increments.  The user can change colors by
  824.                choosing intensity increment with menu bar and pressing
  825.                enter.  User is prompted for new color.  Pick new color
  826.                from choices provided at the top of the menu.  Gray is
  827.                not allowed because of conflict with the map gray
  828.                background.
  829.  
  830.      4.6.3 Weather Event Search on US/Canadian Data
  831.  
  832.      The user can choose to include or exclude Canadian data in the
  833.      weather search option.  For example, Canadian data almost always
  834.      generates the low temperature reading during the extremes search. 
  835.      If you don't want to see this, you can switch off Canadian data
  836.      search by toggling this menu option.  Pressing enter when this
  837.      option is highlighted will toggle the choices.
  838.  
  839.      4.6.4 Isobar Grid Screening Passes
  840.  
  841.      The pressure isobar gridding usually produces a rough isobar plot. 
  842.      By sending the pressure grid through a 'smoothing' routine, the
  843.      contours can be somewhat smoothed for a more realistic appearing
  844.      isobar plot.  The user can specify a minimum of one (1) to a
  845.      maximum of three (3) smoothing passes.
  846.  
  847.      If this option is chosen, then WeatherView will attempt to re-grid
  848.      the pressure data when the graphic display option is again chosen.
  849.  
  850.      4.6.5 Isobar Spacing in Zoom Window
  851.  
  852.      Pressure isobar resolution can be increased in the zoom displays
  853.      by decreasing isobar spacing (maximum 4 millibars down to 1
  854.      millibar).  
  855.  
  856.      4.6.6 Toggle 3-D Shadow
  857.  
  858.      The user has the option to view graphically displayed data in a
  859.      simulated 3-D effect.  The 3-D effect appears to have the data
  860.      raised off the screen leaving a shadow.  If this effect is not
  861.      desired, it can be toggled on/off with this option.  Pressing
  862.      enter when this option is highlighted will toggle the choices.
  863.  
  864.      4.6.7 Include City ID With Zoom Data
  865.      The user has the option to include the NWS city code with
  866.      graphically displayed data in the zoom window.  If this effect is
  867.      not desired, it can be toggled on/off with this option.  Pressing
  868.      enter when this option is highlighted will toggle the choices.
  869.  
  870.      4.6.8 Change Time Zone
  871.  
  872.      The graphic maps and search display screen list the local time of
  873.      observation.  The user can change the displayed time zone to match
  874.      the local time zone.  Preprogrammed zones are EST, EDT, CST, CDT,
  875.      MST, MDT, PST, and PDT.  Any other option will result in a prompt
  876.      to enter the number of hours to offset from Greenwich mean time.
  877.  
  878.      4.6.9 Select Text Editor
  879.  
  880.      A public domain text editor has been included with WeatherView to
  881.      serve this purpose.  This editor (TED3 for tiny editor version
  882.      3.0) is limited to files less than 64K in size.  To work, the
  883.      formatted SA data file, WXVIEW.SA, must be less than 64K.  If you
  884.      have downloaded just the 48 states and border provinces of Canada,
  885.      the formatted WXVIEW.SA should be less than 64K.  If you have
  886.      downloaded the entire North American database (i.e. entered SA
  887.      @ALL in Compuserve), the formatted file may be larger than 64K.  
  888.  
  889.      The user can, through this configuration option, choose a
  890.      different text editor other than the TED3 public domain editor
  891.      included with this software.  The user must choose a text editor
  892.      such as QEDIT and not a word processor such as WordPerfect.
  893.  
  894. 4.7 EXIT
  895.  
  896. Every program should have a challenge, therefore, I'll leave this one
  897. for everyone to figure out on their own.
  898.  
  899. 5.0 DISCLAIMER
  900.  
  901. As dictated by current social protocol, I am not responsible for any of
  902. my actions.  Therefore, you (the user) must assume all responsibility
  903. for using this program.  In other words, if you fly your airplane into
  904. the side of a mountain, please don't blame me.  What you see is what
  905. you get with this program.  My personal intent with this program is to
  906. have fun and satisfy my need to keep up with the current weather.  Your
  907. end use with this program is your business.
  908.  
  909. 6.0 OBTAINING A REGISTERED COPY
  910.  
  911. If you a new user testing this as a demo, you are encouraged to share
  912. this demonstration version with your friends and other BBS's.  So as
  913. not to violate the first law of thermodynamics (there is no such thing
  914. as a free lunch), there is a one time registration cost associated with
  915. this program.  All users MUST register if you plan to use this
  916. demonstration program beyond 30 days.  With registration comes the
  917. fully functional version of WeatherView (remember, the demo version has
  918. limited graphic use with user supplied data).  You will also be
  919. registered for all future upgrades found on CompuServe.
  920.  
  921. In the true sense of shareware ideology, registration cost are held at
  922. a minimum to encourage wide use of this program.  To achieve this
  923. objective, documentation is provided ON DISK rather than a printed
  924. copy.  I will assume that if you have a modem, you probably splurged
  925. and bought a printer or, at least, have access to one.
  926.  
  927. After reviewing the demo version, I am sure you will agree that this is
  928. a bargain.  I have not found any similar software (even with less
  929. capabilities) for less.  If you agree and wish to receive a registered
  930. copy, please remit the following:
  931.  
  932.  Cost     $25.00    WeatherView version 2.5b with registered key file
  933.            $4.95    Shipping and handling
  934.           ------
  935.           $29.95    Total (U.S.)
  936.  
  937.  
  938. (Michigan residents please include 4% sales tax for total for $31.15)
  939.  
  940. Please send check or money order (no cash, credit card numbers, or
  941. trading stamps) to:
  942.  
  943.      Jim Haywood
  944.      2157 Forest Hill SE
  945.      Grand Rapids, MI  49546
  946.  
  947. PLEASE NOTE IN YOUR ORDER WHERE YOU OBTAINED YOUR DEMO VERSION OF
  948. WEATHERVIEW!!!!  This information is important for future upgrades.
  949.  
  950. I will send your disk out via the U.S. mail within two days of
  951. receiving your order.  Unless specified to the contrary, all orders
  952. will be provided on a 5.25" diskette.  I will follow up with a
  953. Compuserve notice (if available) to inform you that your disk has been
  954. mailed.
  955.  
  956. Since you will have a chance to completely review all of WeatherView
  957. capabilities with the demo data, you know what you are getting and
  958. there will be NO refunds.
  959.  
  960. If you are a registered user of WeatherView software, THE REGISTERED
  961. VERSION OF WEATHERVIEW FILES ARE NOT TO BE SHARED OR DISTRIBUTED.  I
  962. will trust your conscience and honesty not to share or distribute your
  963. registered copy.  
  964.  
  965. Both registered and demo user should feel free to contact me with any
  966. suggestions or comments through CompuServe, 72247,2072, or the above
  967. address.  
  968.  
  969. 7.0 FUTURE PLANS AFTER VERSION 2.5b
  970.  
  971. Future upgrades to WeatherView as suggested by users at this time will
  972. include:
  973.      o    Add Alaska and Canada maps (priority winter release)
  974.  
  975.      o    Add 4 letter radar site capability
  976.  
  977.      o    Additional digital radar (SD) information (max heights,
  978.           speed, direction, etc) for graphics and data search (priority
  979.           spring release)
  980.  
  981.      o    Increase video resolution option to VGA and SVGA
  982.  
  983.      o    European version of WeatherView
  984.  
  985.      o    Upper air module for FDHI/LO data
  986.