home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / misty21.zip / MISTY.DOC < prev    next >
Text File  |  1994-03-11  |  23KB  |  528 lines

  1.  
  2.                 Misty Expression Evaluator Version 2.1                p 1.
  3.                 copyright 1994 by Peter Neuendorffer
  4. _______________________________________________________________________
  5.                  I.  INTRODUCTION                              1
  6.                               What it does
  7.                               Shareware
  8.                               Installation
  9.                 II.  CALCULATION                              2
  10.                               Expressions
  11.                               Operators and Variables
  12.                III.  FEATURES                                 3
  13.                               Evaluate
  14.                               Store
  15.                               Retrieve
  16.                               History
  17.                               Log
  18.                               Minus Root
  19.                               Info
  20.                 IV.  FRACTIONAL EXPONENTS                     5
  21.                      (see important NOTE on pg 5)
  22.                  V.  GRAPHING A FUNCTION                      6
  23.                 VI.  ITERATION                                8
  24. _______________________________________________________________________
  25.  
  26.   I. INTRODUCTION
  27.         This software functions much like a pocket calculator. You
  28.         can do arithmetic and store formulas as numerical expressions.
  29.         Numerical expressions can be arithmetic or a combination of
  30.         variables. The expression could be 2+2, or a+b, or it could
  31.         be the formula for the hypotenuse of a triangle (sqrt(b^2+h^2)).
  32.  
  33.         You can store these expressions on disk with the Store feature.
  34.         You can save your answers on disk with the Log feature. You
  35.         can call up previous answers and variables from the current
  36.         session with the History feature. You can recall stored
  37.         expressions and edit them again with the Retrieve feature.
  38.         A crib sheet of information is provided in the Info feature.
  39.  
  40.         Say your expression is "a+b" (without the quotations). You
  41.         could evaluate this by entering in "a+b" (without the quotations)
  42.         in the Evaluate option. Then fill in the variable values for
  43.         a, and b. Then press enter. The answer is given. More on what
  44.         you can do in the section below entitled CALCUALATION.
  45.         This software handles addition, subtraction, multiplication,
  46.         division, exponents (including fractional exponents), sine,
  47.         cosine and tangent. You can use decimal or "real" numbers.
  48.         Scientific notation is supported, such as "2E+5".
  49.  
  50.         Shareware: This program is Shareware. It is not free.
  51.         You may distribute it freely, and  use it yourself for a period
  52.         of up to three weeks. Then, on the honor system, pay for it
  53.         by sending $15.00 to:
  54.         Peter Neuendorffer
  55.         1399 Commonwealth Ave #11, Allston MA 02134
  56.         Telephone Suppport for Misty: 617-254-2213 voice (7-11PM EST)
  57.         NO further media will be sent, as this program is complete.
  58.  
  59.         Installation: Copy all the files to an empty sub directory on
  60.         your hard drive. A hard drive is recommended but not mandatory.
  61.         Run the software from the drive and directory that it is located.
  62.         From DOS run MISTY.  This is NOT a Windows program.
  63.         For the graphing function only, a VGA or higher resolution color
  64.         graphics card is required.
  65.  
  66.  
  67.   II. CALCULATION                                                     p 2.
  68.       -Expressions.
  69.       In the English, or other word language, an expression is a
  70.       collection of symbols that takes on one agreed upon  meaning.
  71.       Much as in word languages, an arithmetic expression is a collection
  72.       of numbers or variables (operands) combined with arithmetic symbols
  73.       -such as "-" or "+"- (operators). These symbols are combined according
  74.       to certain rules, or the "math". If this sounds like gobbledygook,
  75.       here are some examples of expressions that this software excepts,
  76.       and evaluates:
  77.                expression   ....operator.....     means
  78.                   5              constant         the number five.
  79.                   5+2       +    addition         five plus two.
  80.                   5-2       -    subtration       five minus two.
  81.                   5*2       *    multiplication   five times two.
  82.                   5/2       /    division         five divided by
  83.                                                   two giving a decimal answer.
  84.                  sin(2)    sin   sine             the sine of two.
  85.                  cos(2)    cos   cosine           the cosine of two.
  86.                  tan(2)    tan   tangent          the tangent of two.
  87.  
  88.                  a+b        +    addition         The value of a plus
  89.                                                   the value of b
  90.                  4^2        ^    exponent         4 squared  (4*4)
  91.                  4^(1/2)    ^    exponent         the square root of 4
  92.                  sqrt(8)   sqrt  square root      square root of 8
  93.                  2E+1       E    scientific       2 times 10 (once)
  94.                  2E-1       E      "              2 times .1 (once)
  95.              -----------------------------------------------------
  96.            Actual expressions can be quite long:  (a*b/c)+0.5^(3.1)-2/4
  97.            In addition the trigometric constant "pi" is supported as pi.
  98.             -----------------------------------------------------
  99.             You may enclose parts of the expression in parentheses ()
  100.             For example, (4+b)*6 is allowed, and is different
  101.             from 4+b*6 in the order that the numbers are combined.
  102.             The first example adds 4 to b first, while the second
  103.             multiplies b times 6.
  104.             ------------------------------------------------------
  105.             You may use the single letter variables a through z in
  106.             your expressions, excepting the letter e which is reserved
  107.             for scientific notation.
  108.             ------------------------------------------------------
  109.   - Operators and Variables.
  110.        In the order that they are evaluated by the software:
  111.                    + -             "unary" a negative number such as -10
  112.                    E               scientific
  113.                    ^               exponent
  114.                    sin  cos tan    trigometric functions taken on angles
  115.                                    that are given in radians.
  116.                    multiply        divide
  117.                    add             subtract
  118.     --------------------------------------------------------
  119.     Variables always have a given value at the time you evaluate your
  120.     expression. The variable letters you use "stand in" for the
  121.     value, which you fill in. Thus is your expression is a+b-c, then
  122.     you need to fill in the values of the variables, such as a=1, b=2, c=3.
  123.     This software does not use formulas with the equals sign. If you
  124.     enter in a formula for an expression, such as a=b+c, then everything
  125.     to the left of the equals sign, including the equals sign, is ignored.
  126.    ----------------------------------------------------------
  127.    Positive and negative numbers from -10^36 to 10^36 are supported.
  128.    The accuracy of fractional exponents less than one varies. 2^(1/3)
  129.    is quite accurate to four places. 2^(1/3.1) is not so accurate.
  130.    Numbers are generally significant to 10 places. Such as 1234567890
  131.  
  132.  
  133.   III. FEATURES                                                      p 3.
  134.  
  135.       -Evaluate.
  136.       This is where you get your answers and evaluate expressions.
  137.       From the main menu, select Evaluate with the up and down arrow
  138.       keys, and press Enter.
  139.  
  140.       Now enter in an expression. When you press Enter any time you
  141.       enter an expression, the expression is "remembered" for the
  142.       next time you enter in an expression.
  143.  
  144.       You are taken to a black screen where you see your expression.
  145.       If there were no letter variables in the expression, your answer
  146.       is given. Press Escape to exit back to the main menu.
  147.  
  148.       If there are letter variables in your expression, such as in the
  149.       expression s*b^3/4, you may fill in the values for the variables.
  150.       Use the up, down, left and right arrow keys to select the variable,
  151.       and type in the value. Don't press Enter till you are done.
  152.       After you press enter, your answer is given.
  153.  
  154.       Repeat the process, or press Escape to exit. The F10 key will allow
  155.       you to take the last answer anytime, and use it for a variable value.
  156.  
  157.       When entering in variables, you may use an expresssion, even one
  158.       involving other variable letters. If you use a letter that is
  159.       not in the expression, the value of the letter is zero.
  160.  
  161.       Some errors may occur. They could be "divide by zero" because
  162.       the calculation involved dividing by zero. Error in expression
  163.       ususally indicates that the expression is written incorrectly.
  164.       A circular reference means you have variables that depend on each
  165.       other.  Too many terms means the expression is too complicated.
  166.       If the expression involves a fracional root of any kind of a
  167.       negative number than the error "attempt to take root of negative
  168.       number" is displayd.
  169.       -----------------------------------------------------------
  170.       You will find this process repeated in the Features "Retrieve"
  171.       and "History Display" with variations.
  172.  
  173.  
  174.      -Store.
  175.      You may wish to store an expression (not the answer) for a rainy
  176.      day. To do this, choose Store from the main menu. Then enter
  177.      in an expression. Then give it a title in words such as
  178.      "Area of a circle". Then you can add any notes you wish to include.
  179.      The expression is now stored on disk.
  180.  
  181.      -Retrieve
  182.      You retrieve an expression that is stored on disk. Choose Retrieve
  183.      from the main menu. Then you have two choices:
  184.  
  185.          Use stored expression:
  186.              You will see a menu of your stored expressions. If it is
  187.              longer than a page, use the page up and page down keys.
  188.              Use the up and down arrow keys to select an expression,
  189.              and press Enter. You are now brought to the same screen
  190.              as in Evaluate, and you can Evaluate the expression, or
  191.              press Escape to exit.
  192.  
  193.         Edit stored expression:
  194.             You can edit the expression, title, and notes, but you
  195.             will not be using the expresssion directly to get an answer.
  196.  
  197.  
  198.  
  199.     (III. FEATURES continued)                                        p 4.
  200.  
  201.     -History Display.
  202.      Whenever you evaluate an expression, a revolving "snapshot" is
  203.      taken of the screen. The last 20 answers are saved in this
  204.      history list. From the main menu, select History Display.
  205.  
  206.      Use the page up key to go back in the list. Forward with page down.
  207.      If you want to re-avaluate a previous answer, press F3 on the
  208.      screen you wish to evaluate. You are brought once again to
  209.      the same screen as in Evaluate.
  210.      Otherwise press Escape to exit.
  211.  
  212.  
  213.    -Minus Roots:
  214.           This is a toggle switch that Enables/Disables the ability
  215.           of the software to recognize alternative root solutions
  216.           (see Fractional Exponents section below). If "Enabled",
  217.           the software will report solutions that depend on negative
  218.           roots. If "Disabled" this feature will not be reported.
  219.           Toggle the switch by selecting "Minus Roots" from the
  220.           main menu, and pressing Enter.
  221.  
  222.    -Log.
  223.     You can store your current session on disk with a "Log" file. Note
  224.     this is different from the stored expressions, which do not contain
  225.     answers; and it is different from the History list, which only
  226.     exists while you run the program.
  227.  
  228.     Turn on the log file by choosing Log from the main menu. Enter a
  229.     file name such as save.doc. Press Escape. Now any time you
  230.     get an answer, the screen will be saved in the file save.doc on
  231.     disk. Turn off the log file by selecting Log again from the
  232.     main menu. If you use a log file name that already exists, the
  233.     log is added on to the previous file on disk.
  234.  
  235.    -Info: A screen of notes on this software. Select Info from the main
  236.           menu. Press Escape to exit.
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.      IV. FRACTIONAL EXPONENTS                                        p 5.
  266.  
  267.      Fractional Exponents of Positive Numbers
  268.      ----------------------------------------
  269.          When a positive number is taken to a fractional exponent,
  270.          sometimes it has two solutions. For example, 4^.5, or
  271.          sqrt(4) has two solutions, 2  and  -2  . You can see that
  272.          both 2 squared, and minus 2 sqaured yield 4.
  273.  
  274.          The fractional exponents that work in this way are 1/2,
  275.          1/4, 1/6, 1/8 and so on.
  276.  
  277.          This software gives you all the answers for your function
  278.          involving these even fracional exponents. After you obtain
  279.          an answer to your expression in the Evaluate option, if there
  280.          are multiple solutions, the prompt "F1=other roots" will
  281.          appear. Press F1, and the various answers will pop up.
  282.          Press Escape to return to the last screen.
  283.  
  284.          In the pop-up window of alternative solutions, the signs
  285.          of each exponental solution for each answer are shown.
  286.          Thus if the answer has [-] before it, the answer reflects
  287.          the negative solution. If the answer has [+] before it,
  288.          the answer reflects the positive solution. Additional
  289.          "[ ]"'s show each possible solution if there is more than
  290.          one possible negatative solution in your expression.
  291.  
  292.          The word "dos not apply" refers to a negative solution for
  293.          an exponent that depends on a variable.
  294.  
  295.          Up to three possible fractional exponents in a given function
  296.          are calculed in this way. If there are more than three, say
  297.          in the expression a^.5+b^.5+c^.5+d^.5, then only the positive
  298.          solutions are calculated. An expression such as
  299.                            a^.5+b^.5+c^.5
  300.          could generate up to eight solutions at a time.
  301.          ------------------------------------------------------------
  302.  
  303.      Fractional Exponents of Negative Numbers
  304.      ----------------------------------------
  305.          When a negative number is taken to a fractional exponent,
  306.          only certain odd fractions generate a real solution.
  307.          Thus the square root of -2 is not a real number, and will generate
  308.          the error message "bad or unknown root of a negative number".
  309.          The odd exponents that are supported are 1/3,  1/5, 1/7....1/9..
  310.          and so on. Also an internal table of exponents supports
  311.          the exponents x/3, x/5, x/7, x/9, x/11, x/13, x/15, x/17, x/19,
  312.          where x is an integer between 1 and the denominator.
  313.  
  314.          This guarentees that if you specify an exponent in your expression
  315.          as a fraction, with the denominator between 2 and 19, the
  316.          software can process the function. Example  b^(6/11).
  317.          The software attempts to convert decimal exponents to a fraction.
  318.  
  319.          If you use a decimal for the exponent, or a variable, the software
  320.          may not be able to get an answer from the exponent.
  321.  
  322.    NOTE: Small fractional exponents taken of numbers equal or larger than
  323.          10E7 will not be calculated. Example: (10^8)^(1/10) will generate
  324.          an overflow error. If the base number is bigger than 10E7 and
  325.          the axponent involves a fraction smaller than 1/9 than an
  326.          "overflow" message will appear.  If the base number is smaller,
  327.          or the exponent is a larger fraction, the answer will appear.
  328.  
  329.  
  330.  
  331.      V. GRAPHING A FUNCTION                                          p. 6
  332.  
  333.         1. Drawing the Graph:
  334.  
  335.         Version 2.0 of Misty provides the ability to see your function
  336.         as a graph. Choose Evaluate, and Enter in a function ,such
  337.         as a/2.
  338.  
  339.         Now choose a variable (if there is more than one variable)
  340.         that you wish to see your function graphed "against". That is
  341.         if you graph "a/2", then the graph would be generated using
  342.         a RANGE of values for a, rather than just one value. This
  343.         is the Independent Variable, in our example, "a".
  344.  
  345.         Fill in the values you want for the other variables. These values
  346.         will be constant for the graph.
  347.  
  348.         Instead of filling in a value for your Independent Variable,
  349.         ("a"), move the cursor to the line on the screen that says
  350.         "a=" (or "b=" if you chose "b"). Now press the F5 function key.
  351.         You will be asked for a range for the Independent Variable
  352.         ("a"). The lower range might be -10, and the upper range might
  353.         be 10. Thus the graph would be plotted against values of "a"
  354.         from -10 to 10.
  355.  
  356.         You will be asked three questions, which you answer "Y" for
  357.         yes, and "N" for no:
  358.  
  359.               "10's Scale?":
  360.               Do you want the ranges of the horizontal and vertical axes
  361.               expanded to the next power of 10? Thus if the horizontal
  362.               varied from -78 to 54, the range would be converted to
  363.               -10^2 to 10^2   (-100 to 100).
  364.  
  365.               "Same scale?":
  366.               Do you want both the answer (the vertical)
  367.               axis) and the Independent Variable (horizontal axis) to
  368.               be in the same scale? If you choose yes, even if the
  369.               values of the answer are considerably larger than the
  370.               values of "a", the vertical axis is still topped at the
  371.               same value (10) as the horizontal.
  372.               If you choose "N" for not same scale,
  373.               then all values of the answer are included, but the
  374.               relative distances in the horizontal and vertical axes
  375.               could be different- Say the answer varied from -100 to 100,
  376.               but the independent variable only varied from -10 to 10.
  377.  
  378.               "Connect Dots?":
  379.               Do you wish the graph do draw lines between the points
  380.               on the graph?
  381.         ----------------------------------------------------------------
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.      (V. GRAPHING A FUNCTION continued)                              p. 7
  398.  
  399.         2. Viewing the Graph
  400.  
  401.         If your graph had no valid solutions, an error box will
  402.         pop up displaying the problem. Otherwise, if all is well,
  403.         you should see your graph.
  404.  
  405.    ---------------------------------------------------------------
  406.    Axes:
  407.         The coordinates of the horizontal axis are on the far left
  408.         and right of the screen, half-way from top to bottom. This is
  409.         the range of the independent variable ("a") you plotted. Eighty
  410.         slices of this range were taken to yield 80 points to plot.
  411.         The coordinates of the vertical axis are half-way from left
  412.         to right, at the top and bottom of the screen. This is the
  413.         range of the answers.
  414.  
  415.    ----------------------------------------------------------------
  416.    Crosshatch:
  417.         You can add a crosshatch to your axis by pressing F2.
  418.         This is to better judge the values of your plotted line or curve.
  419.  
  420.    ---------------------------------------------------------------
  421.    F3: Answers
  422.         You can obtain particular answers for this plotted line or
  423.         curve. Press F3. Then use the right and left arrows to
  424.         move the dotted line from left to right. The answer for that
  425.         value is at the top right of the screen. This is the point where
  426.         the dotted line crosses the plotted point or curve.
  427.         You can fine tune this dotted bar with the up and down arrow
  428.         keys.
  429.  
  430.         F1: Alternative Answers
  431.         Some graphs show more than one line. This is because the function
  432.         involved a fractional exponent. (see section above). Whike using
  433.         the F3 option, you may see these alternative answers by pressing
  434.         F1. Escape to get back to the graph.
  435.  
  436.    ---------------------------------------------------------------
  437.    Page Up:Last Graph
  438.         If you have plotted a graph just previously in this session, this
  439.         last graph may be overlayed on the current one. Press Page Up
  440.         to see the last graph, and then Page Down to remove it. You may
  441.         also get incremental answers with the F3 key. The values
  442.         and answers are displayed for the second graph at the bottom
  443.         of the screen.
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.      VI. ITERATION                                                   p 8.
  464.  
  465.          By iteration I mean displaying a range of answers for the
  466.          expression. For example, if the expression is a^2, meaning
  467.          a squared, you could get answers for a range of a, say
  468.          1^2, 2^2, 3^2. This is much like what the software does
  469.          to create a graph, except all the answers are displayed for
  470.          you.
  471.  
  472.          To do the Iteration, enter in an exression under Evaluate,
  473.          or using the History List or Retrieve-Use options. Once
  474.          you press enter, as ususal you see a black screen with the
  475.          expression displayed along with your variables. You have
  476.          to have at least one variable letter in the expression for
  477.          the iteration to work.
  478.  
  479.          Now, if there is more than one variable, fill in the values
  480.          for the variable you wish to stay the same. Then move the
  481.          cursor to the variable letter you wish to have the range of.
  482.  
  483.          Press F6. Now enter in the starting value for this variable.
  484.          For example if you wanted to calculate a^2 starting at a
  485.          value of 10 for a, enter in 10.
  486.  
  487.          Now enter the amount to add to the variable for each answer.
  488.          For example, enter in 1 to get answers with values of a increased
  489.          by one for each answer.
  490.  
  491.          You are now asked if you want the numbers displayed rounded
  492.          off to 4 decimal places. Otherwise the numbers will appear
  493.          in "e" scientific notation.
  494.  
  495.          You should get the values of your variable on the left of the
  496.          screen now, and the answers on the right. Press Page-Down to
  497.          continue with more values, or after a couple of pages have
  498.          gone bye, press Page-Up to see any previous page, Press
  499.          Escoape to exit.
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.