home *** CD-ROM | disk | FTP | other *** search
/ Hacker Chronicles 2 / HACKER2.BIN / 110.UNITSARC.EXE / UNITS < prev    next >
Text File  |  1988-01-25  |  9KB  |  214 lines
  1.                     U N I T S - Version 1.3
  2.  
  3.         I.       About  UNITS
  4.         II.      Licensing/Liability
  5.         III.     Using The Menu System
  6.         IV.      Temperature Conversions
  7.         V.       Using USETUP
  8.         VI.      Suggestions & Complaints
  9.  
  10. I. About UNITS
  11.  
  12. UNITS is a small expert system for the conversion of measurement
  13. units.  While it is not about to set the artificial intelligence
  14. community back on its ear, it does know more than the average Joe
  15. about units of measurement and their conversion.  Can YOU give
  16. the speed of light in furlongs per fortnight?  Thought not.
  17. ( c = 1,802,617,499,800 furlong/fortnight )
  18.  
  19. To invoke UNITS, simply enter "units" at the DOS prompt.
  20.  
  21. A menu system leads you through the entry of the unit names.  You
  22. may use scientific notation for very large or small numbers.
  23. Examples:
  24.  
  25.           1.495678E12  = 1,495,678,000,000
  26.           5.6E-15      = 0.000 000 000 000 005 6
  27.           45.762E5     = 4,576,200
  28.  
  29. Note the optional use of the negative sign in the exponent, and
  30. the lack of spaces.
  31.  
  32. UNITS will handle anything up to and including the simple
  33. compound units such as A*B (eg. foot pounds) and A/B (eg. meters
  34. per second), as well as special compound units of force,
  35. pressure/vacuum, energy, and power.
  36.  
  37. A word on precision:
  38. UNITS uses reasonably precise arithmetic code, and conversion
  39. factors supplied by the National Bureau of Standards and ASTM.
  40. However, it does NOT guarantee the precision of the last few
  41. digits in complicated conversions, particularly when going
  42. between units of vastly different magnitudes.  Converting from
  43. angstroms per second to parsecs per week, for example, will
  44. almost certainly result in errors in the last few digits.
  45.  
  46. Occasionally, a relatively simple conversion will result in a
  47. rounding error of a few parts in a million (try converting one
  48. pound avoirdupois to ounces.)  These are almost always easy
  49. to spot and ignore.
  50.  
  51. Similarly, some units can be converted two different ways.  The
  52. pressure unit psi can be converted to pascals by using the
  53. Pressure Units menu (the most straightforward way), or by doing
  54. the compound unit conversion: pound-force per inch² to newton per
  55. meter².  UNITS will report slightly different values depending
  56. on the route selected, but the conversions are equivalent to
  57. within a part-per-million or so, which should be enough for most
  58. applications.
  59.  
  60. II. Licensing/Liability
  61.  
  62. UNITS is user-supported software.  It is also copyrighted.
  63. Permission is hereby granted to copy and distribute this program
  64. to others, so long as the following files are included:
  65.        UNITS.EXE
  66.        USETUP.EXE
  67.        USETUP.INF
  68.        UNITS
  69.        ULICENSE
  70. The simplest way to do this is to distribute the self-extracting
  71. archive form of this program, UNITSARC.EXE.
  72.  
  73. Users who find this program useful are asked to send a $15
  74. registration fee with the UNITS registration, which may be printed
  75. by entering:
  76.  
  77.       TYPE ULICENSE > PRN
  78.  
  79. Registered users are entitled to support, notification of updates
  80. to UNITS, and updates at cost (the price of a floppy disk and
  81. mailing).
  82.  
  83. UNITS is written in PROLOG -- specifically the Turbo PROLOG
  84. dialect (with extensions) of Borland International, Inc.
  85. Registered users who are interested in experimenting with the
  86. program may obtain a copy of the source code for $40 -- with the
  87. understanding that recompiling the program with only minor
  88. changes to the code and a new copyright notice will be considered
  89. a violation of copyright.
  90.  
  91. Care has been taken to make UNITS a reasonably accurate utility;
  92. however we will not accept liability for any use of this program,
  93. nor for any data processed with it.
  94.  
  95. III. Using The Menu System
  96.  
  97. Whenever UNITS requires you to make a choice, it will present you
  98. with a menu of the possible selections.  To pick one, simply move
  99. the highlight bar (using the arrow keys) to the selection you
  100. wish, and press either Enter or F-10 (function key # 10).
  101.  
  102. The first menu asks you to select the TYPE of conversion you
  103. desire.  At present, UNITS supports the straightforward
  104. conversion of simple units of measurement, and the conversion of
  105. compound units of the type A*B (eg. foot-pounds) or A/B (eg.
  106. miles per hour).  The conversion of units of temperature is
  107. treated as a special case.
  108.  
  109. The second menu asks you to pick the type of quantity you are
  110. measuring, mass, for instance, or volume.  For a compound unit,
  111. you must specify the type of each of the two units.
  112.  
  113. The third menu allows you to select the particular unit from
  114. which you wish to convert.  We would be interested to hear of any
  115. units you require which are not currently supported by UNITS.
  116.  
  117. If you select certain metric units, such as the meter, gram or
  118. kelvin, UNITS will also ask you to specify the desired metric
  119. prefix (such as kilo- or nano-).  If there is no prefix, simply
  120. press the Enter (or F-10) key at this point.
  121.  
  122. If you make a mistake, pressing the Esc key at any menu will return
  123. you to the first UNITS menu, allowing you to start over again.
  124. Pressing the Esc key on the first menu will allow you to exit
  125. UNITS.
  126.  
  127. A shortcut:
  128. Some UNITS menus, including the first menu and the units-of-time
  129. menu, are presented as a single column of options, each beginning
  130. with a lowercase letter.  Pressing the letter of the option you
  131. desire will jump the highlight bar to that option without using
  132. the arrow keys.
  133.  
  134.  
  135. IV.  Temperature Conversion
  136.  
  137. UNITS converts between temperatures expressed in the four main
  138. thermodynamic temperature scales: Kelvin, Celsius, Fahrenheit,
  139. and Rankine.  It does not expressly handle conversions for
  140. intervals of temperature, as in: "This instrument is accurate to
  141. within 3 degrees Celsius."
  142.  
  143. You can do this conversion by understanding that a degree Celsius
  144. is the same size as a kelvin, and a degree Fahrenheit is the same
  145. size as a degree Rankine, and that the kelvin and Rankine scales
  146. share the same zero point.
  147.  
  148. Therefore, "within 3 degrees Celsius" is equivalent to "within 3
  149. kelvin", and using UNITS we discover that 3 kelvin is equal to
  150. 5.4 degrees Rankine.  "Within 5.4 degrees Rankine" is equivalent
  151. to "within 5.4 degrees Fahrenheit", and so we can write: "This
  152. instrument is accurate to within 5.4 degrees Fahrenheit."
  153.  
  154. V.  Using USETUP
  155.  
  156. UNITS is accompanied by an installation routine (USETUP.EXE)
  157. which allows you to set the screen colors for the various menus and
  158. windows in UNITS.  USETUP makes changes directly to the UNITS
  159. program file AND SHOULD ONLY BE USED ON YOUR WORKING COPY OF UNITS.
  160. Always save an archive copy of the program.
  161.  
  162. USETUP first checks to make sure that its information matches
  163. your current version of UNITS, and will not run if the versions
  164. do not match.  The data file USETUP.INF must be in the same
  165. directory as USETUP, or the program will not run.
  166.  
  167. USETUP first asks you to supply the "path" to the copy of UNITS
  168. that you wish to install.  If USETUP and UNITS are in the same
  169. directory, you need only press the Enter key at this point,
  170. otherwise, enter the DOS path to UNITS, such as:
  171.  
  172.              C:\UTILITY\
  173.  
  174. USETUP next asks if you have a color monitor.  If the reply is
  175. "n" (no), USETUP sets UNITS for the default monochrome display
  176. and ends without further warning.  If the answer is "y" (yes),
  177. USETUP gives you the option of using the standard UNITS color
  178. selection.
  179.  
  180. You may also select your own color scheme.  Use the arrow keys
  181. to select the window you wish to change from the menu.  (You
  182. may wish to run UNITS first to get an idea of what each window
  183. looks like.)  Press Enter to start working on a window.  You
  184. must choose four colors:
  185.  
  186.             The color used to display text.
  187.             The color used for the background.
  188.             The color used for text that is highlighted
  189.                (as in a menu).
  190.             The color used for the background of
  191.                highlighted text.
  192.  
  193. There are eight available colors for each selection: Black, Blue,
  194. Green, Cyan, Red, Magenta, Brown, and White.  The Left-Right
  195. arrow keys step you through the text colors; the Up-Down keys through
  196. the background colors.  When you start, you will be adjusting the
  197. normal text/background settings.  Pressing the Home key switches
  198. to the highlighted text/background settings (and back again).
  199. Your current settings are displayed in the top-left window, and
  200. examples are shown in the top-right window.  Press Enter to
  201. register your selections for that particular window and to
  202. return to the menu to select another window.
  203.  
  204. VI. Suggestions & Complaints
  205.  
  206. Please report any problems or suggestions for improvements to:
  207.  
  208.                     Michael Baum
  209.                     3004 Westcott Street
  210.                     Falls Church, VA 22042
  211.  
  212.                     (703) 237-9439
  213.  
  214.