home *** CD-ROM | disk | FTP | other *** search
/ RISCWORLD 7 / RISCWORLD_VOL7.iso / Software / Issue2 / PD / taufull.spk / !Tau_!Help < prev    next >
Encoding:
Text File  |  2006-06-15  |  31.1 KB  |  598 lines

  1. Tau, version 1.50
  2.  
  3. Copyright © Tim Birks 1993, 1994, 2000, 2001
  4. GPL Freeware: for conditions of use, see the files ReadMe & gpl.txt
  5. Current development Peter Killworth 2001-2006 (p.killworth@noc.soton.ac.uk)
  6.  
  7. Desktop graph preparation software. Tau generates publication-quality graphs
  8. in the form of Draw files, ready to import into your favourite
  9. word-processor, computer presentation, or DTP. A data worksheet (16 columns
  10. by 4096 rows) can be filled by keying-in, importing from a file, and/or
  11. calculation. You determine line patterns and thicknesses, colours, text
  12. positioning and font sizes, etc. The data worksheet can be redimensioned, if
  13. you would prefer more rows of data for example.
  14.  
  15. Note that Tau does not (usually) draw graphs on the screen (Acorn's excellent
  16. Draw or similar applications will do that). In the following text, all
  17. references to 'drawing' or 'plotting' a graph refer to the construction of a
  18. Draw file.
  19.  
  20. This file is intended to be some kind of help, but no way is it
  21. comprehensive. It assumes some experience with graph drawing packages, common
  22. sense, and a willingness to suck-it-and-see.
  23.  
  24. -----------------------------------------------------------------------------
  25. Important changes from version 1.30.
  26.  
  27. A new feature has been added. While !Tau has always been able to plot 
  28. multiple data with the same x-values, there are occasions, particularly 
  29. when working with observed data, in which one has several sets of (x, y) data
  30. which need plotting on the same graph. In previous versions, the workaround
  31. has been to plot each pair separately and superimpose the graphs afterwards,
  32. which isn’t very neat. In 1.40 one can turn on "Many Xs" which allows each y
  33. column of data to have a specific x column associated with it for all
  34. plotting purposes; they can all be plotted simultaneously.
  35.  
  36. An improvement has been made to log scaling, and an obscure bug in data
  37. import has been fixed.
  38.  
  39. In 1.41 the ability to specify suffices k, M, G and T for thousands, 
  40. millions, billions and, er, whatever comes next has been added.
  41.  
  42. In 1.50, the ability to specify colours in 24-bit modes is included.
  43. The user can specify colours for the line and/or character and/or fill
  44. for each set of y-values (already added in 1.30). In addition, the colour
  45. for the frame (axes, labels and annotations), for a possible background
  46. fill of the graph, and for the border and fill of the graph key (if
  47. selected) can also be chosen and stored in style files. In 256-colour
  48. modes, !Tau does what it can to represent the 24-bit colours, like
  49. any other application.
  50.  
  51. In 1.60, to speed up plotting, the user can click on a tick or a cross at the 
  52. top of each spreadsheet column (‘+’ or ‘-’ for anyone without the 
  53. Selwyn font) to turn plotting on or off. If a symbol is being used as 
  54. part of the plot it is also shown for convenience. The left-hand column 
  55. (row number) has been widened for those users with lots of data.
  56.  
  57. Important changes from version 1.20.
  58.  
  59. The resizable worksheet has been doubled in size again (assuming most users
  60. can cope with a 640k Wimpslot). With an eye towards computer presentations,
  61. where colour replaces linestyles, both lines and symbols can be in any desktop
  62. colour. Linestyles are now user-definable (lengths and gaps can be specified).
  63. The F3 key has been enabled for quick saves to Drawfiles. The best fit 
  64. option now shows the equation for the fit, and the correlation. A facility
  65. for globally editing data has been added (useful if a certain data value has
  66. the meaning "no or missing data". The key now has a black rectangle
  67. around it, with a white background (so can be moved over the graph without
  68. any of the graph showing through).
  69.  
  70. Important changes from version 1.10.
  71.  
  72. Actually, there are quite a few changes, like the resizable worksheet (with
  73. twice the previous capacity), and the Plot (many) option. The most
  74. significant change is that the TauFile and TauStyle formats are different.
  75. Old-type files can be read by Tau 1.20, but the new-type files cannot be
  76. read by Tau 1.10 and earlier versions. In other words, if you get rid of
  77. your old version of Tau there shouldn't be any problems.
  78.  
  79. -----------------------------------------------------------------------------
  80.  
  81. Starting Tau.
  82.  
  83. Double-click on the !Tau icon in a filer window, or double-click on the icon
  84. of a file of type 082 (TauFile) or 083 (TauStyle). The Tau icon is installed
  85. on the icon bar, and the application's main window opens, showing the data
  86. worksheet (dark blue background) with labelling (grey background) along the
  87. top and left edges.
  88. If starting by a double-click on a TauFile or TauStyle, that file is loaded
  89. into Tau. If starting by a double-click on the !Tau icon itself, Tau looks
  90. for a TauFile or TauStyle called "Default" within the !Tau directory and
  91. loads that. If there is no such file, Tau starts with its worksheet empty
  92. and with minimal appearance data.
  93. Assuming there are no data initially (usually the case), then simply drag in
  94. a text file with some data columns. If the first of these represents the
  95. x-axis for your plot, and the remainder represent the y-axis (or -axes if
  96. you wish to plot more than one simultaneously), then bringing up the save
  97. option on the main menu and saving as a drawfile will give you a 
  98. publishable graph right away.
  99.  
  100. -----------------------------------------------------------------------------
  101.  
  102. Default settings.
  103.  
  104. There are three ways Tau can get its default settings when it is started.
  105. These include the graph style parameters, and also other things like
  106. whether the user is prompted if unsaved data is about to be lost (hidden,
  107. a little unhelpfully, in the Reduce menu from historical times), and
  108. whether Tau automatically scales your graph.
  109.  
  110. 1) If Tau is started by double-clicking on a TauFile or TauStyle icon, the
  111. defaults are set to the values stored in the file.
  112.  
  113. 2) If Tau is started "empty", by double-clicking on the !Tau icon, the
  114. defaults are obtained from a file called "Default" within the !Tau
  115. directory. If you would like to use your own set of defaults, just put them
  116. in a TauStyle file and save it as "Default" in the !Tau directory.
  117.  
  118. 3) If there is no file "Default" in the !Tau directory and Tau is started
  119. by double-clicking on the !Tau icon, a set of default defaults from within
  120. the program is used.
  121.  
  122. -----------------------------------------------------------------------------
  123.  
  124. Editing data.
  125.  
  126. The data worksheet is arranged in 16 columns, each containing 4096 rows of
  127. cells. The cells can be filled with data by importing from a file (see
  128. below), by calculation (see below), or from the keyboard. Click on the
  129. appropriate cell with Select to set the caret and highlight. You can then
  130. edit the contents of the cell. Valid contents are: a number (use 'E' for
  131. exponential notation; 'D' and lowercase are also understood); no contents
  132. (blank cell); or the special entry 'M'(for 'move') which will cause any
  133. eventual line graph to have a break at that position.
  134. If you click on a cell with Adjust, the caret does not move, but all the
  135. cells in a rectangle between the caret-cell and the cell you clicked on will
  136. highlight. Any action performed at the caret (followed by RETURN when
  137. entering a number) will then affect all these cells.
  138. Tau keeps a note of the maximum row and column numbers for which data are held.
  139. If you double-click on a cell, that cell gains the caret and the whole
  140. column (down to the maximum row) will highlight. Double-click with SHIFT to
  141. highlight a whole row instead.
  142. Values are displayed in cells to six significant figures.
  143.  
  144. -----------------------------------------------------------------------------
  145.  
  146. Special key presses.
  147.  
  148. RETURN -       Reflect the value in the current cell in all highlit cells,
  149.                then move the caret down one row.
  150. SHIFT-RETURN - As RETURN, but move the caret right one column.
  151. CTRL-RETURN -  Carriage return, move down one row, and to leftmost column.
  152. LEFT/RIGHT -   Move caret one character left/right.
  153. BACKSPACE -    Delete the character to the left of the caret within a cell.
  154. DOWN/UP -      Move caret down/up one cell.
  155. SHIFT-DOWN/UP/LEFT/RIGHT - Extend or contract the highlit block of cells.
  156. CTRL-DOWN/UP - Move caret to the last/first cell in a column.
  157. TAB -          Move caret right one cell, perform 'carriage return' if at the
  158.                last column.
  159. SHIFT-TAB -    Move caret left one cell, perform 'reverse carriage return' if
  160.                at the first column.
  161. HOME -         Move caret to the first cell in the worksheet.
  162. SHIFT-COPY (ie, END) - Move caret to the bottom-right-most cell of a
  163.                rectangle enclosing all cells containing data.
  164. CTRL-U -       Blank all highlit cells.
  165. DELETE -       Same action as BACKSPACE.
  166. SHIFT-DELETE - All highlit cells in the same row as the caret are blanked,
  167.                then all the values in the cells below these are scrolled up
  168.                to 'fill the hole'.
  169. INSERT -       The values in all highlit cells in the same row as the caret,
  170.                and the cells below these, are scrolled down. A row of blank
  171.                cells is inserted.
  172. F3 -           Does a quick save to a Drawfile.
  173.  
  174. Clicking on the tick or cross at the top of a colunn changes whether that
  175. column is plotted or not (a quicker way than diving into the Plot window
  176. for that column).
  177.  
  178. -----------------------------------------------------------------------------
  179.  
  180. Dragging files onto the main window (or the icon bar icon).
  181. This starts a load action which depends on the filetype of the file dragged:
  182.  
  183. 082 (TauFile) - A TauFile file is a complete record of a previous state of
  184.  Tau, and includes all the data in a worksheet and the variables governing
  185.  the appearance of a graph. Dragging a TauFile onto Tau will restore the
  186.  saved state, overwriting all of the current state.
  187. 083 (TauStyle) - A TauStyle file is a TauFile file without any worksheet
  188.  data. It replaces the variables governing the appearance of a graph, without
  189.  overwriting the current data. It's like the 'template' files in other graph
  190.  software, but the word 'template' already has a very particular meaning in
  191.  RISC OS.
  192. ffb (BASIC) - Has no immediate effect. Tau assumes any imported BASIC file
  193.  to be a function library. You can then perform calculations on worksheet
  194.  data using your own defined functions. A simple example, Sinc, is provided
  195.  with Tau - this contains a function FNsinc(x) which returns SIN(x)/x without
  196.  generating an error at x=0. To avoid clashes with the program's internal FN
  197.  definitions, do not use FN names beginning with capital 'T'.
  198. fff (Text), dfe (CSV) - Tau assumes files of these types contain textual data
  199.  for import, either separated by spaces or commas, with row endings marked
  200.  by one or more control characters (such a linefeed or carriage-return).
  201.  Import *starts at the caret*; data in cells not explicitly overwritten by new
  202.  data are retained. Incidentally, Tau treats these files identically on
  203.  import - eg the contents of a Text file can be comma- separated. A blank
  204.  cell can be marked by an isolated decimal '.', and a 'move' cell by 'M'.
  205.  The Global Edit feature (below) allows for a specific value to be replaced
  206.  by another throughout the data, which is useful if 999, or 1.E20, etc.
  207.  are defined as "missing data".
  208.  The fact that import starts at the caret means that several datasets 
  209.  (presumably occupying separate columns!) can easily be imported by 
  210.  positioning the caret accordingly before dragging them into !Tau.
  211. Other filetypes - action is normally as for fff (Text). But Tau first
  212.  investigates whether the file might contain non-textual numerical data
  213.  ("Binary data"). Such a file would be generated by, for example, the Basic
  214.  PRINT# statement. Tau assumes that your file is "Binary data" if the first
  215.  byte in the file is ascii &40, &80 or &88; no self-respecting file of
  216.  textual data should contain any of these characters.
  217.  Because there is no row-ending marker in such a file, Tau expects a special
  218.  first datum in the file to be an integer specifying the number of data
  219.  columns in one row. However, you can instead specify the number of columns
  220.  in the Import dbox. Import starts at the caret; data not overwritten are
  221.  retained.
  222.  
  223. -----------------------------------------------------------------------------
  224. -----------------------------------------------------------------------------
  225.  
  226. Main menu.
  227.  
  228. Click Menu over the main window, gives the following items:
  229.  
  230. Paper - Leads to a submenu controlling the size and shape of a graph on the
  231.  paper.
  232. Graph - Leads to a submenu controlling the appearance of the whole graph.
  233.  This includes such attributes as its scaling and the appearance of ticks
  234.  and labels, and the number of rows and columns in the worksheet.
  235. Column - Leads to a submenu controlling the treatment of an individual column
  236.  of data. This includes control of the meaning of a column (use as X data, Y
  237.  data, error bar data, or ignore), the appearance of a plot (whether to draw
  238.  points, lines between points, etc), and actions such as calculation and
  239.  sort.
  240. Save - Leads to a submenu allowing the saving of data in various ways.
  241.  Clicking on the Save item in the Main menu will save the current Tau state
  242.  as a TauFile, or generate an error if no pathname is specified yet.
  243.  (F3 will do a quick save as a Drawfile.)
  244. Import - Leads to a dialogue box. The first part governs the import of a
  245.  file of Binary data (see above). The second part allows you to "weed" data
  246.  being imported, reading in only 1 row of data for each n rows of data in the
  247.  file.
  248. Cells - A submenu, various ways of highlighting parts of the worksheet.
  249. Reduce - A submenu, various ways to shrink your data, and disable the
  250.  warning Tau gives when edited data is about to be lost or over-written.
  251. View - Equivalent to clicking on the Tau icon in the left-hand corner,
  252.  and produces a quick graph of the data.
  253. Many Xs – A tickable item (click on the item to choose/unchoose it). When
  254.  unticked, a single column of data (the leftmost one labelled “X”, in fact)
  255.  serves as the x values for all current plots. When ticked, each set of y
  256.  data can (and must) have an x-column associated with it, so that several
  257.  datasets with different x values can be plotted simultaneously.
  258. k,M,G labels - Setting this changes labels to use k (for thousands), M
  259. (for millions) and G (for billions) instead of E powers.
  260. Global Edit - Leads to a dialogue box. The user can specify a data value
  261.  and a replacement value, which are changed globally within the data
  262.  when "OK" is clicked. Values can be changed to missing by specifying 
  263.  full stop (period) or leaving the value blank; values can also be set
  264.  to "m" or "M" with the standard meaning (break the plot at this point).
  265.  
  266. -----------------------------------------------------------------------------
  267.  
  268. Paper submenu.
  269.  
  270. The items in this submenu lead to dialogue boxes. All dimensions are in
  271. points (1/72 inch) unless otherwise specified.
  272.  
  273. + Size dbox.
  274. This governs the size and positioning, on paper, of the three main separate
  275.  structures in a Tau graph. All sizes are in INCHES. (Aside, to any
  276.  Euro-freaks: the 'inch' is a special Tau unit of length defined to be equal
  277.  to 72 points. Happy now?) 
  278. Graph - This is actually the size and position of the graph's viewport, ie
  279.  the frame if one is being drawn.
  280. Border - You can have a border to make your graph look pretty. However, the
  281.  main reason for having one is for grid-locking in !Draw. The average graph
  282.  will have a well-defined frame, but also all sorts of labels and text
  283.  hanging off it. The Draw bounding box of the graph will therefore not be
  284.  simply related to the frame, and will vary from graph to graph. This causes
  285.  problems when trying to arrange two or more graphs to line up nicely when
  286.  using gridlock in Draw. So Tau can draw a big well-defined border around the
  287.  whole lot. Then you can line your graphs up in Draw, then delete the frames
  288.  afterwards. Since the border is meant to be a throw-away structure, it will
  289.  always be 'thin'. That's the theory anyway; shame it doesn't work.
  290. Key - A simple key to the graph can be drawn. The key is a list of the Y plots 
  291.  drawn, showing the line pattern, the point shape, and a bit of text. Around
  292.  these is a black rectangle with a white background (which ensures the key
  293.  is visible if it is later positioned over the graph). The key is a separate
  294.  group within the Drawfile, so if you wish to move its position within !Draw
  295.  or any other drawing package, ungroup the whole picture and select the key
  296.  area. Colours for the graph key (its border and background) can be
  297.  chosen here.
  298.  
  299. + Magnify dbox.
  300. The whole graph can be magnified (or shrunk) uniformly when saved as a Draw
  301.  file. Enter the magnification factor here.
  302.  
  303. -----------------------------------------------------------------------------
  304.  
  305. Graph submenu.
  306.  
  307. The items in this submenu lead to dialogue boxes. All dimensions are in
  308. points (1/72 inch) unless otherwise specified.
  309.  
  310. + Scaling dbox.
  311. Governs the scaling of the graph. All dimensions refer to the data in the
  312. worksheet.
  313. Auto scale - When selected, Tau takes a look at the worksheet and your other
  314.  choices, and automatically scales the graph. Deselect it if you want to
  315.  make any changes yourself.
  316. Bound - When selected, the graph will include only data points and line
  317.  segments within the frame of the graph. Otherwise points and lines outside
  318.  the frame will be drawn also. (The 'fill' option is disabled when bounding
  319.  is active, as it is unlikely to be useful.)
  320. X/Y log scale - Whether or not a log scale is selected governs the type of
  321.  scaling information required, below. Beware negative or zero values!
  322. X/Y values - Determines the range of the graph's viewport, and the
  323.  positioning of axes within it.
  324. Format - Determines the appearance of numerical axis labels. The choices
  325.  follow BASIC's @% format.
  326. X/Y tick spacing - Tau supports two sets of ticks on each axis, major ticks
  327.  usually being more prominent than minor ticks. The anchor is any one value
  328.  where a major tick is to lie. Hence if the tick spacing is '2' and the
  329.  anchor is '5', then major ticks will be drawn at 1,3,5,7,...
  330.  If a log scale is selected, you have several choices. Choosing any of 
  331.  the top four choices (“1, 1000”; “1, 10”; “1, 3, 10”; or “1, 2, 5, 10”) 
  332.  gives you a logarithmic tick distribution. For example, if ‘1, 3, 10’ 
  333.  is selected then ticks will be drawn at 0.1, 0.3, 1,3, 10,30... and so 
  334.  on. In all these cases labels only occur at 1, 10, 100 etc. 
  335.  Alternatively, choose the ‘linear’ settings, which put ticks at 1, 2, 
  336.  3, 4, ..., 8, 9, 10, 20, 30, 40, ..., 80, 90, 100, 200, and so on. In 
  337.  this case, labels are put at 1, 2, and 5 in each decade.
  338.  
  339. + Frame dbox.
  340. Governs the axis structures to be drawn. All dimensions are in points.
  341.  A frame is a rectangular box at the edge of the graph's viewport, and
  342.  carries ticks on all four sides. An X/Y axis is a horizontal/vertical bar
  343.  which stretches the whole length/height of the viewport and can be
  344.  positioned anywhere vertically/horizontally (as defined in the Scaling
  345.  dbox).
  346.  The colour of the axis structures (lines, labels, ticks) can be chosen. A
  347.  background colour for the whole graph can also be chosen, provided the
  348.  "background" box is selected.
  349.  This dbox can be used to produce a graph with two sets of data, each with
  350.  their own y-axes, for example. Generate one file with an axis at the left,
  351.  containing one set of data; then generate another with an axis at the right,
  352.  with the other set of data. Finally, superimpose the two. Mind you, the
  353.  multiple X option is simpler...
  354.  
  355. + Ticks dbox.
  356. Governs the appearance of axis/frame ticks. All dimensions in points.
  357.  Tau supports two sets of ticks on each axis; major ticks usually being more
  358.  prominent than minor ticks. Ticks on an X axis extend up and/or down. Ticks
  359.  on a Y axis extend left and/or right. Ticks on a frame extend in and/or out.
  360.  You can choose whether to plot a certain family of ticks at all.
  361.  
  362. + Grids dbox.
  363. Governs the appearance of grid lines. All dimensions in points.
  364.  Grid lines are usually broken or dashed, so you choose the dash pattern.
  365.  Grid lines are anchored to ticks, but can omit the minor ticks.
  366.  
  367. + Labels dbox.
  368. Governs the appearance and positioning of numerical labels on axes/frame.
  369. Labels can appear on axes and/or the frame.
  370. Below ? - When selected, labels are placed below the X axis or frame bottom
  371.  edge. Otherwise labels are placed above the X axis or frame top edge.
  372. Left ? - Analogous to Below ? but for Y values.
  373. Minors ? - When selected, labels are placed at minor ticks as well as major
  374.  ticks.
  375. Rotate ? - When selected, Y labels are written 'sideways' parallel to the
  376.  axis or frame edge. THIS OPTION FAILS IN RISC OS 2 !!!
  377. Offset - The distance between the axis or frame and the label, as a fraction
  378.  of the font height/width.
  379. Font Size - In points. The label font is determined in the Fonts dbox.
  380.  
  381. + Texts dbox.
  382. Governs the appearance of textual labels on axes/frames, such as a
  383.  description of the quantity plotted along an axis.
  384. plot? - Whether to draw at all.
  385. on Frame? - When selected, plot along the frame, else along the axis.
  386. below?/left?/rotate? - As in the Labels dbox.
  387. Offset - The distance between the frame/axis and the nearest part of the
  388.  text, as a fraction of the font height/width.
  389. Spacing - The line spacing between successive lines of the text, as a
  390.  fraction of the font height/width.
  391. Text - Any text you like. Include backslash characters '\' to force a line
  392.  break.
  393. Font size - In points. Uses the same font as the numerical labels, but can
  394.  be a different size.
  395.  
  396. + Fonts dbox.
  397. There are usually two fonts in use in a Tau graph. You have to enter in their
  398. full names in this dbox.
  399. Font for data points - This should be some kind of symbolic font to supply
  400.  circles, squares, triangles, stars, etc for data points. Specifically use
  401.  the Selwyn font. However, maybe Selwyn only comes with RISC OS 3, I don't
  402.  know. So you can choose to use another font instead if you like. The public
  403.  domain Dingbats font should do the trick.
  404. Font for graph labels - This serves for all labelling tasks.
  405.  
  406. + Worksheet dbox.
  407. This displays the current number of rows and columns in the data worksheet,
  408.  and invites you to enter new values for either or both. If you enter a new
  409.  value for just one, then the other will be given the maximum possible range.
  410.  If you specify fewer rows than the current data, or if you change the number
  411.  of columns at all, the current data will be forgotten! The maximum number
  412.  of columns is 64.
  413.  
  414. -----------------------------------------------------------------------------
  415.  
  416. Column submenu.
  417.  
  418. All but one of the items in this submenu lead to dialogue boxes.
  419.  
  420. + Plot dbox.
  421. Governs the appearance of a column of Y data points. All dimensions in
  422. points. Acts only on the column which includes the caret.
  423. Plot this Column - When deselected, Tau ignores the column of data
  424.  completely.
  425. Draw Line - When selected, draw straight lines between successive X,Y points.
  426.  Define your own dash patterns: click 'Menu' on Line Style and choose between
  427.  a continuous line, a dashed line, or a dash-dotted line. In the last two
  428.  of these cases, the lengths and gaps can be entered numerically.
  429.  If a value 'M' is encountered on either the
  430.  X or Y data, the line will be broken by a 'move' operation; line drawing
  431.  resumes from the next numerical value.
  432. Draw Error Bars - If selected, when drawing the graph, Tau looks for any
  433.  columns designated Ln, Rn, Un, Dn, Hn and Vn, for the appropriate n, to
  434.  supply error bar data to the graph. If none are found, no error bars are
  435.  drawn.
  436. Key Text - The text to appear in the graph key (if plotted).
  437. Fill - Fill the area between the graph line (which of course is not plotted
  438.  if Draw Line is deselected) and the X axis, in the selected Desktop colour.
  439.  This is not done if a Y log scale is selected or if Bound ? is selected.
  440.  Expect peculiar effects if your plot includes moves (an 'M' in the
  441.  worksheet).
  442. Draw Points - When selected, mark data points with characters from the font
  443.  selected in the Fonts dbox. You choose the character size and ascii code -
  444.  an enlarged picture of the character is shown.
  445. Colours - Fill, Line and Character colours can be chosen; click any key over
  446.  the appropriate box and select from the list. (The appropriate option must be
  447.  activated for a colour to be chosen.)
  448. Plotting with X - This is usually greyed out (and always is for a column of
  449.  Xs). If “Many Xs” is set, then the label of the X-column associated with the
  450.  Y-column in the plot box can be set. The y-data will then be plotted with
  451.  those x-data (assuming the “plot this column” flag is set for both!),
  452.  autoscaling will include the relevant x-range, and a best fit to the y-data
  453.  will use the relevant x-data.
  454.  
  455. + Meaning dbox.
  456. You decide the meaning to attach to the data in the column. A string
  457. summarising your choice is shown along the top of the worksheet for your
  458. information. Valid designations are:
  459.  X - The column is to supply the X data for a graph. You need one of these
  460.   somewhere to get a graph! The ‘tag’ entry is greyed out for X values
  461.   unless the “Many Xs” option is selected, when a tag may be entered. A null
  462.   value is taken as zero.
  463.  Yn (where n is any digit or pair of digits) - The column is to supply a set
  464.    of Y data. Since many sets of Y data can be plotted in Tau, each is
  465.    distinguished by the tag n.
  466.  Ln/Rn/Un/Dn - Error bar length left/right/up/down, to attach to the series
  467.    of data points given by the selected X and Yn. For example, a column
  468.    designated U3 supplies 'up' error bar information for use with the column
  469.    designated Y3.
  470.  Hn/Vn - Combines Ln & Rn / Un & Dn designations; that is, provides
  471.    horizontal/vertical error bar lengths in both directions.
  472. When constructing a graph, Tau looks for the first occurrence of a given
  473. column meaning and ignores any others. For example, if you have two columns
  474. both designated 'X", (if “Many Xs” is not selected) or two designated ‘X13’
  475. (if “Many Xs” is selected) the second will be ignored.
  476.  
  477. + Plot (many) dbox.
  478. This performs the actions of the "Plot" dbox on a number of columns, the
  479.  parameters being set to the values for the current column (the one the
  480.  caret is sitting in).
  481. To determine which columns to act upon, type an appropriate string into the
  482.  writable icon. This string can be either:
  483.  1) A list of column numbers separated by commas, including ranges. For
  484.     example, "3,6-9,11" will act on columns 3, 6, 7, 9 and 11; or
  485.  2) A BASIC logical expression which includes the "#" character. The program
  486.     substitutes the # for each column number in turn. Those columns for
  487.     which the expression is TRUE are acted upon. For example, the string
  488.     "(# MOD2)=0" acts only on the even numbered columns, and "#>5 AND #<9"
  489.     acts only on columns 6, 7 and 8.
  490. The column's tag number can also be changed. Specify a BASIC expression with
  491.  the "#" character again specifying the column number.
  492.  
  493. + Calculate dbox.
  494. To fill the highlit area of the column with the caret with the results of a
  495.  calculation, enter a valid BASIC expression. To use values from worksheet
  496.  column n as arguments, use #n; to use values from the selected column, use
  497.  #@; to use the row number (the number shown down the left side of the
  498.  worksheet), use ##.
  499. For example, if you want to plot a graph of EXP(X) versus X, from -5 to 5 in
  500.  50 steps. Start with an empty worksheet. Highlight rows 0 to 50 in column 0.
  501.  In the Calculate dbox, enter the expression: (##-25)/5, to give values from
  502.  -5 to 5. Double-click on column 1 to highlight rows 0 to 50, then calculate:
  503.  EXP(#0). Designate column 0 as 'X' and column 1 as, for example, 'Y1'.
  504. You can define your own functions for use in calculations: write a BASIC
  505.  library containing the FN definition, then drag the BASIC file onto the Tau
  506.  main window. Tau will install the library. Make sure the function name
  507.  doesn't begin FNT..., to guarantee no conflict with Tau's internal FN
  508.  definitions. A simple example 'Sinc' is included.
  509. You can also use Calculate to copy or move data from one column to another -
  510.  for example, to copy column 3, use the expression: #3.
  511.  
  512. + Best fit dbox.
  513. Performs linear/log regression (depending on whether X/Y log scales are
  514.  currently selected) on X,Y data. If “many Xs” is not selected, these data
  515.  are supplied by the selected rows of the data columns designated X and Yn
  516.  respectively. If “Many Xs” is selected, the x-data relevant for Yn are
  517.  used. You select the Yn to use - note this is NOT the column number, but the
  518.  Y tag. The Y values given by the regression are then inserted into the
  519.  highlit columns. You can force the regression to pass through a given point
  520.  (usually the origin). A window is opened for information showing the
  521.  equation of the fit, and the correlation if this is relevant (i.e., if the
  522.  regression has not been forced to pass through a given point).
  523.  Note that the best fit can be used to fit:
  524.  a straight line y = mx + c (use linear-linear in the scale db)
  525.  an exponential fit y = a.exp(bx) (use linear x, log y in the scale db)
  526.  a log fit y = a.log x + b (use log x, linear y in the scale db)
  527.  a power law (use log x and log y in the scale db)
  528.  
  529. + Normalise.
  530. Finds the maximum absolute value in the highlit area, then divides all
  531.  highlit cells by that value.
  532.  
  533. + Sort.
  534. When the item is clicked, the highlit rows across all columns are sorted in
  535.  ascending order of the values in the highlit column.
  536.  
  537. -----------------------------------------------------------------------------
  538.  
  539. Save submenu.
  540.  
  541. All items but one lead to a Save dialogue box.
  542.  
  543. + Draw file
  544. THIS IS THE PRIMARY OUTPUT OF TAU !!!  Saving a Draw file initiates the
  545.  construction of the graph as defined by the values in the worksheet and the
  546.  various style variables. The resultant Draw file can be imported directly
  547.  into other applications, or edited using !Draw; for example, if you want to
  548.  combine several graphs onto one diagram. F3 does a quick save to a Draw
  549.  file also.
  550.  
  551. + Tau file
  552. Makes a copy of the complete state of Tau in a file of type 082 (TauFile).
  553.  However, information about any user function libraries currently in place is
  554.  not saved.
  555.  
  556. + Tau style
  557. The Tau equivalent of a graphics template file, to make it easier to produce
  558.  a batch of graphs with the same style.
  559.  
  560. + CSV data
  561. Export data from the worksheet in the form of textual CSV (comma separated
  562.  values). Export is influenced by the selections made in the Options dbox
  563.  (see below).
  564.  
  565. + Text data
  566. Export data in the form of spaced text. Also uses Options dbox.
  567.  
  568. + Binary data
  569. Export numerical data in BASIC PRINT# format. This saves space. The first
  570.  datum in the file is an integer indicating the number of columns the data
  571.  spans. Also uses Options dbox.
  572.  
  573. + Options dbox
  574. This is a dbox of data export options. Choose to use an isolated point
  575.  character '.' to mark blank cells, an 'M' character to mark 'move' cells,
  576.  whether to export data in order of meaning (Y1, Y2, etc) or not, whether
  577.  to export the whole worksheet or just a highlit selection, and whether to
  578.  export the number of columns as the first datum when saving a Binary file.
  579.  
  580. -----------------------------------------------------------------------------
  581.  
  582. View option.
  583.  
  584. If you click on "View" in the main menu, or on the Tau icon in the top left
  585.  corner, a window will open that displays the graph. This window has its own
  586.  menu, which should be self-explanatory.
  587.  
  588. Dragging any drawfile into Tau will open the View window to display that
  589.  file. Tau thus acts as a drawfile viewer.
  590.  
  591. -----------------------------------------------------------------------------
  592.  
  593. Quitting Tau.
  594.  
  595. If you click on the Close icon of the main window, you do not actually leave
  596.  Tau: clicking on the icon bar icon restores the main window unchanged. To
  597.  quit Tau, select Quit from the icon bar menu.
  598.