home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1B / DATAFILE_PDCD1B.iso / _pocketbk / pocketbook / 003 / trace_zip / TRACE.DOC next >
Text File  |  1994-05-03  |  6KB  |  105 lines
  1.                 Readme file for Trace v1.0
  2.  
  3. Trace is an OPL plotting program which is intended to add to the Psion 3a
  4. the graphical features that are surprisingly missing in the built-in
  5. calculator. Trace is a freeware, so you can use it and distribute it freely.
  6. To install it, just drop the Trace.opa file in the \APP directory and install
  7. in the system as usual. Created dumps or bitmaps files will appear in \OPD.
  8. Trace occupies 13 Kb of disk space, and requires a minimum of 25Kb of RAM.
  9. If you find it useful, please let me know at the following e-mail address:
  10. perroud@messv1.univ-pau.fr.
  11.  
  12. Trace was developped on a french version of the Psion 3a system, and is
  13. "speaking" french. It has not be tested on other versions. I decided to
  14. keep its native language to emphasize the existence of non-english users
  15. and fans of this marvelous little thing. I think that even non french-
  16. speaking Psion users can easily take advantadge of it. If this is not the
  17. case, I may consider to translate it into an english version, so let me
  18. know your feelings through my e-mail address.
  19.  
  20. Trace can plot either mathematical functions or 2D data stored in a text file,
  21. or combinations of both types of graphs. The functions are input from the
  22. keyboard, and can use only OPL valid expressions, since the actual calculation
  23. is done through OPL eval() function. When entering the function, each occurence
  24. of the variable (say x) should be replaced by a pair of brackets (). The
  25. function is evaluated at regular intervals, according to the value of xmin,
  26. xmax and the number of points. Predefined defaults value are 51 points between
  27. x=0 and x=1. These values can be changed through the Axes and Options menus.
  28. The datafiles should be text files organized in tab separated columns,
  29. containing pairs of x and y values. The file can consisted of more than two
  30. columns; when entering the data, the column number can be choosen for x and y.
  31. There is no requirements on the order of the data columns. When reading the
  32. file, xmin and xmax are automatically set to the actual limits of the data.
  33.  
  34. Trace proposes 5 types of graphs, which correspond to the 5 items of the
  35. first menu (Trac‰):
  36. - Trac‰ fonction: allows to plot a function entered at the keyboard with
  37. the preset x range and number of points.
  38. - Trac‰ donn‰es: allows to plot a 2D datafile with symbols and connecting
  39. lines if desired.
  40. - Mod•le num‰rique: allows to plot together a datafile and a model curve
  41. given by a set of x-y pairs in a second text file. The format of the model
  42. text file is the same as the format of the datafile. The x range of the
  43. plot is set by the x range of the datafile, whatever the x range of the
  44. model file.
  45. - Mod•le analytique: allows to plot together a datafile and a model curve
  46. given as a function and entered at the keyboard in the same manner as the
  47. simple function. In that case, the function is evaluated in the x interval
  48. defined by the datafile.
  49. - Fit polynome: allows to plot together a datafile and a model curve given
  50. by the best fit polynomial function, calculated by a least-squares method.
  51. The degree of the polynom can be fixed between 1 (linear fit) and a maximum
  52. of 6 (limited for performance considerations). Once calculated, the best fit
  53. function is proposed as the default function in the other function plots.
  54.  
  55. Apart from the plots, Trace proposes a few other utilities, like saving the
  56. plot in a PIC file, saving the values calculated for the functions in a text
  57. file, or getting from the screen the x-y coordinates of any point. This last
  58. feature is available only after a plot has been done, and is started by the
  59. diamond key. A cursor is displayed and can be moved with the arrows. The
  60. increment of motion can be adjusted by the psion-arrows combinations. When
  61. the cursor is positionned, the x-y coordinates are displayed by the enter
  62. key. The esc key allows to cancel the operation.
  63.  
  64. A limited help is available on line using the Help key, or the Aide item of
  65. the Special menu. An abridged version of this file is then displayed. When
  66. the diamond feature is active, short help messages are also displayed when
  67. using the Help key.
  68.  
  69. Plot options:
  70.  
  71. Trace will produce a new plot each time you select one of the 5 items of the
  72. Trac‰ menu. In each dialog, previous choices will be offered as defaults, or
  73. predefined values for the first plot. The plot will then be achieved using
  74. the current values of the graphical parameters. If you want to change these
  75. parameters, use the corresponding menu items described below, and then redo
  76. the plot from the menu or its keyboard shortcut.
  77. - Axes menu items:
  78.     * Type: allows to change each axis from linear (default) to logarithmic.
  79.     * Bornes auto: When set, the y range is automatically adjusted (default).
  80.     * Borne x: allows to specify the x range of the plot (default 0-1).
  81.     * Borne y: allows to specify the y range of the plot (default automatic).
  82. - Options menu items:
  83.     * Nb points: allows to specify the number of points where the functions
  84.     will be calculated (default 51). The time required to produce a plot is
  85.     very dependant of that parameter. It was therefore limited to 1001.
  86.     * Zoom: allows to zoom in a portion of a plot. This option requires a
  87.     plot has already been made. When you select it, you have to choose on the
  88.     screen the lower left and upper right corners of the rectangle you want to
  89.     zoom in. Move the cursor to the first corner, hit enter, then move to the
  90.     second corner and enter again. The rectangle will be drawn and you are
  91.     asked for confirmation. If you confirm, the last plot will be redone.
  92.     * Preferences: allows to change some graphical parameters, including the
  93.     size of the plot, size of symbols, connecting lines or the number of
  94.     decimals in the axes labels. You have also the possibility to ask for
  95.     dumping the x-y pairs calculated for the functions plots in a text file
  96.     whose name will be trace.txt. The format of the file allows to replot it
  97.     as a datafile, what can save the time necessary to recompute these values.
  98.     * D‰fauts: switch back all parameters to their built-in default values.
  99. - Special menu items:
  100.     * Info: displays the current values of the graphical parameters.
  101.     * Aide: displays a short description of Trace main features.
  102.     * Sauve plot: dumps the current plot in a bitmap file (trace.pic).
  103.     * Quitte: quit Trace.
  104.  
  105.