Table of Contents

Name

tabzoom - dynamic query table viewer with interactive zoom and action

Synopsis

tabzoom in=table_file [parameter=value]

Description

tabzoom is an interactive program that displays numeric data from an ASCII table in a 2D plot (see also tabplot(1NEMO) and tabview(1NEMO) ), while dynamically querying related columns from the same table, and allowing zooming and performing an action on a selected point. Dynamic Query (DQ) is an effective way to visualize an N-dimensional dataset in 2D. Two variables are selected to be plotted, they can either be directly taken as a column from the table, or computed via a fie(3NEMO) expression involving any column, e.g. "sqrt(%1**2+%2**2)".

Each selected ’column’ can be manipulated using sliders. Between the min (on the left) and max (on the right) of a column, two sliders, called lo and hi can be moved around independantly. lo is a lower limit, and hi the higher limit, for data to be included in the display:

      lo  <  hi                 MIN-------[lo=======hi]--------MAX
and
      lo  >  hi                 MIN=======hi]--------[lo=======MAX
The lo slider can also be moved to the right of the hi slider, as the diagram shows, in which case the sample will include data between min and hi as well as lo and max. This is like swapping the lo and hi sliders and corresponds to negating the logic of the first case.

Finally, only data are displayed for which the corresponding slider value of all values falls in the selected range. In SQL language, this means all queries are AND-ed.

Note: in this prototype the words slider and column can be used interchangebly.

Parameters

The following parameters are recognized in any order if the keyword is also given:
in=in_table
Input table filename. No default.
col=name1, name2,..
Columns to be named and selected as sliders. The default column names are 1,2,3,... for ascii tables. The default is that all columns are selected to become sliders.
xvar=X_expression
X-variable to plot. Any fie(3NEMO) expression involving input columns (see col=) can be given. The first extracted column given by col= is referred to as %1 etc. [Default: %1].
yvar=Y_expression
Y-variable to plot (see xvar=). [Default: %2].
xrange=xmin,xmax
Range in X from xmin to xmax [autoscale + 5% edges].
yrange=ymin,ymax
Range in Y from ymin to ymax [autoscale + 5% edges].
xlab=x-label
Label along the X-axis [default xcol]
ylab=y-label
Label along the Y-axis [default: ycol]

color=C_expression
A fie(3NEMO) expression which is used to colorize the particles. Color will be an integer, 0 being invisible (actually: background color), 1 the foreground color, and 2,3,4... the colors your graphics device has. [Default: 1].

psize=S_expression
Size of points in cm. This is allowed to be a fie(3NEMO) expression, in terms of other columns. It must evaluate in cm. Default: 0 (dots - this is also the fastest and highly recommended)
ptype=P_expression
Point type. This is allowed to be a fie(3NEMO) expression, in terms of other columns. After evaluation, is is converted to an integer, see yapp(3NEMO) for valid ptype’s. Default: 0 (a point)
layout=layout_file
Filename with layout(5NEMO) commands to be added to plot? Default: none.
action=action_script
If given, this program is executed with a command line argument list which is the complete string that belongs to the selected point. By default no action is defined.
out=out_table
Whenever output is requested (the o command, see below), it is written to this file. Warning: Any previously existing file will be overwritten. Default: none.
options=o1,o2,..
List of options, separated by comma’s, that determine the output when out= has been selected. Valid values are i: the ordinal (1 being the first in the original data) x,y: the plotted data, data: the original (cols= only) data from the input table. Note that the order is always i, x, y, data [Default: i,x,y,data]
maxstat=level
Select a level of statistics output at startup of the program. At the lowest level (0) an overview of the read data is given, including min, max, mean, dispersion, skewness and kurtosis. At level 1 the Pearson correlation matrix is given. At level 2 all possible linear regressions are given. At level 3 at multiple regressions are given. [Default: 1]
cursor=t|f
Go into cursor mode directly? [Default: t]
headline=text
Random verbiage, will be plotted along right top of plot for id. [default: none].

Example

tabzoom does everything tabview does, and more. The new interactive commands are ’c’, ’z’ and ’Z’. First create a simple table, and tabzoom it:
  nemoinp 1:100 | tabmath - - ’ranu(0,1),sqrt(%1)+%2,%1/%3’ > tab0
  tabzoom tab0 action=echo1

with this a simple action script that simply prints out the information belonging to the selected point:

  #! /bin/csh -f
  #
  echo ECHO1 ::  $*

Interactive Slider Commands

Although the final program will have (X-window) graphic sliders, the prototype has a simple command line interface to select and manipulate sliders which provide the dynamic query. Only the first character is matched, and for some commands the second parameter is also used.

The prompt

    Slider 2 [0.0387063 0.0387063 0.998341 0.998341]:
shows the slider name (normally numbers 1...nsliders), followed by the min, lo, hi and max along the slider. The min and max can currently not be modified. The following commands are recognized:
    l <val>    set lo slider to <val> [0]
    h <val>    set hi slider to <val> [0]
    l s <step>    set lo stepper to <step> [0]
    h s <step>    set hi stepper to <step> [0]
    b <step>    set both lo and hi stepper to <step> [0]
    q             quit
    [0-9]*         select a new slider by number (>0)
    c            * cursor mode (NEW)
    z            * zoom with a box (NEW)
    Z            zoom reset to original setting
    f            * cursor flagging (EXPERIMENTAL)
    r             force full redisplay
    s             show all sliders info
    o             (over)write output (needs out= keyword)
    !cmd    run (previous) unix command
    |cmd    run data through (previous) pipe
    ?              this help

Noteworthy are the ! and | commands. They both have an optional cmd argument, which allows the user to repeat a previously set cmd for this command. The ! simply runs the cmd command through the shell, whereas the | pipes all currently visible data into the cmd command. For example to do a linear least squares fit to the visible data,

        |tablsqfit -
would be needed (see tablsqfit(1NEMO) ), all subsequents fits can be done using the
        |
command itself, since it remembers the last used |cmd.

See Also

tabview(1NEMO) , tabplot(1NEMO) , fie(3NEMO) , layout(3NEMO) , xgobi(l)

Author

Peter Teuben

Update History


1-jul-03    V1.0 cloned off tabview            PJT
22-oct-03    V1.2 added xlab, ylab, headline        PJT


Table of Contents