home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 229.lha / Plot_v4.1 / Plot.doc < prev    next >
Text File  |  1989-04-07  |  8KB  |  136 lines
  1.    Plot4.1, a 3-D function plotting program © 1988 by Terry W. Gintz.
  2.  
  3.    I am releasing this program as Shareware, (not into Public Domain) freely
  4. redistributable.  Enjoy using this program and pass it on to a friend.
  5. If you want to encourage the production of others like it, or need help with
  6. how it works, send me a small donation to the below address.
  7.  
  8.          Terry W. Gintz
  9.          4237 Marcum Lane
  10.          Eugene, OR 97402
  11.  
  12.    Plot4.1 is a major revision of the previous public-domain program by the
  13. same author.  The plotting is now over three times as fast (using the
  14. Motorola FFP library.)   A single window with proportional gadgets replaces
  15. most of the menus in the previous version, plus expands and adds features
  16. not available before.
  17.  
  18. About the menus and new options:
  19.    On the main menu:
  20.    New Formula calls up a formula window containing the main formula gadget,
  21. four parameter substitution gadgets and a title gadget.  The four smaller
  22. string gadgets are labeled D,E,F and G.  Use these to enter mini-formulas to
  23. use in the main formula.  Thus, D might be entered as X+Y.  The main
  24. formula could be written SIN d.  The program would then compute and plot the
  25. equivalent formula sin(x+y), which could be used in the title gadget to
  26. label the plot.  Do not use forward referencing in the sustitution gadgets.
  27. The functions d-g are calculated in real time, so d will be calculated
  28. before g.  G could be written as sin d, where d might have the formula x+y.
  29. However if d were written as sin g, where g was X+Y, the plot would appear
  30. to work, but it would jag due to inaccurate data on the previous pass. For
  31. the same reason recursion does not work.  Use of square root should not be
  32. embedded in a mini-function.  If d = SQR x and e = 2d and the main formula
  33. is Sin E only the positive values of SQR x will be plotted.
  34.    Stop Plotting halts the drawing after New Plot or New
  35. Formula have initialized a new drawing cycle.
  36.    Use erase screen to clear the background before drawing a new plot.
  37. The screen is not cleared automatically before each plot to allow one to
  38. compare similiar plots side-by-side.  The plot title is printed on the screen
  39. for subsequent plots one line up from the previous one, until the screen is
  40. erased.  The title will then be drawn at the bottom left of the screen.
  41.    Use save function to save a configuration for future recall.  This saves
  42. all the slider options described below, all the substitution formulas and
  43. the main formula plus the plot title, so that unusual plots can be easily
  44. shared between Plot users.
  45.    Load function loads a previously saved function configuration.  After
  46. the file is loaded, the set-options window is displayed.  Click on Okay to
  47. set the new options.  Then the formula window is shown.  Click on Okay to
  48. set the new formula.  Use New Plot to show the new function.
  49.  
  50.    The 'Set Options' window called up by the second menu, contains 13 slider-
  51. type gadgets for setting up variables to handle most plotting requirements.
  52.  
  53.    Spin defines the amount of x axis rotation, and tip defines the
  54. amount of y axis rotation used in displaying the plot.  Defaults are 205°
  55. and 155°, respectively.  Z-Axis is normally perpendicular to the other
  56. planes, or 90°.  Vary for special effects.  Limits are 0 to 360 degrees for
  57. each axis.
  58.  
  59.    Magx and Magy determine the overall magnification on the x and y
  60. dimensions.  Some formulas require more or less magnification to view well.
  61. Limits are .1 to 100X.
  62.  
  63.    X Steps and Y Steps determine the spacing between dots and rows on the
  64. screen.  Vary 1-300 for increasing resolution.  Generally a much smaller
  65. number of Y steps than X Steps is required for clarity.  Use 1 step to see
  66. the function in two rather than three dimensions.
  67.  
  68.    Minx, Miny, Maxx, Maxxy are the ranges for the loops that determine which
  69. numbers (angles) are scanned to produce the plot.  Provision is made for PI
  70. -PI, -2*PI and 2*PI on the sliders, so accurate plotting can be made on trig
  71. functions.  Limits are -20 to 20 radians.
  72.  
  73.    Minz and Maxz set the maximum z factor.  This is usually the value of the
  74. main formula before scaling occurs.  Therefore, it is possible to plot cones
  75. that look like textbook examples without the exponential curl at the edges.
  76. Limits can be set from -50 to 50.
  77.  
  78.    When plotting new formulas with 'New Plot' and 'New Formula' use the
  79. green cursor to locate the plot on the screen, clicking the left mouse
  80. button to start plotting.
  81.  
  82.   Use 'New Formula' to enter your own formula.  The program
  83. treats parenthesis as blank space. The trig functions translated include
  84. sine, arc sine (asn),cosine, arc cosine (acs), tangent, and arc tangent(atn).
  85. The math functions are *,-,/, and +, plus SQR (square root).
  86. Note:  Range limits may exist for arc sine, arc cosine and arc tangent.
  87. The Manx limits are 0 to pi for arc cosine, -pi/2 to pi/2 for arc tangent
  88. and arc sine. If you use a loop range greater than this, the function could
  89. return an arbitrary value.  (These are the ranges specified by Manx for its
  90. standard arc functions.  The FFP library may have different limits.)
  91.  
  92.    Syntax for an acceptable formula is AS([XY])+bs([xy])...
  93. .up to 60 characters per formula.  Also, SQR(formula) is acceptable.
  94.   The below information applies to the main formula as well as
  95. mini-formulas.  However, bear in mind the mini-formulas were added to
  96. overcome some of the limitations of original plot parser.
  97.   The squareroot function "SQR" is available for use in formulas
  98. on a limited basis.  "SQR" must be the first 3 characters in any formula
  99. that uses it, and the parser interprets this as meaning the square root
  100. of the entire formula.  That is, it calculates everything else in the
  101. formula first, then takes the square root of it.  It is thus possible to
  102. plot much more intricate functions, like "SQR(atn(x)*cos(x)+cos(y))"!
  103. However, the function "SQR(sin(x))+sin(y)" would be interpreted as
  104. "SQR(sin(x)+sin(y))"!
  105.  
  106.    A and B are optional constants, 0 to 9, (no floating point
  107. supported; a number over 9 is treated as two or more numbers multiplied --
  108. hence 99 = 9*9 or 81 to the parser),
  109. S is an optional trig function (1 or three letters, the first letter will 
  110. work, except with the arc functions and square root--use the 3 letter
  111. abbreviations above.)
  112. X and Y are the standard variables (or use d-g in place of parenthesis
  113. with the additional string gadgets).
  114. The '+' could be any of the four math functions.
  115. Parenthesis is treated as blank space, but useful for titles--
  116. therefore cos(x)*cos(y) works as well as cx cy
  117. but cos(x+y) doesn't work.  Use the equivalent formula cos x cos y - sin x
  118. sin y.
  119.    Use the math operators mainly to separate expressions of a complex
  120. function, such as x/2 - sin y.  Use of math operators inside trig
  121. expressions is not supported.  However, some limited multiplication inside
  122. factors can be done using implied multiplication, such as 2 sin 2xy.
  123.    Note: the expression 'x*x+y*y' doesn't work because the parser
  124. interprets this as '(xx+y)*y', (use 'xx+yy').  Don't nest trig functions.
  125. 4x*cos(x)+tan(x) works as well as 4xcx+tx,
  126. but tan(cos(xy)) doesn't work.
  127.    Use Line Plot to produce a plot that connects the space between dots.
  128. Generally, you reverse the amount of x and y steps from a point-by-point
  129. plot.  The advantages of a line plot are a faster plot(though cruder with
  130. fewer steps), and more continuity (some plots do not become continuous
  131. even with the maximum number of steps on a point-by-point basis.)
  132.    Use Two Pass to plot a cross pattern on the previous one to enhance
  133. viewability on some plots.
  134.  
  135.  
  136.