home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine 1996 / ARCHIVE_96.iso / discs / shareware / share_38 / graph_draw / !GraphDraw / Resources / EditHelp < prev    next >
Text File  |  1993-11-29  |  9KB  |  340 lines
  1. Information is available on:
  2.  
  3.   What This Software Does
  4.   Entering Data
  5.   The Graphdraw Edit Window Menu
  6.   Graph Window Menus
  7.   Further Information
  8.  
  9.   WIMP Key Presses
  10. ________________________________________
  11.  
  12. Note that if any read me files are
  13. supplied as part of this application,
  14. they may have more recent information
  15. than is contained in this file.
  16.  
  17. GraphDraw is ⌐ Chris Johnson, 1992
  18. ________________________________________
  19.  
  20. This application provides interactive
  21. help when the !Help application is
  22. active.
  23. ________________________________________
  24.  
  25. What This Software Does
  26.  
  27. It allows the entry of the x and y
  28. values for a number of data, and the
  29. data may then be fit to
  30.  
  31. a. best straight line
  32. b. best parabola
  33. c. a cubic spline curve
  34. d. a polynomial of order up to 6
  35.  
  36. A number of options for obtaining
  37. various forms of hard copy exist
  38. (saving as a !Draw file, or printing via
  39. any standard RISC-OS printer driver).
  40.  
  41. ________________________________________
  42.  
  43. Entering Data
  44.  
  45. Clicking SELECT on the iconbar icon will
  46. open an empty edit window, into which
  47. the pairs of x,y data may be entered.
  48. This version allows a maximum of 200
  49. data point pairs.
  50.  
  51. Full scrolling and editing facilities
  52. are available during data entry, by
  53. means of the arrow keys, either alone or
  54. in conjunction with SHIFT or CTRL. Page
  55. up/down are the same as SHIFT+arrow. One
  56. useful key combination is
  57. CTRL+SHIFT+COPY, which will delete the
  58. data point at the cursor and close up
  59. the rest of the data.
  60.  
  61. The function key f3 will bring up the
  62. standard save as dialogue box (this is
  63. provided also as a menu choice). 
  64.  
  65. Double clicking on a GraphDraw data file
  66. or dragging a data file either into the
  67. edit window, or to the iconbar icon will
  68. load the data, overwriting any data that
  69. had previously been entered.
  70.  
  71. Besides files in GraphDraw format, files
  72. of file type text, data or CSV can be
  73. loaded by dragging into the edit window
  74. or onto the iconbar icon. In some cases,
  75. if the file does not start with the
  76. standard graphdraw header, a query
  77. window will open for confirmation before
  78. loading the file.
  79.  
  80. Data can also be passed in either
  81. direction between the GraphDraw edit
  82. window and a !edit window. Thus editing
  83. can be carried out using the !edit
  84. application if preferred. Data can be
  85. entered 'from scratch' using !edit, and
  86. then transferred to the !GraphDraw
  87. application (by dragging a save icon to
  88. its edit window or its iconbar icon), as
  89. long as the !GraphDraw application can
  90. recognise a valid data file. This
  91. version of !GraphDraw now supports
  92. direct RAM transfer for all its loading
  93. and saving operations.
  94.  
  95. As the graphdraw application will deal
  96. with files of comma separated ASCII data
  97. it is possible to set up other
  98. applications to produce data files of
  99. the correct form.
  100.  
  101. Error Bars
  102. If the Error bars icon at the bottom of
  103. the edit window is selected by clicking
  104. on it, the edit window will be extended,
  105. allowing access to two further columns
  106. of data. These are for use in entering
  107. error limits to the points. The minimum
  108. y limit and maximum y limit for each
  109. point may be entered. When the graph is
  110. plotted, the error bars corresponding to
  111. these limits will be plotted.
  112.  
  113. In some cases it may be sufficient to
  114. use a constant fraction for the error
  115. bars. This may be done very simply by
  116. entering the percentage error, e.g. 10,
  117. into the writable icon, and then
  118. clicking on the "Calc constant %" icon.
  119. The calculated values will then be
  120. written into the tables of data.
  121.  
  122. If the error bars icon is deselected,
  123. the edit window will contract to the
  124. normal size, and the error bars will not
  125. be plotted. The data is retained, and
  126. may be plotted again by reselecting the
  127. error bars icon.
  128. ________________________________________
  129.  
  130. The GraphDraw Edit Window Menu
  131.  
  132. All of the data processing and data
  133. display facilities are accessed from the
  134. edit window menu.
  135.  
  136. Clicking the 'menu' button in the edit
  137. window brings up the following choices.
  138.  
  139. Info
  140.  The standard information window.
  141.  
  142. Help
  143.  Opens this help window.
  144.  
  145. Clear data
  146.  This will irretrievably clear the
  147. current data prior to the entry of new
  148. data. Graphdraw asks for confirmation
  149. before clearing the data.
  150.  
  151. Save file
  152.  Data files may be saved by dragging the
  153. save icon to a directory viewer. If the
  154. full path name is set up, then you can
  155. also click on the OK icon to save the
  156. data.
  157.  
  158. The function key F3 can be used as a
  159. short cut for this option (unless the
  160. graph window is open, when F3 will bring
  161. up the "save drawfile" dialogue box).
  162.  
  163. It is also possible to drag the save
  164. icon to a !Edit window, or to the !Edit
  165. icon on the iconbar. The data is then
  166. transferred into !Edit.
  167.  
  168. Plot points
  169.  This will simply plot a scaled graph of
  170. the data. Additional sub-menu choices
  171. allow you to plot the data as is, as
  172. semi-log x, semi-log y or as a log-log
  173. plot.
  174.  
  175. Join points
  176.  This plots the points and joins each
  177. point to the next with a straight line.
  178. The log plotting options are available
  179. as above.
  180.  
  181. Best line
  182.  This will carry out a standard linear
  183. regression by the least squares method
  184. to calculate the best fit straight line
  185. through the data. A window will open
  186. displaying the slope, intercept on y
  187. axis, correlation coefficient and the
  188. standard errors of the slope and
  189. intercept. Clicking 'menu' in this
  190. window allows the following choices.
  191.  
  192.    Graph
  193.    -----
  194.    This will display a graph of the data
  195. points with the calculated best line
  196. superimposed. Clicking 'menu' in the
  197. graph window then leads to a further set
  198. of options.
  199.  
  200.    Print data
  201.    ----------
  202.    This will send the results of the
  203. calculation to any printer connected to
  204. the computer. The individual errors
  205. calculated for each data point are also
  206. printed.
  207.  
  208. Parabola
  209.  This will carry out a least squares fit
  210. of the data to the equation of a
  211. parabola
  212.  
  213.       y = u + vX + wX^2.
  214.  
  215. This is a useful technique for fitting
  216. data to a simple curve. A window will
  217. open showing the calculated values of
  218. the coefficients u, v and w. Clicking
  219. 'menu' in this window will bring up the
  220. same two options as described above,
  221. i.e. graph and Print data.
  222.  
  223. Polynomial
  224.  This will carry out a standard
  225. polynomial fit for orders 3 to 6. Some
  226. of the higher order options may be
  227. greyed out if there are not enough data
  228. points. Selecting a particular order
  229. will force the program to calculate that
  230. specific order polynomial, whereas if
  231. 'All' is selected, the program will try
  232. all possible orders (3 to 6) and report
  233. the one which gives the smallest
  234. deviation. A window will open showing
  235. the results of the calculation, and
  236. clicking 'menu' on this window leads to
  237. the same options as above.
  238.  
  239. Cubic spline
  240.  This option leads to a small dialogue
  241. box, which at present simply requests
  242. the 'fit factor' to be specified. This
  243. value must lie BETWEEN 0 and 1. In
  244. theory, a value of 0 will plot a
  245. straight line through the points, while
  246. a value of 1 will force the curve
  247. through every point. In practice these
  248. values cannot be used, since a divide by
  249. zero error is generated during certain
  250. matrix inversion operations. Little is
  251. lost since a value of 0.9999 or 0.0001
  252. will give essentially the same result as
  253. 1 or 0. Curve fitting is always very
  254. subjective, and it is up to the user to
  255. decide the degree of smoothing
  256. acceptable for any particular set of
  257. data. A value of 0.5 is an obvious
  258. starting point for any data known to
  259. have scatter or experimental error.
  260.  
  261. Once <return> is pressed, the spline
  262. plot will be displayed. For this plot,
  263. it requires all the data to be sorted in
  264. order. The program automatically sorts
  265. the data in ascending order of x values
  266. before carrying out the spline routine.
  267. Note that this sorting occurs whenever
  268. any of the plotting routines are used.
  269.  
  270. Transform X
  271.  Allows the x data to be transformed in
  272. a number of standard ways, e.g. LOG,
  273. reciprocal. These operations are
  274. cumulative, but it is up to the user to
  275. remember the sequence of
  276. transformations. Only the last
  277. transformation can be "undone".
  278.  
  279. Transform Y
  280.  As for transform X but on the y data.
  281.  
  282. Swap X and Y
  283.  Simply interchanges the x and y data
  284. pairs.
  285. ________________________________________
  286.  
  287. Graph Window Menus
  288.  
  289. Whenever a graph is being displayed,
  290. clicking 'menu' will lead to a further
  291. range of options.
  292. ________________________________________
  293.  
  294. Further Information
  295.  
  296. Help windows with appropriate text are
  297. also available from the Iconbar menu,
  298. and from the graph window menu.
  299.  
  300. ________________________________________
  301.  
  302. WIMP Key Presses
  303.  
  304.  Remember there are a number of standard
  305. WIMP key operations, which are
  306. summarised below. Their availability to
  307. a particular application often depends
  308. upon which application owns the caret at
  309. the time.
  310.  
  311.  In writable icons in dialogue boxes,
  312. <RETURN> usually has the same action as
  313. clicking on the default action.
  314.  
  315.  The up and down arrows move the caret
  316. on to the next or previous writable
  317. icon. If in the first or last icon, then
  318. wrap around occurs. TAB and SHIFT+TAB
  319. often behave as down and up arrow keys.
  320.  
  321. Function key F1 often invokes some form
  322. of help. With this application, if it
  323. owns the input focus when F1 is pressed,
  324. this help window is opened.
  325.  
  326. Function key F3 is often used as a short
  327. cut for the save option. In this
  328. application it brings up a "save as"
  329. dialogue box for saving the data (or the
  330. graph as a draw file, depending on
  331. whether a graph is being displayed at
  332. the time).
  333. ________________________________________
  334.  
  335. Acknowledgement
  336.  
  337. This program was compiled using the ABC
  338. BASIC compiler ver. 3 (Oak Solutions).
  339. ________________________________________
  340.