How to use
----------
   Unfortunately, the help pages have not been written yet.
   However, there exists a german users-guide as a tar archive of a 
   postscript file ( which had been added to this package in
   './anleitung/anleitung.tgz)'.

   Here is a brief description of DataVisions options:


   File:
     File operations can be activated with this menu.

     load data...:
        Load table from an ASCII file;
        the format of that file should look like a databank output:
        DataVisions expects titles of columns in the first line, a separator
        in the second line and data elements in all other lines.
        Titles and data elements must be seperated by 'white space', so 
        normally blanks and/or tabs can be used as separators.
        The number of titles and data elements in each line must be the same,
        but is not limited.
        The second line may contain anything - it will be overred.

        Example of valid table:

              time    value1    value2
              ------------------------
              12       1.3       1.7
              13       0.12      14
              17       0.13      18
              18       0.19      22

     concat data...:
        concats table from an ASCII file;
        a new table will be attached to the right of an already existing one.

     load configuration:
        loads a configuration file;
        a configuration may contain settings (e.g. colors of curves, titles,
        etc.) and loaded data. This option is usefull to retrieve an older
        session.
        
     save configuration...:
        saves a configuration file; 
        the current settings and loaded data will be saved.

     save startconfig:
        saves a configuration file as an initialisation file;
        DataVision will load that file after each start and after each reset.
        If no start configuration file exists, the program will use a
        hard coded one.

     delete startconfig:
        deletes the current start configuration file.

     reset:
        resets the program;
        all windows except the main window will disappear and the current
        start configuration will be retrieved.

     quit:
        leaves the program


   Import:
     You can directly import data from the 'wosql result' window.
     Please remember: If your 'wishx' is compiled in 'secure' mode (default),
     then 'Xauthority' must have been installed, or the 'xhost list' must be
     empty to use this option.

     get data from wosql:
        directly imports tables from the 'wosql result' window; for this 
        feature, 'wosql' must have been started.

     concat data from wosql:
        directly concat data from the 'wosql result' window; a new table will
        be attached to the right side of an already existing one.
        For this feature, 'wosql' must have been started.


   Option:
     Some general options can be set with this menu.
     (see 'file: save startconfig') to make these settings permanent)

     set window colors:
       set the windows colors of the program

     show table:
       this checkbutton switches the table window on or off;
       normally the loaded table is shown there.


   Domain:
     This menu sets the kind of depiction. The resulting mode has effects on
     some further menus.

     index:
        every selected column (see 'Data: select curves) will be shown as one
        curve.

     real:
        every selected pair of columns (see 'Data: select curves) will be shown
        as one curve. The first column of the pair contains the X-coordinates,
        the second one the Y-coordinates. Values of one row of a selected pair
        will be interpreted as an coordinate.

     date (yymmdd):
        this mode works nearly as the real mode with the exception that the
        X-coordinate will be interpreted as a date in the format 'yymmdd'.

     time (hhmm):
        this mode works nearly as the real mode with the exception that the
        X-coordinate will be interpreted as a time in the format 'hhmm'.


   Data:
     This menu can be used to select 'what' data will be visualized.

     select curves...:
        1) mode == 'domain index':
           a window with a listbox will come up, where all titles of drawable
           columns are shown. The columns of selected titles will be shown as
           curves.
        2) mode != 'doman index':
           A window with two listboxes will come up. The first listbox contains
           the titles of columns. Now you can select domain (X-koordinates)
           and codomain (Y-coordinates) of the curves, which have to be
           visualized. The pairs of selected titles will be shown in the second
           listbox.
           A little bit more formal: A pair of selected titles defines a
           relation, where the titles represents domain and codomain, 
           respectively. 

     9999.99 means undefined:
        1) mode == 'domain index':
           Values equal to 9999.99 will be taken as an 'undefined value'.
           This value will not be shown as part of the appropriate curve.
           if 'Diagram:diagram layout:misc:show undef' is set (default), then
           this undefined value will be marked with an oval at the upper end
           of the diagram.
        2) mode != 'doman index':
           If the second component of a coordinate is equal to 9999.99, then
           this coordinate will be treated as an undefined one. This value
           will not be shown as a part of the approprite curve. If
           'Diagram:diagram layout:misc:show undef' is set (default), then
           this undefined coordinate will be marked with an oval at the upper
           end of the diagram.

      set undefined value:
           Set the value, which should be interpreted as an undefined one.

    Diagram:
      This menu can be used to select 'how' data will be visualized.

      diagram layout...:
         Set options for the layout of the diagram, e.g. :
           -set titles
           -toggle autoscaling on/off
           -set the area of X/Y axis
            (only possible, if autoscaling is switched off)
           -choose, if a column has to be shown as X-scaling
            (works only in index mode)
           -set size of diagram
           -set kind of representation (as Points,Polygon,Bspline)
           -set color of curves
           -toggle Grid on/off
           -mark undefined values

      show diagram...: 
         plots the diagram in a window;
         it is possible to zoom a plot by dragging the left mouse button
         inside the plot - a new zoom window appears showing the marked 
         area. It is also possible to zoom inside that zoom again, but no
         new window will come up.
         Internally, a zoom diagram gets an own data set, so you can change
         the representation for that zoom.

         Some buttons are added to the diagram for faster handling:
           layout...: shortcut for Diagram: diagram layout...
           curves...: shortcut for Data: select curves...
           output...: this button invokes a menu, in which you can export the
                      plot as a postscript file (eps) or send it to a printer.
                      A resscaling can be done here. The orientation of the
                      plot can be changed and the output mode can be set to
                      'Color' or 'Greyscale'.
           cancel:    this button closes the diagram window


   Help:
     This menu can be used to get help with the use of DataVision.

     about:
        A window will be shown, which displays information about DataVision

     help:
        This menu invokes 'tclhelp', which had been patched for use with
        DataVision.
        Unfortunately, the help pages have not been written yet.
