home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / maths / b061_1 / !ReadMe
Text File  |  1990-03-12  |  12KB  |  463 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                     !Graph 
  8.      
  9.     Overview 
  10.      
  11.     This Risc OS application produces graphs of mathematical functions. It 
  12.     is fully multitasking and obeys Acorns rules for Risc Os applications. 
  13.      
  14.     It can graph cartesian, parametric and polar functions. 
  15.      
  16.     Axes can be manually set or automatically calculated. 
  17.      
  18.     Multiple graphs of any one type can be produced on the same set of 
  19.     axes. 
  20.      
  21.     Zooming of cartesian functions is possible by using the mouse to 
  22.     define the zoom area. This is useful for solving equations. 
  23.      
  24.     The coordinates of the pointer can be displayed for cartesian and 
  25.     parametric graphs. This is useful for identifying the position of 
  26.     features of interest. 
  27.      
  28.     Functions and axes values can be saved to disc.  
  29.      
  30.     The graphs produced can be saved as a draw file for loading into !draw 
  31.     for enhancement and for exporting to D.T.P. applications. 
  32.      
  33.     Functions are checked for errors before plotting. 
  34.      
  35.     Functions can be entered in true algebraic form. 
  36.      
  37.     A large number of inbuilt functions are provided such as hyperbolic 
  38.     trig functions and a factorial function. 
  39.      
  40.     Operation in degrees or radians. 
  41.      
  42.     The displayed graph will be scaled instantly as the display window is 
  43.     resized. This means that the full graph will be displayed irrespective 
  44.     of the window size. 
  45.      
  46.     Help messages are produced if !help is installed. 
  47.      
  48.      
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                     Page 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.     Loading 
  74.      
  75.     The application can be loaded in one of two ways. 
  76.      
  77.     1    Insert and mount the disc. Double click on the !graphs icon. This 
  78.          will install the application on the right of the icon bar. 
  79.          Clicking once with select will cause the graph window to be 
  80.          opened. 
  81.      
  82.     2    Insert and mount the disc. Double click on a graph data file. 
  83.          These can be identified by having f(x)= on their icon. 
  84.          This will cause the application to load and the graph file to be 
  85.          loaded. The graph icon will appear on the icon bar. There will be 
  86.          a pause whilst the functions are evaluated. A window will open 
  87.          and the graphs will be displayed. 
  88.      
  89.     A minimum of 200k must be available to load !graph 
  90.      
  91.     Main menu 
  92.      
  93.     The main menu can be popped up at any time by clicking menu whilst 
  94.     over the graphs window. 
  95.      
  96.     The menu has the following options:- 
  97.      
  98.     1    Save data.  
  99.          This allows the functions and axes ranges to be saved to disc. 
  100.      
  101.          Follow the arrow to the right of the menu. A standard Risc Os 
  102.          save window will appear. Enter the file name in the text box or 
  103.          change the existing name. Then either drag the file icon to a 
  104.          directory viewer or, if a full path name exists in the text box 
  105.          click on OK 
  106.      
  107.     2    Save graph 
  108.          This saves the current graph, as displayed in the graph window, 
  109.          as a draw file for loading into other applications such as !Draw 
  110.          and D.T.P.  The size of the graph saved does not depend upon the 
  111.          window size. It may be rescaled within !draw. 
  112.      
  113.          Follow the arrow to the right of the menu. A standard Risc Os 
  114.          save window will appear. Enter the file name in the text box or 
  115.          change the existing name. Then either drag the file icon to a 
  116.          directory viewer or, if a full path name exists in the text box 
  117.          click on OK 
  118.      
  119.          Files saved in this form cannot be loaded back into !graph. 
  120.      
  121.     3    Coordinates 
  122.          When selected this opens a small window which shows the current 
  123.          coordinates of the tip of the pointer in the coordinate system of 
  124.          the the current axes. This is not available with polar graphs and 
  125.          only operates when the pointer is over the graph window. This may 
  126.          be cancelled either by clicking on the close window icon for the 
  127.  
  128.  
  129.                                     Page 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.          coordinates window or by selecting it again from the menu. 
  140.      
  141.     4    Axes 
  142.          This causes the axes window to be opened, or brought to the top. 
  143.          The axes window contains information about the current values 
  144.          being used for drawing the graph. It is also used to determine if 
  145.          some of the values are to be calculated automatically. A value 
  146.          may be entered by moving to the box containing a value and 
  147.          entering the new value. 
  148.          Shaded values may not be entered since these will be calculated 
  149.          automatically. 
  150.          Clicking on the Auto Yes/No icon switches between the automatic 
  151.          calculation of axes or the manual entering of all ranges. 
  152.          Minimum values should be less than maximum values otherwise. If 
  153.          they are entered the wrong way around they will be swapped. If 
  154.          they are equal they will be adjusted. Values are given to a 
  155.          maximum of six places of decimals.  
  156.          The automatic calculation of axes values means that 
  157.          re-calculation time is somewhat longer. Automatic calculation may 
  158.          give unpredictable results if the function goes to infinity in 
  159.          the graphed region. 
  160.      
  161.     5    Functions 
  162.          This allows the function which is to be graphed to be entered and 
  163.          edited. 
  164.          The long box is used to enter the function (see the section on 
  165.          functions) 
  166.          The plot option can be set to yes or no. It must be set to yes if 
  167.          the graph is to be displayed.  
  168.          Up to six cartesian and three polar and parametric functions can 
  169.          be entered. Each function is numbered. The function displayed can 
  170.          be changed by clicking on the left or right arrow. The box at the 
  171.          top right indicates in which colour the function will be drawn. 
  172.      
  173.     6    Cartesian 
  174.          This selects cartesian functions and axes. Other types are stored 
  175.          internally. Any present cartesian functions are calculated and 
  176.          displayed. 
  177.      
  178.     7    Polar 
  179.          This selects polar functions and axes. Other types are stored 
  180.          internally. Any present polar functions are calculated and 
  181.          displayed. 
  182.      
  183.     8    Parametric 
  184.          This selects parametric functions and axes. Other types are 
  185.          stored internally. Any present parametric functions are 
  186.          calculated and displayed. 
  187.      
  188.     9    Degrees 
  189.          This selects between degrees and radian angular measure. 
  190.          This may be ticked (to indicate degrees are to be used) or 
  191.          unticked (to indicate the use of radians). Select changes the 
  192.          state of the tick. (Default not ticked) 
  193.  
  194.  
  195.                                     Page 3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.      
  206.     10   Show axes 
  207.          This selects between displaying and not displaying the axes. When 
  208.          ticked the axes will be displayed. (Default is ticked) 
  209.      
  210.     Redrawing the graphs 
  211.      
  212.     Since the redrawing of a graph takes a little while (depending on the 
  213.     complexity of the graph) the display is only recalculated when 
  214.     required. To force re-calculation press select whist over the graph 
  215.     window. The standard hour glass will be displayed whist re-calculation 
  216.     takes place. Any regions of the graph where the function evaluations 
  217.     are not possible (E.G. square roots of negative values) will result in 
  218.     slower computation.  
  219.      
  220.     Loading a file 
  221.      
  222.     With the application loaded a graph data file may be loaded either 
  223.     by:- 
  224.      
  225.     1    Double clicking on the file in a directory viewer. 
  226.     2    Dragging the file and dropping it on the !graph icon on the icon 
  227.          bar. 
  228.      
  229.     In both cases the graph data file will be loaded and the functions 
  230.     recalculated. Any previous functions will be lost. 
  231.      
  232.      
  233.     Functions 
  234.      
  235.     Cartesian functions are entered in terms of the variable x. 
  236.      
  237.     Polar and parametric functions are entered in terms of the variable t. 
  238.      
  239.     Functions can be entered in true algebraic form.  
  240.     For example  
  241.      
  242.          cos 3x sin 2x  
  243.      
  244.     will be evaluated as (cos(3*x)) * (sin(2*x)) 
  245.      
  246.     If in doubt about the order of evaluation add brackets to force 
  247.     correct evaluation order. Functions may be entered in upper or lower 
  248.     case and spaces are not important. 
  249.      
  250.     Help 
  251.      
  252.     By installing the application !help the program will give relevant 
  253.     help depending upon the position of the mouse. 
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                     Page 4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.     Operators and functions used 
  272.      
  273.     +         Addition 
  274.     -         Subtraction 
  275.     *         Multiplication 
  276.     /         Division 
  277.      
  278.     ^         is used to raise to a power. EG  x^3 for x cubed. 
  279.     DIV       The integer part of the division eg x DIV 5 
  280.     MOD       The remainder part of the division eg x MOD 5 
  281.     INT       The integer part of the following expression. eg INT x 
  282.     SGN       The sign of the expression. -1 for negative, 0 for zero 1 
  283.               for positive. 
  284.     ABS       The absolute value of the following expression eg ABS x 
  285.     PI        The constant 3.14159265 
  286.     RND       A pseudo random number in the range 0 to 1 
  287.     SQR       The square root of the following expression eg SQR x 
  288.     LN        The natural logarithm of the following expression eg LN x 
  289.     LOG       The logarithm to base ten of the following expression. eg 
  290.               LOG x 
  291.     EXP       e raised to the power of the expression. eg EXP x 
  292.      
  293.     FACT      The factorial of the expression in brackets eg FACT6 
  294.      
  295.     COSH      The hyperbolic cosine of the expression. eg COSHx 
  296.     SINH      The hyperbolic sine of the expression. eg SINHx 
  297.     TANH      The hyperbolic tangent of the expression. eg TANHx 
  298.     ARCCOSH   The inverse hyperbolic cosine of the expression. eg ARCCOSHx 
  299.     ARCSINH   The inverse hyperbolic sine of the expression. eg ARCSINHx 
  300.     ARCTANH   The inverse hyperbolic tangent of the expression. eg 
  301.               ARCTANHx 
  302.      
  303.      
  304.     The following take notice of the degree\radian mode selection.  
  305.      
  306.     SIN       The sine of the expression eg SIN x 
  307.     COS       The cosine of the expression eg COS x 
  308.     TAN       The tangent of the expression eg TAN x 
  309.     ASC       The inverse sine (arc sine) of the expression eg ASC x 
  310.     ACS       The inverse cosine (arc cosine) of the expression eg ACS x 
  311.     ATN       The inverse tangent (arc tangent) of the expression eg ATN x 
  312.      
  313.      
  314.     Zooming 
  315.      
  316.     When cartesian axes are being used it is possible to zoom in on an 
  317.     area. Move to the bottom left of the boundary of the region to be 
  318.     zoomed. Press adjust. 
  319.      
  320.     A bounding box will be drawn from where the pointer is to where the 
  321.     pointer was when adjust was clicked. 
  322.      
  323.     Move to the top right of the area so that the bounding box contains 
  324.     the area to be zoomed. Press adjust again. 
  325.  
  326.  
  327.                                     Page 5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.      
  338.     The graph will now be re-drawn with the new axes range. 
  339.      
  340.      
  341.     Saving as a sprite 
  342.      
  343.     It is usually preferable to export the graph as a draw file, it may be 
  344.     saved as a sprite by using the grab sprite option on !paint and 
  345.     grabbing the graph from the window. 
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                     Page 6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.     Note 
  404.      
  405.     The file type 777 has been used for a graph data file.  
  406.      
  407.      
  408.      
  409.      
  410.     A F Lane 
  411.     3 Lansdowne Gardens 
  412.     Hailsham 
  413.     East Sussex 
  414.     BN27 1LQ 
  415.      
  416.     February 1990 
  417.      
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                     Page 7
  460.  
  461.  
  462.  
  463.