home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / graphuti / grmat32d.zip / GRMAT1.HLP < prev    next >
Text File  |  1993-07-20  |  21KB  |  346 lines
  1.                 OPERATORS AND FUNCTIONS
  2. Basic operators:        Other operators:
  3. ──────────────────────────┬───────────────────────────────────────────────────
  4.   +     addition      │  [( )]   Parentheses: may be nested to any extent;
  5.   -     subtraction       │         parser WON'T distinguish between ( and [
  6.   *     multiplication    │  ;       Separate halves of a parametric equation
  7.   /     division      │  '       Make rest of the equation a comment
  8.   ^     exponentiation    │  {m, n}  Specify domain, where 'm' is the start of
  9.   =     normal equation   │         the domain and 'n' is the end. Either end
  10. ──────────────────────────┤         may be left open by omitting 'm' or 'n'.
  11. Functions supported:      │  <, >    less-than or greater-than inequality
  12. ──────────────────────────┼───────────────────────────────────────────────────
  13. abs     absolute value    │  exp     Euler's number to the given power (e^x)
  14. acos    arc cosine      │  int     greatest integer ([x] is not supported)
  15. asin    arc sine      │  ln      natural logarithm
  16. atan    arc tangent       │  log     logarithm base 10
  17. asec    arc secant      │  sec     secant (1/cos)
  18. acsc    arc cosecant      │  sin     sine
  19. acot    arc cotangent     │  sinh    hyperbolic sine          ┌─────────┐
  20. cos     cosine          │  sqr     square root          │PgDn for │
  21. cosh    hyperbolic cosine │  tan     tangent              │more help│
  22. cot     cotangent (1/tan) │  tanh    hyperbolic tangent       └─────────┘
  23. csc     cosecant (1/sin)  │
  24.                 CONSTANTS AND VARIABLES
  25.  
  26.    Variables           Usage
  27.    ─────────────────   ──────────────────────────────────────────────
  28.    x, y               rectangular coordinates
  29.    r, t               r and theta in polar coordinates
  30.    x, y, t           x and y as functions of t in parametric form
  31.    x, t, dx           dif-eq mode, solves first order o.d.e.
  32.                dx is actually dx/dt in dx/dt = f(x,t)
  33.    a               user-settable free variable; can specify range
  34.                and step rate to calculate several values
  35.  
  36.    Constant           Value
  37.    ─────────────────   ──────────────────────────────────────────────
  38.    b, c               user-settable free variables (constant)
  39.    d               converts degrees to radians = p/180
  40.    e               Euler's number = 2.718...
  41.    pi (or p)           p = 3.14159...
  42.  
  43.    NOTE: by default, all trig functions work in radians, not degrees. You
  44.    can convert using the constant d: e.g. sin(45d) = sin (pi/4)
  45.    cos (x*d) = cosine of x, in degrees (you will need to change the range
  46.    of x to 0 to 360 to get the full graph)         Press PgDn for more help.
  47.              GRAPHING CARTESIAN FUNCTIONS
  48. Here are the ground rules for normal Cartesian equations:
  49. + Always use exactly one "=" per equation
  50. + Always use exactly one "y", which need not be isolated
  51. + Always put some sort of expression on both sides of the "="
  52. + An expression consists of any mathematically meaningful combination of
  53.   decimal numbers, binary operations like + and *, parentheses, functions,
  54.   and variables or constants.
  55. + Spaces are completely optional, except where they serve to separate
  56.   alphabetic identifiers.
  57. + The order of operations is the standard algebraic left to right of:
  58.               Functions, Parentheses, Exponents,
  59.         Multiplication and division, Addition and subtraction
  60.  
  61. Graphmatica supports implied multiplication of variables and constants, but
  62. variables and other alphabetic identifiers such as functions and constants
  63. MUST be separated by a space or '*' or they will not be identified correctly.
  64.     Examples:     3x     5(2x+3)     x pi      x*cos(x)
  65.  
  66. Call a function by tying the function's name followed by an argument. If the
  67. argument is more complex than "x", enclose it in parentheses to be safe.
  68.     Examples:     cos x       log (2x)      sin (3x^2-5)
  69.                              Press PgDn for more help.
  70.                  SPECIFYING THE DOMAIN
  71. Graphmatica lets you specify the domain of each equation independently, so you
  72. do not have to use the range function to change the default domain each time.
  73. To specify a domain, add anywhere in your equation the expression:
  74.                    { m, n }
  75. where 'm' is the start of the domain and 'n' is the end. If you want the
  76. domain to start at the default start, leave 'm' out. To leave the end of the
  77. domain open, leave out 'n'. So if the range on-screen is (-10,10), specifying
  78. a domain of "{ ,5}" will graph from -10 to 5, and one of "{-4, }"  from -4 to
  79. 10. To graph a parametric equation, you MUST specify a domain that is closed.
  80.  
  81. The domain is parsed like any other expression, so you can use any operator or
  82. function as well as numbers and the constants d, e, and pi. However, you can
  83. not use variables in a domain.   Examples:    {0, 2p}      { -3, log 2}
  84.  
  85.                  USING FREE VARIABLES
  86. The free variables 'b' and 'c', which you can define yourself, make it easier
  87. to "play around" with the exact shape of a curve without editing the equation.
  88. If you want, you can type in a value manually using a format similar to
  89. the domain specifier described above. (See manual for details)
  90.   Examples:       {b: 1}        {c: -1/2}      {b: -pi/4}
  91. If you don't include this value, Graphmatica will prompt you for it.
  92.                      Press PgDn for help on function families.
  93.             GRAPHING FAMILIES OF FUNCTIONS
  94. The free variable 'a' lets you specify not just a single value, but a range of
  95. possible values that it can take. This lets you easily graph families of
  96. functions or level curves of a 3-D surface. For instance, "y = a*cos(x)" will
  97. graph cosine curves of varying amplitudes, and "x^3+y^2 = a" will draw level
  98. curves of the surface "f(x,y) = x^3+y^2".
  99.  
  100. When you use 'a' in an equation, Graphmatica will prompt for the needed values
  101. and insert them for you: the start of the range, the end of the range, and the
  102. amount to step by. Graphmatica starts by graphing the function with 'a' set to
  103. the start of its range, and then increments 'a' by the step value and draws
  104. another graph until 'a' exceeds the end of its range. (You can give a negative
  105. step value as long as the end of the range is less than the start.) The
  106. program does not put any limit on the number of curves in the "family" you can
  107. graph, but this feature uses memory rapidly, so try to limit 'a' to about 10
  108. iterations.
  109.             MODIFIYING FREE VARIABLE VALUES
  110. The Set Vars command in the Point menu allows you to change the value of 'a',
  111. 'b', or 'c' instantly in all equations without actually editing any of them.
  112. After you select a variable and provide a new value for it, Graphmatica will
  113. find all the equations using the variable, make a copy of each using the new
  114. value, and then graph them automatically.
  115.                              Press PgDn for more help.
  116.                    DRAWING THE GRAPH
  117.  
  118. Once you have entered an equation that parses successfully and pressed enter,
  119. Graphmatica will proceed to graph it. To interrupt a graph when the computer
  120. is in the process of drawing it, hit any key and the program will display on
  121. the bottom line the message:
  122.    "PAUSE at x=#, y=#. Press ESC to quit, any other key to restart.. "
  123. where # indicates the x and y coordinates you stopped it at. If you mistyped
  124. the equation and want to fix it, just press ESC. Be patient! Graphmatica may
  125. need a while to produce a quality graph on a slower machine. To speed up the
  126. graphing, you may want to select a lower Fineness value.
  127.  
  128. When the graph for your equation is complete, the blinking cursor will
  129. reappear in the equation editor. If you'd like to type in a completely
  130. different equation, press ESC to clear the input field. If you'd rather modify
  131. the last equation, go right ahead; it's already stored in the redraw queue.
  132. Or modify any previously entered equation by pressing the down arrow key (or
  133. clicking on the down arrow next to the editing field) to drop down the
  134. equation queue listbox and then selecting an equation from the redraw queue.
  135. You can then redraw this equation by pressing enter, or modify it to create a
  136. new equation. To access Graphmatica's other features, press Alt to raise the
  137. menu, or click on the menu with the mouse.
  138.                       Press PgDn for help on inequalities.
  139.                  GRAPHING INEQUALITIES
  140.  
  141. You can graph rectangular-coordinate inequalities by replacing the '=' with
  142. '<' or '>' for many simple functions and relations. This feature is presently
  143. only available for cartesian graphs. (Also, since the free variable 'a'
  144. implies that more than one curve will be drawn, equations containing 'a' are
  145. incompatible with inequalities, and the parser will not accept any inequality
  146. that uses 'a'.)
  147.  
  148. The region that solves the inequality is hatched in with the graph color. (The
  149. curve itself is not actually dotted to indicate a strict inequality, however,
  150. so '<' is effectively "less than or equal to".) In most cases, asymptotes are
  151. detected and a boundary added there as appropriate, so graphs like "y < tan x"
  152. and "xy > 1" are drawn correctly. In addition, the valid domain of the
  153. function being graphed is detected automatically, so "y > log x", for
  154. instance, shades only the first and fourth quadrants.
  155.  
  156. To accommodate intersecting regions, the graphing routine alternates between
  157. '\' and '/' hatching. Best results will be obtained when you graph no more
  158. than two inequalities on the same screen; a region MAY SHADE INCORRECTLY if
  159. another graph of the same color intersects it. If you have problems with
  160. shading "leaking out," increasing the fineness should help.
  161.                       Press PgDn for help on polar graphs.
  162.             EXTENDED GRAPH FUNCTIONS: POLAR GRAPHS
  163.      Polar  coordinates are a fundamentally different approach to representing
  164. curves in 2-dimensional space.  If you have never used polar  coordinates  and
  165. want to understand them, you should read Section III in the manual first.
  166.     To make  a graph using polar coordinates,  we calculate a distance to plot
  167. out  from  the  origin as we  let theta ("t")  sweep around  in  the  positive
  168. direction.   The default domain is 0 to 2pi (the first complete circle in  the
  169. positive  direction),   but  you  can  easily  change these  values  using the
  170. T  range  function  [see View help file].  Polar graphs  are  entered  in  the
  171. equation editor just like normal graphs. The only difference in what you type,
  172. and how Graphmatica detects a polar graph,  is that you must use the variables
  173. 't'  and 'r' instead of 'x' and 'y'. The restrictions are still the same:  you
  174. can have one and only one instance of the dependent variable 'r' but it can be
  175. located almost anywhere in the equation.  Watch as your graph is drawn;  often
  176. the  direction  it is going is as important as the figure it  draws.    (In  a
  177. "double" equation of "r^2", first the positive and then the negative roots are
  178. drawn; they should be drawn simultaneously but it isn't practically possible.)
  179.     The  x  and  y coordinate ranges and the  range  for theta  are completely
  180. independent;  in normal Cartesian graphing,  Θ's value is irrelevant,  and  in
  181. polar graphing,  Θ  controls the domain of the graph,  but the x and y  ranges
  182. still control the physical screen you see.  If you want to change your view of
  183. a polar graph, use the scale or range functions just as you would normally.
  184.                      Press PgDn for help on parametric graphs.
  185.           EXTENDED GRAPH FUNCTIONS: PARAMETRIC GRAPHS
  186.     (For  a  full  explanation of parametric graphing,  read  Section  III  in
  187. the manual.  This section  just shows  how to  enter parametric graphs.)  In
  188. parametric graphing, the cartesian x and y coordinates are calculated based on
  189. a third variable (the "parameter" of x and y)  called  't' (not to be confused
  190. with the 't' used to represent theta). T is allowed to increase from the start
  191. of the domain you specify to the end.  At each value,  the functions x(t)  and
  192. y(t) are  calculated to  give an  (x,y) coordinate which is drawn. Graphmatica
  193. then connects these  points to form a  smooth curve -- if something  you graph
  194. looks jagged, you probably need to adjust the fineness. (See Options help)
  195.     To  enter a parametric graph,  you need to remember four basic parts:  the
  196. x(t) and y(t) functions,  the semicolon between them (this is how  Graphmatica
  197. knows you're entering a parametric graph), and the domain for t.
  198.                semicolon   y-function
  199.                      
  200.       x-function -> x =  2t  ;   y =  2t^2   {-10, 10} <- domain
  201. You don't need to solve for x and y (5x=t is OK), but only one x and one y can
  202. appear  in the whole equation,  and "double"  equations like "x^2=t"  are  NOT
  203. supported  (if you enter them only the positive root will be found).  You MUST
  204. specify  a domain for each parametric equation!  Some curves (like those based
  205. on  sin and cos)  work best over a {0,2pi} domain,  like polar graphs.  Others
  206. match  the default domain of normal graphs better.  If you estimate the domain
  207. wrong, abort the graph and edit it.      Press PgDn for help on differentials.
  208.         GRAPHING APPROXIMATIONS OF DIFFERENTIAL EQUATIONS
  209.  
  210. Graphmatica also allows you to approximate the solutions of first-order
  211. differential equations. To let the parser know you want to graph a
  212. differential equation, you must include the differential "dx" (which actually
  213. represents dx/dt) as one of your variables. If you specify an equation as
  214.                   dx = f(x,t)
  215. where f(x,t) is some combination of the variables x and t (such as "x^3 + t")
  216. and do NOT include the domain operator "{ , }", the program will draw a slope
  217. field for dx/dt = f(x,t). t is the horizontal axis, and x the vertical.
  218.  
  219. If you do include the domain operator {m, n}, it will not be interpreted as a
  220. domain but will instead indicate that you want to graph a specific solution to
  221. the initial-value problem x(m)=n by Runge-Kutta approximation. This deviation
  222. from the normal notation is only valid for differentials.
  223.  
  224. In addition, you can specify an initial value by moving the crosshairs around
  225. with the arrow keys or mouse. Type in an equation to add an IV to or select an
  226. equation to modify and choose the Set IV option from the Point menu. Move the
  227. cursor to the desired location and press enter or click the left mouse button
  228. to add the initial value point to the selected equation. Then press enter in
  229. the equation editor to graph the solution.
  230.                     Press PgDn for help on Error Messages.
  231.                 ERROR MESSAGES
  232.  
  233. 17 error messages may be encountered when graphing. Twelve of them are fatal;
  234. the equation cannot be graphed and you must edit it. They will make the
  235. computer beep so you know there is a problem. The other five apply only to
  236. specific point(s) for which a y-value cannot be generated. They will not
  237. appear unless turn the Warnings option on, and then appear silently.
  238.  
  239. [Please note that all warning messages which refer to the variables 'x' or 'y'
  240. will actually be 't' or 'r' when you are dealing with a polar equation.]
  241.  
  242. "Please type an equation (or select from the listbox); then press ─┘ to
  243. graph."
  244.     You pressed enter on the graph line without selecting or typing in an
  245.     equation.
  246.  
  247. "No equals sign or more than one found. Press any key to edit the equation."
  248.     To be a valid and graphable, your equation must include exactly one equals
  249.     sign ['=']. If you get this error, you either left out the '=' or
  250.     accidentally typed two or more of them. For parametric equations, there
  251.     must be an '=' on each side of the dividing ';'.
  252.  
  253.                        Press PgDn for more error messages.
  254.                ERROR MESSAGES continued
  255. "One or both sides of equation evaluated to nothing. Please edit your
  256. equation."
  257.     Make sure there is some sort of expression on each side of the equation.
  258.     Obviously, an entry like "y=" can't produce a meaningful graph.
  259.  
  260. "Inequalities only supported for rectangular equations. Replace < or >
  261. with =."
  262.     Inequalities cannot presently be evaluated for polar, parametric, or
  263.     differential equations. You may still be able to draw the graph if you can
  264.     express the inequality in rectangular form.
  265.  
  266. "Found bad operation or mismatched parentheses. Press any key to edit..."
  267.     You equation had different numbers of open and close parens, was missing
  268.     an operand for a binary operation, or included something else the parser
  269.     couldn't digest (like parentheses around the entire expression). Examine
  270.     your equation carefully and fix whatever seems to be the problem.
  271.  
  272. "Initial value must be on screen to graph an ode. Modify grid or equation's
  273. IV." Since an initial-value approximation that doesn't start in the visible
  274.     grid may never encounter it, Graphmatica tries to avoid this situation.
  275.     Simply move the IV point or modify the grid so that it is on screen.
  276.                        Press PgDn for more error messages.
  277.                ERROR MESSAGES continued
  278.  
  279. "Missing required argument to function. Press any key to edit the
  280.  equation."
  281.     The parser couldn't find any expression to use as the argument for a
  282.     function, like cos(x). All functions require one argument following the
  283.     function name, preferably enclosed in parentheses.
  284.  
  285. "Found unknown variable or function. Press any key to edit the equation."
  286.     Check that your equation contains only valid identifiers (see the
  287.     functions and variables tables in the Graph help file) and that you
  288.     separated each of them with an operator, space, or some other punctuation.
  289.  
  290. "No dependent variable or more than one 'y' found. Please edit your equation."
  291.     Although Graphmatica can isolate ONE 'y' variable and graph some
  292.     relations, it cannot graph an equation without a 'y', like "x=4". It also
  293.     cannot perform the factoring needed to isolate the variable 'y' (or 'r')
  294.     when it occurs more than once (i.e. "x=y^2+3y"). If you can adjust the
  295.     equation so it uses only one 'y', do so; otherwise it can't be graphed. In
  296.     parametric graphing, this message may also indicate that no 'x' variable
  297.     was found in the x(t) equation.
  298.  
  299.                        Press PgDn for more error messages.
  300.                ERROR MESSAGES continued
  301.  
  302. "Can't find the inverse of this function of y. Press a key to edit equation."
  303.     You tried to graph an equation like "int(y)=x" or "abs(y)=x" for which y
  304.     cannot be isolated by taking the inverse of the function. The functions
  305.     which cannot be isolated are "abs", "cosh", "sinh", "tanh", and "int". If
  306.     you can't adjust the equation so this error does not occur, it is not
  307.     graphable.
  308.  
  309. "Parametric equation requires that you specify domain! See 'Graph' help file."
  310.     You typed in a parametric equation (or accidentally hit the semicolon) and
  311.     neglected to include a closed domain [like {1,6}]. Because the diversity
  312.     of parametric equations makes it hard to pick a default domain, you have
  313.     to include one with each parametric graph. See Sections I and III in the
  314.     manual for help on entering a domain and parametrics.
  315.  
  316. "Domain did not evaluate to a constant value. Press a key to edit equation."
  317.     The domain you entered either could not be parsed, or was found to contain
  318.     a non-constant identifier, like x or y. Valid domains must have at least
  319.     one side of the range defined and can't contain variables, although any
  320.     other expression that evaluates to a constant is OK.
  321.  
  322.                     Press PgDn for warning error messages.
  323.                 WARNING ERROR MESSAGES
  324. "Overflow at x=#.##."
  325.     Some  function or operation  generated a number  too large to  fit into an
  326.     eight-byte floating point variable. The point at x=#.## was not graphed.
  327.  
  328. "Division by zero at x=#.##."
  329.     At #.## your equation attempted division by zero so the point was skipped.
  330.  
  331. "Can't raise a negative number to a fractional power. [x=#.##]"
  332.     Due to the possibility of getting an even root of a negative number, the C
  333.     Library pow()  function  refuses to process any arguments like these.  The
  334.     portion of your graph (if any) where the base is not negative or the power
  335.     is not fractional should be graphed perfectly. This error also occurs when
  336.     you take the square root of a negative number with the "sqr" function.
  337.  
  338. "Can't find the logarithm of a negative number. [x=#.##]"
  339.     The natural logarithm (ln) and base 10 logarithm (log) functions are
  340.     defined only on x greater than zero.
  341.  
  342. "Domain error: asin/acos functions defined only on -1≤x≤1. [x=#.##]"
  343.     The arcsine (asin) and arc cosine (acos) functions are only defined
  344.     between -1 and 1 (the range of the sin and cos functions).
  345. ──────────────End of Graphing help. Press ESC to return to menu.──────────────
  346.