home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilst / tau / !Tau / !Help < prev    next >
Text File  |  1994-08-18  |  21KB  |  413 lines
  1.  
  2. Tau, version 1.10
  3.  
  4. Copyright © Tim Birks 1993, 1994
  5. Freeware: for conditions of use, see the file ReadMe.
  6.  
  7. Desktop graph preparation software. Tau generates publication-quality graphs
  8. in the form of Draw files, ready to import into your favourite word-processor
  9. or DTP. A data worksheet (16 columns by 1024 rows) can be filled by keying-
  10. in, importing from a file, and/or calculation. You determine line patterns
  11. and thicknesses, text positioning and font sizes, etc.
  12.  
  13. Note that Tau does not draw graphs on the screen (Acorn's excellent Draw
  14. application will do that). In the following text, all references to 'drawing'
  15. or 'plotting' a graph refer to the construction of a Draw file.
  16.  
  17. This file is intended to be some kind of help, but no way is it
  18. comprehensive. It assumes some experience with graph drawing packages, common
  19. sense, and a willingness to suck-it-and-see.
  20.  
  21. -----------------------------------------------------------------------------
  22.  
  23. Starting Tau.
  24.  
  25. Double-click on the !Tau icon in a filer window, or double-click on the icon
  26. of a file of type 082 (TauFile) or 083 (TauStyle). The Tau icon is installed
  27. on the icon bar, and the application's main window opens, showing the data
  28. worksheet (dark blue background) with labelling (grey background) along the
  29. top and left edges.
  30. If starting by a double-click on a TauFile or TauStyle, that file is loaded
  31. into Tau. If starting by a double-click on the !Tau icon itself, Tau looks
  32. for a TauFile or TauStyle called "Default" within the !Tau directory and
  33. loads that. If there is no such file, Tau starts with its worksheet empty
  34. and with minimal appearance data.
  35.  
  36. -----------------------------------------------------------------------------
  37.  
  38. Editing data.
  39.  
  40. The data worksheet is arranged in 16 columns, each containing 1024 rows of
  41. cells. The cells can be filled with data by importing from a file (see
  42. below), by calculation (see below), or from the keyboard. Click on the
  43. appropriate cell with Select to set the caret and highlight. You can then
  44. edit the contents of the cell. Valid contents are: a number (use 'E' for
  45. exponential notation); no contents (blank cell); or the special entry 'M'
  46. (for 'move') which will cause any eventual line graph to have a break at
  47. that position.
  48. If you click on a cell with Adjust, the caret does not move, but all the
  49. cells in a rectangle between the caret-cell and the cell you clicked on will
  50. highlight. Any action performed at the caret (followed by RETURN when
  51. entering a number) will then affect all these cells.
  52. Tau keeps a note of the maximum row and column numbers for which data are held. If you double-click on a cell, that cell gains the caret and the whole
  53. column (down to the maximum row) will highlight. Double-click with SHIFT to
  54. highlight a whole row instead.
  55. Values are displayed in cells to six significant figures.
  56.  
  57. -----------------------------------------------------------------------------
  58.  
  59. Special key presses.
  60.  
  61. RETURN -       Reflect the value in the current cell in all highlit cells,
  62.                then move the caret down one row.
  63. SHIFT-RETURN - As RETURN, but move the caret right one column.
  64. CTRL-RETURN -  Carriage return, move down one row, and to leftmost column. 
  65. LEFT/RIGHT -   Move caret one character left/right.
  66. BACKSPACE -    Delete the character to the left of the caret within a cell.
  67. DOWN/UP -      Move caret down/up one cell.
  68. SHIFT-DOWN/UP/LEFT/RIGHT - Extend or contract the highlit block of cells.
  69. CTRL-DOWN/UP - Move caret to the last/first cell in a column.
  70. TAB -          Move caret right one cell, perform 'carriage return' if at the
  71.                last column.
  72. SHIFT-TAB -    Move caret left one cell, perform 'reverse carriage return' if
  73.                at the first column.
  74. HOME -         Move caret to the first cell in the worksheet.
  75. SHIFT-COPY (ie, END) - Move caret to the bottom-right-most cell of a
  76.                rectangle enclosing all cells containing data.
  77. CTRL-U -       Blank all highlit cells.
  78. DELETE -       Same action as BACKSPACE.
  79. SHIFT-DELETE - All highlit cells in the same row as the caret are blanked,
  80.                then all the values in the cells below these are scrolled up
  81.                to 'fill the hole'.
  82. INSERT -       The values in all highlit cells in the same row as the caret,
  83.                and the cells below these, are scrolled down. A row of blank
  84.                cells is inserted.
  85.  
  86. -----------------------------------------------------------------------------
  87.  
  88. Dragging files onto the main window (or the icon bar icon).
  89. This starts a load action which depends on the filetype of the file dragged:
  90.  
  91. 082 (TauFile) - A TauFile file is a complete record of a previous state of
  92.  Tau, and includes all the data in a worksheet and the variables governing
  93.  the appearance of a graph. Dragging a TauFile onto Tau will restore the
  94.  saved state, overwriting all of the current state.
  95. 083 (TauStyle) - A TauStyle file is a TauFile file without any worksheet
  96.  data. It replaces the variables governing the appearance of a graph, without
  97.  overwriting the current data. It's like the 'template' files in other graph
  98.  software, but the word 'template' already has a very particular meaning in
  99.  RISC OS.
  100. ffb (BASIC) - Has no immediate effect. Tau assumes any imported BASIC file
  101.  to be a function library. You can then perform calculations on worksheet
  102.  data using your own defined functions. A simple example, Sinc, is provided
  103.  with Tau - this contains a function FNsinc(x) which returns SIN(x)/x without
  104.  generating an error at x=0. To avoid clashes with the program's internal FN
  105.  definitions, do not use FN names beginning with capital 'T'.
  106. fff (Text), dfe (CSV) - Tau assumes files of these types contain textual data
  107.  for import, either separated by spaces or commas, with row endings marked
  108.  by one or more control characters (such a linefeed or carriage-return).
  109.  Import starts at the caret; data in cells not explicitly overwritten by new
  110.  data are retained. Incidentally, Tau treats these files identically on
  111.  import - eg the contents of a Text file can be comma- separated. A blank
  112.  cell can be marked by an isolated decimal '.', and a 'move' cell by 'M'.
  113. Other filetypes - action is normally as for fff (Text). But Tau first
  114.  investigates whether the file might contain non-textual numerical data
  115.  ("Binary data"). Such a file would be generated by, for example, the Basic
  116.  PRINT# statement. Tau assumes that your file is "Binary data" if the first
  117.  byte in the file is ascii &40, &80 or &88; no self-respecting file of
  118.  textual data should contain any of these characters.
  119.  Because there is no row-ending marker in such a file, Tau expects a special
  120.  first datum in the file to be an integer specifying the number of data
  121.  columns in one row. However, you can instead specify the number of columns
  122.  in the Import dbox. Import starts at the caret; data not overwritten are
  123.  retained.
  124.  
  125. -----------------------------------------------------------------------------
  126. -----------------------------------------------------------------------------
  127.  
  128. Main menu.
  129.  
  130. Click Menu over the main window, gives the following items:
  131.  
  132. Paper - Leads to a submenu controlling the size and shape of a graph on the
  133.  paper.
  134. Graph - Leads to a submenu controlling the appearance of the whole graph.
  135.  This includes such attributes as its scaling and the appearance of ticks
  136.  and labels.
  137. Column - Leads to a submenu controlling the treatment of an individual column
  138.  of data. This includes control of the meaning of a column (use as X data, Y
  139.  data, error bar data, or ignore), the appearance of a plot (whether to draw
  140.  points, lines between points, etc), and actions such as calculation and
  141.  sort.
  142. Save - Leads to a submenu allowing the saving of data in various ways.
  143.  Clicking on the Save item in the Main menu will save the current Tau state
  144.  as a TauFile, or generate an error if no pathname is specified yet.
  145. Import - Leads to a dialogue box. The first part governs the import of a
  146.  file of Binary data (see above). The second part allows you to "weed" data
  147.  being imported, reading in only 1 row of data for each n rows of data in the
  148.  file.
  149. Cells - A submenu, various ways of highlighting parts of the worksheet.
  150. Reduce