home *** CD-ROM | disk | FTP | other *** search
/ The Unsorted BBS Collection / thegreatunsorted.tar / thegreatunsorted / misc / graphit1.hlp < prev    next >
Text File  |  1990-08-20  |  8KB  |  139 lines
  1.                   GraphIt! OPERATORS
  2.     Operator/Function   Meaning
  3.     ═════════════════   ═════════════════════════════════════════════
  4.     +, -, *, /        add, subtract, multiply, divide
  5.     ^            exponentiation
  6.     {[( )]}            parentheses: may be nested to any extent,
  7.                 braces and brackets are provided for ease of
  8.                 reading but the parser will NOT differentiate
  9.                 between "{" and "(" and "[".
  10.  
  11.     abs            absolute value
  12.     acos, asin, atan    arc cosine, arc sine, and arc tangent
  13.     cos, cosh        cosine and hyperbolic cosine
  14.     exp            Euler's number to the specified power
  15.     int            greatest integer ([x] is not supported)
  16.     ln, log            natural logarithm, logarithm base 10  ┌─────────┐
  17.     sin, sinh        sine, hyperbolic sine          │PgDn for │
  18.     sqr            square root                  │more help│
  19.     tan, tanh        tangent, hyperbolic tangent          └─────────┘
  20.      ---> NOTE that all trig functions work in RADIANS, not degrees. <---
  21.  
  22.       Besides the variables x and y, 2 other "variables" (pi [3.14159...] and
  23.     e [Euler's number: 2.718...]) are legal identifiers for your convenience.
  24.                    CALLING FUNCTIONS
  25.     The  parser's  ability  to determine exactly what you want to pass  as  an
  26. argument  to a function is somewhat limited,  so I suggest you make it a habit
  27. to enclose the desired expression in parentheses.  "cos x"  may work fine  but
  28. "cos 2x"  is interpreted as "(cos 2)*x"  and "cos x^2"  turns out "(cos x)^2".
  29. Typing "cos (2x)" or "cos (x^2)" instead works perfectly.
  30.       The order of operations is the standard algebraic left to right of:
  31.                    Functions
  32.                   Parentheses
  33.                    Exponents
  34.               Multiplication and division
  35.                Addition and subtraction
  36.  
  37.     GraphIt! supports implied multiplication of  variables and constants as in
  38. "3x" or "5(2x+3)", but not of variables  and other alphabetic identifiers such
  39. as functions  and built-in  transcendental  numbers like "xx",  "xcos(x)",  or
  40. "xpi",  so  you must  include the times  sign in those cases.  (Implied multi-
  41. plication of the  two variables x and  y [i.e. "xy=1"] IS supported, however.)
  42. The  parser may reject some  complex expressions for no apparent  reason. Keep
  43. trying!  I suggest  liberal use  of parentheses:  if you are  not sure whether
  44. something will  be interpreted correctly,  go back and put  parentheses around
  45. it. (One exception: do NOT enclose the entire expression on either side of the
  46. equals sign in parentheses.)                         Press PgDn for more help.
  47.                  GRAPHING THE EQUATION
  48.  
  49.     To interrupt a graph  when the computer is  in the process  of drawing it,
  50. hit any  key and the  program  will display on the  bottom  line the  message:
  51. "PAUSE at x=#, y=#. Press ESC to quit, any other key to restart...",  where  #
  52. indicates  the x and y  coordinates  you  stopped it at.  If you  mistyped the
  53. equation and want to fix it, just press ESC.
  54.     Be patient!  GraphIt! may  need  a while to produce  a quality  graph on a
  55. slower machine.  To speed up the  graphing,  you may  want to  select a  lower
  56. Fineness value.
  57.  
  58.  
  59.                    THE GRAPHING LOOP
  60.  
  61.     When the graph for your equation is complete,  you will again be given the
  62. "Graph?" prompt  at the bottom of the screen.  If you'd like to start all over
  63. with a  completely  different  equation,  press ESC  and the input  field will
  64. clear.  If you'd rather modify the last equation, go right ahead; it's already
  65. stored safe  and sound in the redraw queue  (for more  information see Section
  66. III: Using AutoRedraw  and the Redraw Queue).  To exit the  otherwise infinite
  67. graphing loop, press enter or escape on a blank line (escape twice will always
  68. work).
  69.                     Press PgDn for help on error messages.
  70.                 ERROR MESSAGES
  71.  
  72.     Eleven error  messages may be  encountered when  graphing  (apart from the
  73. messages ingrained in  the library functions which I cannot control).  Five of
  74. them are fatal; the equation cannot be graphed and you must edit it. They will
  75. cause the computer to beep so you know there is a problem. The other six apply
  76. only to specific  point(s) for which a y-value cannot be generated.  They will
  77. not appear  unless you  ask for  them using the  Warnings option and then they
  78. appear silently. 
  79.  
  80. "Found bad operation or mismatched parentheses. Press any key to retype..."
  81.     You  either  left  out a paren somewhere,  left out one  or  both  of  the
  82.     operands for a binary operation or the argument for a function,  or  typed
  83.     some other weird thing the  parser and evaluator couldn't digest.  Examine
  84.     your equation carefully and fix whatever seems to be the problem.
  85.  
  86. "Found unknown identifier. Press any key to retype equation."
  87.     Unfortunately, the evaluator isn't set up to return what caused the error,
  88.     so you'll have to look for it yourself.  Check that your equation contains
  89.     only valid identifiers  (x, y, pi, e, and the functions listed above)  and
  90.     that you separated  each  of them with an operator, space,  or  some other
  91.     punctuation.
  92.                        Press PgDn for more error messages.
  93.                ERROR MESSAGES continued
  94.  
  95. "No equals sign or more than one found. Press any key to edit equation."
  96.     To be a valid and graphable, your equation must include exactly one equals
  97.     sign ['=']. If you get this error, you either left out the '=' or
  98.     accidentally typed two or more of them.
  99.  
  100. "No 'y' variable or more than one found. Press any key to edit equation."
  101.     Although GraphIt! has been enhanced to isolate ONE 'y' variable and graph
  102.     some relations, it cannot graph an equation without a 'y', like "x=4". It
  103.     also cannot perform the factoring needed to isolate the variable 'y' when
  104.     it occurs more than once (i.e. "x=y^2+3y"). If you can adjust the equation
  105.     so it uses only one 'y', do so; otherwise it can't be graphed.
  106.  
  107. "Can't find the inverse of this function of y. Press a key to edit equation."
  108.     You tried to graph an equation like "int(y)=x" or "abs(y)=x" for which y
  109.     cannot be isolated by taking the inverse of the function. The functions
  110.     which cannot be isolated are "abs", "cosh", "sinh", "tanh", and "int". If
  111.     you can't adjust the equation so this error does not occur, it is not
  112.     graphable.
  113.  
  114.  
  115.                        Press PgDn for more error messages.
  116.                 WARNING ERROR MESSAGES
  117. "Overflow at x=#.##." 
  118.     Some  function or operation generated a number too large to fit into a  8-
  119.     byte floating point variable. The point at x=#.##  was not graphed.
  120.  
  121. "Division by zero at x=#.##."
  122.     At #.## your equation attempted division by zero so the point was skipped.
  123.  
  124. "Can't raise a negative number to a fractional power. [x=#.##]"
  125.     Due to the possibility of getting an even root of a negative number, the C
  126.     Library pow()  function  refuses to process any arguments like these.  The
  127.     portion of your graph (if any) where the base is not negative or the power
  128.     is not fractional should be graphed perfectly. This error also occurs when
  129.     you take the square root of a negative number with the "sqr" function.
  130.  
  131. "Can't find the logarithm of a negative number. [x=#.##]"
  132.     The natural logarithm (ln) and base 10 logarithm (log) functions are
  133.     defined only on x greater than zero.
  134.  
  135. "Domain error: asin/acos functions defined only on -1≤x≤1. [x=#.##]"
  136.     The arcsine (asin) and arc cosine (acos) functions are only defined
  137.     between -1 and 1 (the range of the sin and cos functions).
  138. ──────────────End of Graphing help. Press ESC to return to menu.──────────────
  139.