home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / MISC / GPLOTA / GPLOT.TXT < prev    next >
Encoding:
Text File  |  1994-05-15  |  9.0 KB  |  343 lines
  1.                 Gplot
  2.                 -----
  3.  
  4.     The graph plotting and mathematical package for the Psion series 3
  5.     ------------------------------------------------------------------
  6.  
  7.  
  8. Installation
  9. ------------
  10.  
  11. Using the provided INSTALL.OPO program is recommended, however if you 
  12. wish to manually install GPLOT the following is required
  13.  
  14. Create \APP\GPLOT and \OPD\GRAPH directories
  15.  
  16. Copy GPLOT.OPA to \APP\GPLOT.OPA
  17. Copy XGPLOT.OPO to \APP\GPLOT\XGPLOT.OPO
  18. Copy GPLOT.HLP to \APP\GPLOT\GPLOT.HLP
  19. Copy SYS$HELP.OPO to \OPD\SYS$HELP.OPO (this will not appear under your 
  20. OPO icon)
  21.  
  22. Install Gplot from the system screen using Psion+I.
  23.  
  24.  
  25. Use of Gplot
  26. ------------
  27.  
  28. Gplot is shareware, this means if you use it you should register. 
  29. Registration will bring you updates for free, along with notification, 
  30. by email. Or for a minimal shipping charge by snail mail.
  31.  
  32. Gplot is not crippled in any way, your only incentive to register is
  33. your concience and the desire to persuade me to produce more
  34. software.  Registration also removes the irritating reminder that is 
  35. displayed on exit.  It is also guaranteed to give a warm glot inside! 
  36. See the Registration section in this text or the details within the 
  37. program for more information.
  38.  
  39.  
  40. Current Functions
  41. -----------------
  42.  
  43. 3 Windows for graphs, 1 full screen 2 half screen windows.
  44.  
  45. Plotting of any function that can be evaluated in "Calc".
  46.  
  47. Plotting of data points.
  48.  
  49. Linear fits of data points, with gradient, x intercept, y intercept
  50. and RMS error calculation.
  51.  
  52. Manipulation of data points by functions.
  53.  
  54. Editing, modification, deletion and display of data points.
  55.  
  56. Numerical integration of functions using simpsions rule.
  57.  
  58. Solution of equations by Newton Raphson method.
  59.  
  60. Tracing of plotted functions with cursor.
  61.  
  62. Option to add scales at user defined intervals to the graphs.
  63.  
  64. Info screen with details of graphs.
  65.  
  66. Solution of simultaneous equations for systems of up to 32 variables.
  67.  
  68. Bring to and from Spreadsheet
  69.  
  70.  
  71. Use of Gplot
  72. ------------
  73.  
  74. After installation the Graph icon will appear on the system screen,
  75. below it will be listed any data files.  These files are held in the
  76. \OPD\GRAPH directory (this will be created if it doesn't exist).  Pressing
  77. Enter on any of these files will open it and start Gplot.
  78.  
  79. The active data file will be displayed in the status window on the
  80. right of the screen, if you do not wish to use the file functions
  81. then creation of a dummy file with no data points will safeguard
  82. data.
  83.  
  84. Pressing help will bring up information on all functions, these may
  85. be accessed by any of the following methods, pressing Menu, pressing
  86. Psion+<key> where <key> is the hotkey listed to the right of the entry 
  87. in the Menu or just <key>.  Exit (Psion+X) is the only function that 
  88. cannot be accessed by a single keypress.  The Diamond key cycles through
  89. the 4 avaliable windows, it starts with just the status window avaliable,
  90. as more windows are made avaliable then these will be cycled through.
  91.  
  92. Details of the functions follow.
  93.  
  94.  
  95.  
  96. FILE
  97. ----
  98.  
  99.  
  100. New (Psion+N)
  101.  
  102. Creates then opens a new data file, closing the current open file
  103.  
  104.  
  105. Open (Psion+O)
  106.  
  107. Closes the current then opens an existing data file
  108.  
  109.  
  110. Bring Data (Psion+B)
  111.  
  112. This will bring highlighted data from the Spreadsheet into the current 
  113. data file for plotting and fitting.  The data will be echoed to the 
  114. system screen as it is copied over.
  115.  
  116. Export Data (Psion+Shift+E)
  117.  
  118. This highlights the current data file for export, the data can now be 
  119. copied into a spreadsheet file using Bring (Psion+B).  The operation can 
  120. be cancelled by pressing Esc.
  121.  
  122.  
  123. MATH
  124. ----
  125.  
  126.  
  127. Info (Psion+F)
  128.  
  129. This pops up a dialog with details of the ranges and functions of the
  130. graphs.
  131.  
  132.  
  133. Integrate (Psion+I)
  134.  
  135. This integrates a function (either from one of the graphs or
  136. specified) using Simpsons rule
  137.  
  138.  
  139. Newton-Raphson (Psion+W)
  140.  
  141. This solves equations using the Newton Raphson method, points either
  142. side of the desired root should be specified, these can be determined
  143. from the graph
  144.  
  145.  
  146. Matrix Solution (Psion+Q)
  147.  
  148. This solves sets of simultaneous linear algebraic equations, the
  149. coefficients are input in equation order,
  150. followed by the solutions to the equations.  Up to 32 variables are
  151. supported, if anyone wants to use greater than 32 variables then let
  152. me know and I'll recode it.  Good luck to you too!
  153.  
  154.  
  155.  
  156. GRAPH
  157. -----
  158.  
  159.  
  160. Plot Graph (Psion+G)
  161.  
  162. Allows a function to be plotted on one of the 3 avaliable windows. 
  163. This is any function that can be evaluated in Calc, acceptable
  164. variables are x,X,y,Y,q,Q these are all converted to q or Q for speed
  165. of calculation.
  166.  
  167.  
  168. Plot (Psion+P)
  169.  
  170. Plots the data in the current open file
  171.  
  172.  
  173. Trace (Psion+T)
  174.  
  175. This allows the function in a chosen window to be traced, keys while
  176. tracing are as follows:
  177.  
  178. With CapsLock ON or Shifted cursors
  179.  
  180.     Arrow keys move the cursor around the screen, Control jumps the
  181. cursor 5 pixels
  182.  
  183. With CapsLock OFF
  184.  
  185.     Left and Right move along the function
  186.  
  187.     Psion+Z and Psion+Shift+Z zoom in and out of the graph centred on
  188. the cursor.
  189.  
  190.     Enter redraws with the cursor now as the screen centre.
  191.  
  192.  
  193.  
  194. Ranges (Psion+R)
  195.  
  196. This allows you to set the ranges on the axis of the graphs
  197.  
  198.  
  199. Label Axis (Psion+Shift+B)
  200.  
  201. This puts tick marks on the axis at specified intervals
  202.  
  203.  
  204.  
  205. DATA
  206. ----
  207.  
  208.  
  209. Linear Fit (Psion+L)
  210.  
  211. Fits a line of best fit to the data in the current file
  212.  
  213.  
  214. Display (Psion+D)
  215.  
  216. Displays the data in the current open file
  217.  
  218.  
  219. Modify (Psion+M)
  220.  
  221. Allows a function to act on X and Y values in the current file. 
  222. There is  special case X=Y this transposes the two ranges.
  223.  
  224.  
  225. Edit (Psion+E)
  226.  
  227. Allows addition, modification or deletion of points in the current
  228. file.
  229.  
  230.  
  231. SPECIAL
  232. -------
  233.  
  234.  
  235. About (Psion+A)
  236.  
  237. Information about Gplot and registration.
  238.  
  239.  
  240. Register (Psion+Shift+R)  This only appears on the unregistered 
  241. evaluation version.
  242.  
  243. Allows entry of Name and code to Register Gplot
  244.  
  245.  
  246. Set Preferences (Psion+Q)
  247.  
  248. This allows various options to be set, if "Save graphs on exit" is
  249. chosen then then the graph functions and ranges will be saved on
  250. exit.
  251.  
  252. If the resolution is increased the pixel jump between recalculations
  253. will be increased, greatly increasing the speed of plotting, but
  254. decreasing the number of points plotted so reducing the accuracy of
  255. highly oscillatory functions.  A resolution of 4 or 5 is recommended as 
  256. being a reasonable compromise between speed and accuracy.
  257.  
  258.  
  259. Close Windows (Psion+Shift+K)
  260.  
  261. This destroys all currently open graph windows, recovering the memory 
  262. used by them.  To hide the windows the Diamond key can be used to cycle 
  263. through different views.
  264.  
  265. Exit (Psion+X)
  266.  
  267. Close open files and exit Gplot.
  268.  
  269.  
  270.  
  271. Disclaimer
  272. ----------
  273.  
  274. Although I have fully tested this program and see no reason why it should
  275. cause problems I would still like to issue the following disclaimer. 
  276. This program is used entirely at the users risk, and any fault or
  277. loss of data caused by the use of this program will be the 
  278. responsibility of the user and no liability will be placed upon M.Millar.
  279.  
  280.  
  281. Registration
  282. ------------
  283.  
  284. Registration costs £15 in the UK or $25 in the US, US registration is by 
  285. the GO SWREG service on CompuServe.  UK registration can be made by 
  286. cheques payable to "M.C.Millar" and posted to 
  287.  
  288. M.C.Millar
  289. The White House
  290. 28 Water End
  291. Clifton 
  292. York
  293. YO3 6LP
  294. United Kingdom
  295.  
  296. Credits
  297. -------
  298.  
  299. Thanks to David Wood at Psion for the assistance with the use of the OO 
  300. programming for the EVAL speed enhancements.  Tom Dolbilin for the OPL 
  301. help system, this can be used with other OPL programs, mail myself or 
  302. Tom on CompuServe or CIX (Tom : Compuserve 72730,1176 Me : Compuserve 
  303. 100021,3354 or millar@cix.compulink.co.uk) for more details.  Dennis 
  304. Lefebvre for the loan of the S3a programming manual before I had my S3a.
  305. All my beta testers, and all the users that have registered and come up 
  306. with recommendations for new features in Gplot.
  307.  
  308.  
  309. History
  310. -------
  311.  
  312.  
  313. Version 0.82-0.83, added Escaping from graph plotting
  314.  
  315. V0.83-0.83.1, Fixed the jump to graph plot after linear fit.
  316.  
  317. V0.83.1-.2, Fixed the bug with -ve RMS means
  318.  
  319. V
  320. 0.83.2-.3, Added x intercept display to Linear fit.
  321.  
  322. V0.83.3-.4, Fixed bug with plotting fitted graphs to windows other
  323. than Full screen.  Speeded up graph plotting by reducing number of
  324. significant figures to be parsed.
  325.  
  326. V0.83.4-.5, Added option to set X ranges before autoranging
  327.  
  328. V0.83.5-.6, Code refinements, commenting of code
  329.  
  330. V0.83.6-1.0, Made Gplot a type 2 APP, added trace, scales, zooming
  331. functions, Simultanous equation support, further commenting and
  332. algorythm improvements.  Shareware now. Reorganised Menus to be more 
  333. Psion compliant.
  334.  
  335. V1.0-1.1 Fixed problem with directory creation on startup and new
  336. file from system screen creation.  Translated mdified S3a version.
  337.  
  338. V1.1-2.0a Major speed revision with optimizations for S3a use, including 
  339. enanced EVAL parsing.  Added diamond key handling, added link paste 
  340. between Spreadsheet and Gplot.    Registration handling.    Included use of 
  341. Tom Dolbilin's SYS$HELP.OPO for help system.
  342.  
  343.