home *** CD-ROM | disk | FTP | other *** search
/ Between Heaven & Hell 2 / BetweenHeavenHell.cdr / 100 / 31 / weather.doc < prev    next >
Text File  |  1985-04-19  |  6KB  |  141 lines
  1. *******************************************************************************
  2. *                                                                             *
  3. *                     WEATHER RECORDS AND STATISTICS PROGRAM                  *
  4. *                                  Version 1.1                                *
  5. *                                                                             *
  6. *                            Public-Domain Software                           *
  7. *                To Display Records Stored in a Weather Database              *
  8. *                  And Statistics Calculated from the Database                *
  9. *                                                                             *
  10. *                         For the IBM Personal Computer                       *
  11. *                                                                             *
  12. *******************************************************************************
  13.  
  14.  
  15.                                     The Files
  16.                                     ---------
  17.  
  18. WEATHER consists of three files:
  19.  
  20.      WEATHER.EXE   the executable file
  21.      WEATHER.DAT   a sample weather database
  22.      WEATHER.DOC   this documentation file
  23.  
  24.  
  25.  
  26.                                     The Menu
  27.                                     --------
  28.  
  29. WEATHER displays or prints records stored in the database or statistics
  30. calculated from the database.  The options menu is as follows:
  31.  
  32.      (1) Display or print weather records
  33.      (2) Display or print weather statistics
  34.      (3) Exit
  35.  
  36. If option 1 or 2 is selected, the following information is prompted for:
  37.  
  38.      Input starting date (YY-MM-DD)
  39.      Input ending date (YY-MM-DD)
  40.      Input city location (10 letters maximum)
  41.      Input state location (2-letter state code)
  42.      Printout also (yes/NO)
  43.  
  44. As the date is searched in ASCII order, only YY or YY-MM need be entered, if
  45. a year or year-month combination is desired.  However, zeros must be entered
  46. (e.g., 03-04-85).  A carriage return at the "Input starting date" prompt
  47. returns to the options menu.  The printout default is "no" (display only).
  48.  
  49. If option 1 has been selected, the following fields are then displayed or
  50. printed from the database for each record between the starting and ending
  51. dates:
  52.  
  53.      Date
  54.      Low Temperature
  55.      Time of Low Temperature
  56.      High Temperature       
  57.      Time of High Temperature  
  58.      Atmospheric Pressure
  59.      Rainfall
  60.  
  61. If option 2 has been selected, the following statistics are then calculated and
  62. displayed or printed from the database for the records between the starting and
  63. ending dates:
  64.  
  65.      Extreme Low Temperature (with date and time of day)
  66.      Extreme High Temperature (with date and time of day)
  67.      Extreme Low Pressure (with date)
  68.      Extreme High Pressure (with date)
  69.      Extreme Low Rainfall (with date)
  70.      Extreme High Rainfall (with date)
  71.      Average Low Temperature (with average time of day)
  72.      Average High Temperature (with average time of day)
  73.      Average Atmospheric Pressure
  74.      Average Rainfall
  75.      Total Rainfall
  76.  
  77.  
  78.                               The Weather Database
  79.                               --------------------
  80.  
  81. WEATHER.DAT, consisting of data for Hayward, California, is supplied as a
  82. sample to demonstrate the format for entering data into the database.  This
  83. file is a standard ASCII file that may be listed using the PC DOS "TYPE"
  84. command.
  85.  
  86. After the file's format is inspected, and the program has been run to observe
  87. its operation, WEATHER.DAT should be renamed (to preserve it), and a new
  88. WEATHER.DAT file should be entered on a daily basis.  The program recognizes
  89. only WEATHER.DAT as the filename of the weather database which it reads.
  90.  
  91. As WEATHER.DAT must a standard ASCII file, it may be entered using EDLINE (the
  92. PC DOS line editor), WordStar's non-document mode, or any other editor that
  93. produces a standard ASCII file.  The following requirements for entry should be
  94. particularly noted:
  95.  
  96.      * Records must be entered serially, earliest date first, in exactly the
  97.        same format as the sample file with respect to spacing, punctuation,
  98.        etc.
  99.  
  100.      * The abbreviation "n/a" stands for "not available" and must be entered
  101.        when a datum is unrecorded.
  102.  
  103.      * Extra spaces must not be entered at the end of a line before the
  104.        carriage return, nor should any blank lines exist at the end of the file
  105.        after the carriage return at the end of the last line of data.
  106.  
  107. Because of the constraints of the compiler, the database is limited to a
  108. maximum of 1096 records (three years' worth).
  109.  
  110.  
  111.  
  112.                                  The Units Used
  113.                                  --------------
  114.  
  115. All data are stored, displayed, and printed in the American National Standards
  116. Institute (ANSI)- and International Standards Organization (ISO)-recommended SI
  117. metric system units, which have also been approved by the National Weather
  118. Service.  The units are as follows:
  119.  
  120.      Dates:  YY-MM-DD format
  121.      Times:  HH:MM format using a 24-hour clock
  122.      Temperatures:  degrees Celsius (to one decimal place)
  123.      Pressures:  kilopascals (to three decimal places)
  124.      Rainfall:  millimetres (to one decimal place)
  125.  
  126. In cases where instruments are being used that do not record in SI metric
  127. units, readings must be converted to SI metric units before being entered into
  128. the database.  The conversion formulae are as follows:
  129.  
  130.      Degrees Fahrenheit to Degrees Celsius:  (X-32)*5/9
  131.      Millibars to Kilopascals:  X/10
  132.      Inches of Mercury to Kilopascals:  X*3.386389
  133.      Inches to Millimetres:  X*25.4
  134.  
  135.  
  136.  
  137.                                        Martin E. Morrison
  138.                                        136 Loma Verde Drive
  139.                                        Hayward, CA 94541-1368
  140.                                        415-278-8458
  141.