home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsf / graph2 / graph.doc next >
Text File  |  1993-06-14  |  12KB  |  210 lines
  1.        GRAPH - Graph Plotting Application For the Psion Series 3
  2.        ---------------------------------------------------------
  3.  
  4. By Gregory Essex-Lopresti
  5.    24 Paxton Close
  6.    Matlock
  7.    Derbyshire
  8.    DE4 3TD
  9.  
  10.    ba95001@black.ox.ac.uk
  11.    essexlgj@ibm18.balliol.ox.ac.uk
  12.  
  13.  
  14. Version 2.12 User Instructions
  15. ------------------------------
  16.  
  17. ---------------------------------------------------------------------------
  18.  
  19. Outline: GRAPH was originally written shortly after the beginning of my
  20.          second term at university. It's purpose was to allow me to quickly
  21.          check the results of my physics practicals without the need to
  22.          walk ALL the way over to the computer room and print out a graph
  23.          on paper. Since then, I have expanded GRAPH to it's present form,
  24.          motivated by a wish for it to do more and by a wish to ensure it
  25.          is better to a program a friend wrote which is basically a rip off
  26.          of it. Of course GRAPH, the original program, is still infinitely
  27.          better.
  28.  
  29. Facilities: The program is essentially a collection of mathematical tools,
  30.             and so I will describe the various functions it offers under
  31.             the titles of their menu options. Menu's are, as usual,
  32.             obtained by pressing the MENU key. On line help is available
  33.             by pressing the HELP key.
  34.  
  35. ---------------------------------------------------------------------------
  36.  
  37. GRAPHs - Ranges: There are three graph plotting areas, or screens, in my
  38.                  graph plotting program. Each of these is independant of
  39.                  the other, and two of them are half screen size and the
  40.                  other full screen size. The Ranges option allows you to
  41.                  specify firstly which graph area you wish to adjust the
  42.                  ranges on, and then to secondly edit the current ranges
  43.                  on that graph area to your new settings. You will notice
  44.                  that Q and Y are used instead of the conventional X and Y.
  45.                  This is to avoid confusion both on your part and the
  46.                  program's part when dealing with mathematical operators
  47.                  which contain the letter X (currently only EXP()).
  48.  
  49.                  Once you have edited the current ranges, you press enter
  50.                  and GRAPH will proceed to re-plot the graph last plotted
  51.                  on the chosen graph area with the new range settings. You
  52.                  can press ESCape to abandon this plotting, as you can
  53.                  equally press escape to abandon changing the ranges before
  54.                  you press enter.
  55.  
  56.          Functions: Selecting this menu option will allow you to enter a
  57.                     function to be plotted in the graph area of your choice.
  58.                     Functions should be specified using the standard EVAL
  59.                     format (the same as the Calculator), using Q as the
  60.                     variable. eg: Y = F(Q) = exp(Q)+q**2
  61.  
  62.                     Again, pressing ESCape will cancel the function, and
  63.                     pressing enter will instruct GRAPH to start plotting
  64.                     this function on the selected graph area. Note that
  65.                     existing plots are not cleared when this happens; this
  66.                     is so that you can compare two or more plots of functions
  67.                     together on the same graph plotting area.
  68.  
  69.          Show: This menu option allows you to flip essentially between the
  70.                two half screen graph areas and the full screen graph area
  71.                (areas 1&2 and 3). This can also be achieved by pressing
  72.                simply 1 2 or 3 instead of using the menus.
  73.  
  74.          Clear: Use this option to clear and re-plot the most recently
  75.                 plotted function on any or all of the graph plotting areas.
  76.                 This option is used to `start afresh' on a graph area.
  77.  
  78.          Arrow: I'm particularly proud of this option. It allows you to
  79.                 guide a cursor on either of the two half screen graph areas
  80.                 and it displays the approximate Q,Y coordinate of the
  81.                 `cursor'. Use this option to find approximate interceptions
  82.                 of funcions with the axies or other functions etc...
  83.  
  84.                 Pressing ESCape, as ever, abandons this.
  85.  
  86.          Info: This option lists the current ranges and functions of the
  87.                three graph plotting areas. Press any key to flip through
  88.                the three sets of information.
  89.  
  90. Points - Edit Points: Before you can do anything in this menu section, you
  91.                       need to have entered some data; some points. This
  92.                       option allows you to do this. You will be prompted
  93.                       for a file name, and by default the file will be
  94.                       stored in the \opd\ directory of your default drive.
  95.                       This can be changed using the standard Psion
  96.                       techniques detailed in the user manual.
  97.  
  98.                       If you enter the name of an existing file of data
  99.                       points, you will be asked if you wish to edit them.
  100.                       If you answer yes, you can now edit and or delete
  101.                       any or all of the existing data points in that file.
  102.                       Pressing ESCape will bring you to the next stage; the
  103.                       stage you would have moved directly to if you had
  104.                       answered no just now. You can now enter further data
  105.                       points or press ESCape to finish. Note that pressing
  106.                       ESCape whilst editing existing points will often
  107.                       result in their relative order being changed; this
  108.                       has no effect on the actual data. The format is as
  109.                       follows:
  110.  
  111.                       Q Coord: The `X' coordinate of your data point
  112.                       Y Coord: The `Y' coordinate of your data point
  113.                       Err in Y Coord: The estimated error in the Y Coord
  114.  
  115.          Plot Points: This option is used to plot a file of data points
  116.                       (obviously). You can choose to use the current range
  117.                       settings on the graph area you choose to plot the
  118.                       points on, or select `auto' ranging. Also you can
  119.                       specify if you want the error in the Y coordinates
  120.                       represented proportionately or not. Finally you can
  121.                       specify if you want the function currently residing
  122.                       in the graph area selected to be plotted or not. This
  123.                       you may choose to do if, for example, you have
  124.                       programmed in a graph fit on the file of data points
  125.                       and wish to see how good the fit looks.
  126.  
  127.          Polynomial GRAPH Fit: You can ask GRAPH to attempt to fit
  128.                                polynomial functions of up to degree 8 to
  129.                                a file of data points. Note that only fits
  130.                                of up to degree 5 can be plotted; you will
  131.                                be asked if you wish to plot the fitted
  132.                                polynomial and if so which graph area
  133.                                you wish to put the resulting function in.
  134.                                When plotting points (see above) you can
  135.                                then opt to have the function plotted along
  136.                                with the data points.
  137.  
  138.          Linear GRAPH Fit: This is similar to the previous option, except
  139.                            that you get all sorts of statistical data
  140.                            on the fit that the Polynomial fit doesn't offer.
  141.  
  142.          Evaluate: Use this option to EVALUATE a function which is either
  143.                    from one of the three graph area or entered specifically
  144.                    by you.
  145.  
  146. Maths - Runge-Kutta: This option will perform numerical inte