home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / math / whist.zip / WH2DFWD.MAN < prev    next >
Text File  |  1993-06-07  |  12KB  |  288 lines
  1. SHAREWARE ▒ NOT FOR SALE
  2. WHIST, A WEATHER HISTOGRAPH FACILITY
  3. version 3.0, Rev 1.
  4.  
  5. Section û CONTENTS ö Page
  6. A   PURPOSE  ù ><
  7. B   FEATURES ù ><
  8. C   HARDWARE REQUIREMENTS  É ><
  9. D   NON-REQUIREMENTS ô ><
  10. E   LIMITS AND LIMITATIONS É ><
  11. F   PACKING LIST ò ><
  12. G   FILES CREATED DURING INSTALLATION  è ><
  13. H   CREDITS  ù ><
  14. I   VERSION HISTORY  ô ><
  15. J   PLANER 3-D HISTOGRAPHS É ><
  16. K   AUTHOR ÿ ><
  17. _╚ 
  18.  
  19. A) PURPOSE:
  20. =â 
  21. To produce quality graphic representations of high-and-low or
  22. median temperatures for one or more localities.
  23.  
  24. B) FEATURES:
  25. =ä 
  26. Current temperatures are plotted against historical data on a
  27. calendar-year or quarterly basis.
  28.  
  29. Plotted historical data can be smoothed using 3-day, 5-day or
  30. 7-day moving averages.  The raw data is unaffected.
  31.  
  32. The graphs can be scaled in degrees Fahrenheit, degrees Celsius
  33. or both at once.
  34.  
  35. Total heating degree-days and cooling degree-days are displayed
  36. on all graphic presentations except when plotting exclusively
  37. in degrees Celsius.
  38.  
  39. Graphs can be displayed in color, black/white-on-white or
  40. white-on-black.  The latter two options accommodate graphic
  41. screen printing utilities such as GRAPHICS (the version that
  42. comes with DOS 4.0, and higher), SCRNDUMP and PRTSC.
  43.  
  44. When in color, the background and ten other graphic elements
  45. can be set to any one of sixty-four colors (including black).
  46.  
  47. Built-up databases can created for any locality.  Each hastens
  48. access to its data, particularly when a database reflects more
  49. than five years' of historical temperatures.  There can be up
  50. to one-hundred built-up databases per locality (at the rate of
  51. of 6K-bytes per database).
  52.  
  53. The contents of any built-up database can be viewed, saved to
  54. a text file or sent, formatted, to an IBM- or Epson-compatible
  55. dot matrix printer.  The printout can be in either degrees
  56. Fahrenheit or degrees Celsius  -- but not both at once.
  57.  
  58. Likewise, the data for any one year for any locality can be
  59. saved to a text file or sent to a printer.
  60.  
  61. Each built-up database can carry a unique title and footnote
  62. - or credits line - which appears on its graph.  Also, each
  63. built-up database carries its own color information along
  64. with a quantity of other options.
  65.  
  66. Tables listing average temperatures, extremes and degree-day
  67. values over a period of years can be viewed and printed.
  68.  
  69. Special built-up database USERPREF.WHS furnishes the default
  70. parameters used when creating a new built-up database.  You
  71. can choose most of those parameters by selecting "Graphic
  72. parameters" from an Options menu.  Another special file,
  73. USER1992,WHS, is associated with this feature.
  74.  
  75. Sample data is provided under the locality name of MNOQ for
  76. Minocqua, WI.  It is intended as a learning aid.
  77.  
  78. You can erase WHIST data files from within the program itself.
  79. There is ample protection against accidental erasure.
  80.  
  81. Just for the record, WHIST uses 640 x 350-pixel graphics.
  82. An annual histograph is scaled in steps of one X-axis pixel
  83. per day and 1.6 Y-axis pixels per degree Fahrenheit (2.88
  84. pixels per degree Celsius).  Quarterly graphs are scaled in
  85. steps of four X-axis pixels per day with current-year high
  86. temperature deviations being offset from low temperature
  87. deviations by one pixel (so that any overlap can be seen).
  88. é 
  89. - more -
  90.  
  91. C) HARDWARE REQUIREMENTS:
  92. =æ 
  93. 1) IBM PC, or equivalent, running under PC/MS-DOS 2.1 or higher.
  94. 2) Display and driver:  EGA (Enhanced Graphic Adapter) or better,
  95. with at least 256K bytes of graphic memory.
  96. 3) Minimum conventional memory:  384K bytes of available RAM.
  97. 4) Function keys F1 through F10.
  98. 5) Cursor (arrow) keys.
  99. ü 
  100. D) NON-REQUIREMENTS:
  101. =î 
  102. 1) A hard disk (C, D, E or F) is supported, but not required.
  103. 2) A math co-processor neither supported nor required.  Math
  104. co-processor emulation is built into the program.
  105. ü 
  106. E) LIMITS AND LIMITATIONS:
  107. =Æ 
  108. 1) Up to one-hundred thirty-three years of daily temperatures can
  109. be processed into a single histograph. Data is not restricted
  110. to contiguous years nor does it have to be complete for every
  111. year in the database. At least two years' data are needed to
  112. produce a (barely) useful histograph.  This version supports
  113. years 1795 through 2020 (according to Jeopardy, the U.S.
  114. Weather Service was founded in 1895).
  115.  
  116. 2) This facility accommodates temperatures ranging from -40 to +110
  117. degrees Fahrenheit or -40 to +45 degrees Celsius. Unusual input
  118. is trapped, bleeped and questioned.
  119.  
  120. 3) This facility accommodates two-hundred twenty localities, disk
  121. space permitting. The locality last selected becomes the default
  122. locality the next time you start this program.
  123.  
  124. 4) Although WHIST cannot produce hard copies of weather histographs,
  125. other utilities, such as SCRNDUMP by Hardwood Software Associates
  126. and PRTSC by User Friendly, Inc., can.  Neither utility is included
  127. with this package. They are not mine to distribute. I got my copies
  128. from the Public (software) Library of Houston, Tx.
  129.  
  130. Graphics driver GRAPHICS.COM furnished with DOS version 4.0, and
  131. higher, can print weather histographs. é ~î 
  132. ~é 
  133. Going the commercial route, the SNAPSHOT/SNAP2ART utilities found
  134. in PSF:First Publisher, version 2.0 and up, can print weather
  135. histographs.  But it takes a bit of doing.
  136.  
  137. Microsoft Windows 386 can capture and paste a weather histograph
  138. into Paintbrush. Windows 286 can NOT capture histographs because
  139. of 'insufficient available memory', or something like that.
  140.  
  141. 5) Extended/expanded memory is not supported.
  142.  
  143. 6) This facility works with calendar years and quarters. It does not
  144. recognize seasons.
  145. ü 
  146. F) PACKING LIST (13 files)
  147. =ê 
  148. -x- README   COM   Preliminary instructions.
  149. -x- README2  COM   Last minute changes, if any.
  150. -x- INTRO Ç COM   Opens manuscript WH2DFWD.
  151. -x- SETUP Ç COM   Invokes an installation procedure.
  152. -x- WH2TO3   EXE   Converts Ver 2.xx data files to Ver 3.0.
  153. -e- WH2D30   EXE   The weather histograph facility, version 3.0.
  154. -e- WHIST2D  AGI   ASCII Graphic Images in nine color attributes.
  155. -e- USERPREF WHS   Sample built-up database (Basis: 1983-1991).
  156. -e- USER1992 WHS   1992 data to compare against USERPREF.WHS.
  157. -m- WH2DFWD  MAN   Introduction (this document) - bunched.
  158. -m- WH2DTUT  MAN   A tutorial, of sorts - bunched.
  159. -p- PLANER3D EXE   Sample planer 3-D histograph.
  160. -s- MNOQ---@ EXE   Sample data in a self-extracting archive.
  161. ~└ 
  162. -x- files that will NOT copied to a hard disk during the
  163. installation procedure (if a hard disk is specified).
  164. -e- essential files.  They WILL be copied into a program
  165. directory if a hard disk is specified.
  166. -m- manuscripts that will be copied into the program
  167. dirctory if a hard disk is specified.
  168. -p- promotional graphic image that will be copied into the program
  169. dirctory if a hard disk is specified.  Not essential to WHIST.
  170. -s- sample data - 11 files - referred to in other documentation.
  171. They are intended to be a learninig aid, but they are not
  172. essential to this program.  They will reside in a data
  173. direcrory wheresoever it happens to be. They can be erased
  174. from within the program, itself.
  175.  
  176. G) FILES CREATED DURING INSTALLATION:
  177. =¥ 
  178. WHIST Ç BAT   The invocator - in a root directory.
  179. WHIST2D  INI   Program parameters - in the program directory.
  180. ü 
  181. H) CREDITS APPLICABLE THIS AND/OR OTHER PARTS OF THE PROGRAM:
  182. =â 
  183. DIET is copyright Teddy Matsumoto.
  184. Epson is a trademark of Epson America, Inc.
  185. GRABBER is copyright Gerald A. Monroe.
  186. Hewlett-Packard is a trademark of Hewlett-Packard Corporation.
  187. IBM is a trademark of International Business Machines Corporation.
  188. LHA is copyright Haruyasu Yoshikaki.
  189. MS-DOS is a trademarks of Microsoft Corporation.
  190. Panasonic is a division of Matsushita Electric Industrial Co., Ltd.
  191. PRTSC is copyright 1990 User Friendly, Inc.
  192. PSF:First Publisher is a trademark of Software Publishing Corporation.
  193. Public (software) Library is a trademark of Nelson Ford.
  194. QEMM-386 is a trademark of Quarterdeck Office Systems.
  195. QuickBASIC is a trademark of Microsoft Corporation.
  196. SCRNDUMP is copyright Hardwood Software Associates.
  197. TURBOBAT is copyright Foley Hi-Tech Systems.
  198. Windows and Windows/386 are trademarks of Microsoft Corporation.
  199.  
  200. - more -
  201.  
  202.  
  203. I) VERSION HISTORY - in reverse order:
  204. =ï 
  205. 3.0   A MAJOR RE-MAKE.
  206. ~ï 
  207. Re-wrote WHIST to make it more like WHIST3D, a program that
  208. creates planer 3-D graphs from WHIST data files. See Section
  209. J, below, for more about WHIST3D.
  210.  
  211. Annual data files shrink by 50% to less than 1K and built-up
  212. database files by 75% to about 6K.  A utility for converting
  213. version 2.xx data files to work with this version is included.
  214. Versions 1.x got lost by the wayside.  I don't remember all
  215. of the changes - improvements?
  216.  
  217. 2.11  Version 2.10 destroyed the printout routine for daily temper-
  218. ature values.  Dang!  Fixed it.  Added dynamic high and low
  219. monthly averages along with monthly heating and cooling degree-
  220. day values to the data-entry screen.  Added those same values
  221. to the (just now fixed) printout routine.  Added tables that
  222. compare extreme and average temperatures as well as degree-days
  223. on a monthly basis over a range  of years.  The new tables can
  224. be viewed and printed, but not sent to file.
  225.  
  226. 2.10  CORRECTED AN ONGOING GROSS ERROR.
  227. Degree-days was consistently overstated by 60 percent in earlier
  228. versions of this program! Ç ~ö 
  229. Added current and historic degree-days summations on graphic
  230. presentations -- in Fahrenheit only. Toggle keys hide/display
  231. them.  Added the ability to hide/display the credits line on
  232. graphic presentations.  Changed "histogram" to read "histograph"
  233. throughout the program.
  234.  
  235. 2.00  Heard from Bondi Junction, NSW, Australia where Celsius is
  236. spoken, so:-  added Celsius capability (not as easy as it
  237. sounds).  Added ASCII output features and incorporated year
  238. 1991 in the sample database.  Added more user options, compli-
  239. cated the menus accordingly, streamlined certain features and
  240. expanded the documentation.  Also, arranged to recognize more
  241. hard disk drive letters during the installation procedure.
  242.  
  243. 1.12  Program recognized Ctrl-Ins and Ctrl-Del key combinations from
  244. an AT keyboard but not a PC keyboard!  Fixed it. Also expanded
  245. upon the documentation, rearranged the main menu and made the
  246. graphing menu a bit more user-friendly.
  247.  
  248. 1.11  Fixed a debilitating file-naming error in the ORIGINATE A
  249. LOCALITY routine.
  250.  
  251. 1.1   Added the ability to display white-on-black histographs (the
  252. original was multi-color only) in order to support various
  253. graphics screen-dumping programs.  Also, added the ability
  254. to create a built-up database from a list of daily 'normal'
  255. temperatures.
  256. ü 
  257. J) PLANER 3-D HISTOGRAPHS - EGA graphics (or better) required.
  258. =Æ    ~¥ 
  259. Another program, WHIST3D, can be obtained from this author.  It uses
  260. WHIST data to create planer 3-D histographs.
  261.  
  262. Key-in PLANER3D and press <Enter> to see a sample planer 3-D histograph.
  263. ~├ 
  264. â 
  265. - more -
  266.  
  267.  
  268. K) AUTHOR:  Charles S. Gaylord
  269. =é    8661 Bakely Circle
  270. Minocqua, WI 54548
  271. ü 
  272.  
  273. ┌─│ ┐
  274. │ Released as shareware, $0.  This program is not to Ç │
  275. │ be sold for more than the media value plus a maximum  │
  276. │ of $5 shipping (U.S.A.).  All thirteen files shall be │
  277. │ kept together. ñ │
  278. │ │ │
  279. │ Donations are graciously - nay, GLEEFULLY - accepted. │
  280. │ │ │
  281. └─│ ┘
  282.  
  283. With special THANKS to Kenneth L. Brooks for teaching me how to think.
  284.  
  285. WHIST is Copyright(C) 1990-93 Charles S. Gaylord.  All rights reserved.
  286. ═á  END ═í 
  287. source MM2DFWD.BAS
  288. 2GQ047ç 10148801488088088088808Ç 08808ü 08Ç 08808Ç 08808ü 08808808â 000S0145585550014558001458é 05880588058Ç 08é 08880505800146ë 56:6:6:6:6:Ç 0146600146î 0S00144:Ç 0:ü 04:â 04:â 04:é 04:::04:04:Ç 0014440440Ç S0014=000<à 04040i{üéÇüê éÇüüüâÇüüüéÇüéÇüéÇüüéÇüüüéÇüéÇüÇ πÇ{üüéÇüéÇüüüéÇüéÇüÇ éÇüéÇüéÇüé âÇü üâ âÇÇüÇ πÇÇ{üâ éÇüüéÇüüéÇüÇ éÇüü éÇüüéÇéÇüπÇÇ{üù âÇüüüâÇÇüì πÇÇ {üü éÇüÇ éÇüâ éÇüâ éÇüé éÇüüüéÇüéÇüÇ πÇÇ{üüéÇüöÇâ üüüÇÇÇüä éÇéÇüπÇ12555789:<=è 11223444566è 6*