home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / calculat / units_am.zip / UNITS.DOC < prev    next >
Text File  |  1993-07-15  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4.    14 July 1993                                                      UNITS(1)
  5.  
  6.  
  7.  
  8.    NAME
  9.      units - conversion program
  10.  
  11.    SYNTAX
  12.      units [-f filename] [-q] [to-unit from-unit]
  13.  
  14.    SUMMARY
  15.  
  16.      -f filename
  17.          Specifies the name of the units data file to load.
  18.  
  19.      -q  Supresses prompting of the user for units and the display of statis-
  20.          tics about the number of units loaded.
  21.  
  22.      from-unit to-unit
  23.          Allows a single unit converstion to be done directly from the com-
  24.          mand line.  No prompting will occur.  The units program will print
  25.          out only the result of this single conversion.
  26.  
  27.  
  28.    DESCRIPTION
  29.      The units program converts quantities expression in various scales to
  30.      their equivalents in other scales.  The units program can only handle
  31.      multiplicative scale changes.  It cannot convert Centigrade to
  32.      Fahrenheit, for example.  It works interactively by prompting the user
  33.      for input:
  34.  
  35.          You have: meters
  36.          You want: feet
  37.                  * 3.2808399
  38.                  / 0.3048
  39.  
  40.          You have: cm^3
  41.          You want: gallons
  42.                  * 0.00026417205
  43.                  / 3785.4118
  44.  
  45.      Powers of units can be specified using the '^' character as shown in the
  46.      example, or by simple concatenation: 'cm3' is equivalent to 'cm^3'.
  47.      Multiplication of units can be specified by using spaces, a dash or an
  48.      asterisk.  Division of units is indicated by the slash ('/'). Note that
  49.      multiplication has a higher precedence than division, so If the user
  50.      enters incompatible unit types, the units program will print a message
  51.      indicating that the units are not conformable and it will display the
  52.      reduced form for each unit:
  53.  
  54.          You have: ergs/hour
  55.          You want: fathoms kg^2 / day
  56.          conformability error
  57.                  2.7777778e-11 kg m^2 / sec^3
  58.                  2.1166667e-05 kg^2 m / sec
  59.  
  60.  
  61.  
  62.  
  63.                                                                             1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.    UNITS(1)                                                      14 July 1993
  71.  
  72.  
  73.      The conversion information is read from a units data file.  The default
  74.      file includes definitions for most familiar units, abbreviations and
  75.      metric prefixes.  Some constants of nature included are:
  76.  
  77.          pi       ratio of circumference to diameter
  78.          c        speed of light
  79.          e        charge on an electron
  80.          g        acceleration of gravity
  81.          force    same as g
  82.          mole     Avogadro's number
  83.          water    pressure per unit height of water
  84.          mercury  pressure per unit height of mercury
  85.          au       astronomical unit
  86.  
  87.      'Pound' is a unit of mass.  Compound names are run together so 'pound-
  88.      force' is a unit of force.  British units that differ from their US
  89.      counterparts are prefixed with 'br', and currency is prefixed with its
  90.      country name: 'belgiumfranc', 'britainpound'.  When searching for a
  91.      unit, if the specified string does not appear exactly as a unit name,
  92.      then the units program will try to remove a trailing 's' or a trailing
  93.      'es' and check again for a match.
  94.  
  95.      All of these definitions can be read in the standard units file, or you
  96.      can supply your own file.  A unit is specified on a single line by giv-
  97.      ing its name and an equivalence.  One should be careful to define new
  98.      units in terms of old ones so that a reduction leads to the primitive
  99.      units which are marked with '!' characters. The units program will not
  100.      detect infinite loops that could be caused by careless unit definitions.
  101.  
  102.      Prefixes are defined in the same was as standard units, but with a
  103.      trailing dash at the end of the prefix name.
  104.  
  105.    BUGS
  106.  
  107.      The effect of including a '/' in a prefix is surprising.
  108.  
  109.      Exponents entered by the user can be only one digit.
  110.  
  111.      The user must use | to indicate division of numbers and / to indicate
  112.      division of symbols.  This distinction should not be necessary.
  113.  
  114.      The program contains various arbitrary limits on the length of the units
  115.      converted and on the length of the data file.
  116.  
  117.    FILES
  118.      units.lib - the standard units library
  119.  
  120.    AUTHOR
  121.      Adrian Mariano (adrian@u.washington.edu or mariano@geom.umn.edu)
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.    2
  130.  
  131.  
  132.  
  133.