home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine 1996 / ARCHIVE_96.iso / discs / shareware / share_49 / drawgraph / !DrawGraph / !help next >
Text File  |  1992-05-18  |  6KB  |  150 lines
  1.             !help for !DrawGraph version 1.03 (January 1992).
  2.                          ⌐ P.F.C. Groot
  3.  
  4. PURPOSE
  5. ~~~~~~~
  6. This program allows you to create different  types of graphs. Just install
  7. the program by double clicking on the !DrawGraph icon. Data files may be 
  8. dragged to the !DrawGraph icon directly, but it also possible to dump
  9. several files in the same window, so you can have multi-layer graphs. Use
  10. the select option in the menu to scan through your layers. When you do, it
  11. becomes possible to modify the styles or do some elementary mathematical
  12. transformation. This program was written originally to generate
  13. some simple graphs, but as time passed it became useful to add some 
  14. options to modify the graph layout and to combine different sets of data in
  15. the same drawing (I guess there aren't many RISCOS programs which support the 
  16. latter option.) I hope this program provides a simple but effective way to 
  17. represent your (scientific) data.
  18.  
  19.  
  20. FORMAT
  21. ~~~~~~
  22. The data format is very simple: you can have 1,2,3 or 4 columns of
  23. ASCII-data. So, for 4 columns you might have:
  24.  
  25. 1.23,0.02,3.456e+2,0.30e+2
  26. 0.43,0.04,5.560e+2,0.21e+2
  27. etc.,
  28.  
  29. which means resp. x[i] dx[i] y[i] dy[i].
  30.  
  31. The separator may be a <,> or a tab (&09).
  32. Numbers may be surrounded by <">, eg. "15.34","12.45",...
  33.  
  34. -When there are 3 columns it is assumed you omitted the dx column.
  35.  
  36. -When there are 2 columns it is assumed you have omitted the dx and dy
  37.  columns.
  38.  
  39. -When there is 1 column it is assumed it is the y column.
  40.  
  41. I'am aware of the fact that you can't put several graph's in the same file,
  42. but you can always drag more than one file into the same DrawGraph window
  43. and make a script file (see below.)
  44.  
  45.  
  46. OPTIONS:
  47. ~~~~~~~
  48.  
  49. 'Force' is an option which forces x=0 and/or y=0 to be drawn.
  50.  
  51. 'Small file' collects different objects in the same graph. It minimizes the 
  52. size of the data held in memory and the draw-file but it will become more 
  53. difficult to modify the graph with !Draw and redrawing the screen will 
  54. become slower. 
  55.  
  56. When you use 'dots' you may change the dot size by altering the line width.
  57.  
  58. It is also possible to 'format' the numbers on the x or y axis. The method I
  59. used to achieve this doesn't seem to work correctly in all cases (sorry).
  60.  
  61. When preforming some transformation, then the dx and dy data are transformed
  62. by the use of the derivative of the transformation function. This means that
  63. if dx or dy is big, than you will introduce some error in dx' resp. dy'
  64. when higher derivatives of the transformation function are relatively large.
  65. Note that there will be no copy (in the program itself) of the original 
  66. data. There is however a possibility to regain your originals by:
  67.       -reloading the originals from disk.
  68.       -preforming the inverse transformation function.
  69. You can click-select on the function icon to step through the complete set 
  70. of transformation functions.
  71.  
  72. When you use 'Histogram', it is assumed that the 'x' data represents the
  73. centre of a 'bin'. This construction allows you to have variable bin width's.
  74.  
  75. You may use 'Select' to step through all sets of data. The dialogue box
  76. shows the name of the original file and the text used for the labels. You
  77. are allowed modify or delete this text. In the latter case there will be no
  78. label for the corresponding graph.
  79.  
  80.  
  81. SCRIPTS
  82. ~~~~~~~
  83. A script file is a short description of the 'current' settings of a graph.
  84. This means that it describes which data file's are used and how the data
  85. is represented (it does not handle font settings or applied transformations.)
  86. The location of a data file is described:
  87.    -with a full path name if the script and data file are not in the same
  88.     directory.
  89.    -with only the leaf name if the script and data file remain in the same
  90.     directory.
  91.  
  92. The latter way is the most usefull one because the relative locations remain
  93. valid if the whole (parent) directory is moved.
  94. The data itself is not stored in the script file. Their are at least two
  95. important reasons for this choice:
  96.    1. You save disk space because the program uses the original data files.
  97.    2. You are allowed to do some recalculation and overwrite the original
  98.       data file(s) while !DrawGraph can still use the old script file with 
  99.       your favorite settings.
  100.  
  101. NB. The <#file> and <#localfile> commands allow you to make recursive scripts.
  102.     This is fine as long as they DON'T form a CYCLE, ie. only trees here.
  103.  
  104.  
  105. BUGS:
  106. ~~~~
  107.       The extending of the windows doesn't go very well, this as a result of
  108.       extending the work area (seemed to be a bug in RISCOS2).
  109.  
  110. 1.01  Updates:
  111.       -Fixed some bugs in dialogue box handlers.
  112.       -Input parser reacts less sick on foolish data.
  113.       -Border line width set to 1pt.
  114.       -Fixed grid patters.
  115.       -Removed 'arrow' option. (Will it ever come back?)
  116.  
  117. 1.02  Updates:
  118.       -Implemented support for the fontmenu module ( ⌐ J.R╓ling )
  119.       -Font tables in draw file will now have just one item, instead of the
  120.        whole font-set.
  121.  
  122. 1.03  Updates:
  123.       -Tried to 'communicate' with the interface module. All my effort turned
  124.        out to be a bit superfluous; RISCOS 3 provided the same thing in a much
  125.        friendlier way. I hope it will work under RISCOS 2. (Yes it does!)
  126.       -Moved program sprites to own resources (<Obey$Dir>.Sprites).
  127.       -Writeable zoom entry is now a real dialogue box.
  128.       -Next and prev. buttons are turned off at the end/start of the file list.
  129.       -Bounding box determination is now done by the draw module.
  130.       -Dot size is (by default) 2 OS units.
  131.       -Supports closed objects where appropriate (ie. triangles, squares).
  132.       -Implemented flex-buffer for creating draw-objects.
  133.       -Implemented flex_buffer for draw diagram.
  134.       -Implemented flex-buffer for text objects.
  135.       -Shuffled some code to get a better overview
  136.       -Removed overhead in list handling data & routines
  137.       -Implemented a script load and save procedure
  138.  
  139. NEXT  (to remind the writer what he still must do some day)
  140.       -RISCOS 3 probably supports fontmenu procedures. Will we use them?
  141.       -Add other graph types?
  142.  
  143.       For suggestions or bug report please contact:
  144.  
  145.         Paul F.C. Groot.
  146.         Arestraat 46,
  147.         1445 EK Purmerend.
  148.         Holland.
  149.  
  150.