Table of Contents

**tabplot in=**infile [parameter=value]

*tabplot*
can also plot one-to-many, many-to-one as well as pair-wise plotting. However,
it is (not yet) possible to pair-wise plot from multiple files with different
number of rows. See also *paste(1)*
or *tabmath(1NEMO)*
how to combine tables.

*tabplot* is really intended for quick and dirty display of the data. For
more complicated plots, full plotting packages should be used (Mongo, SM,
WIP, gnuplot, Grace, matplotlib etc.), though moderately sophisticated
plots can also be made using **layout=**. The **readline=** is available to give
some degree of interactive usage.

**in=***infile*- input file, in (ASCII) tabular format [no default].
**xcol=***x-column*- column(s) from which
the X values are taken. Multiple columns can be taken, but if so, the number
of Y columns must be the same for pairwise plotting. [default
**1**]. **ycol=***y-column*- column from which the Y values are taken. Multiple columns can be given.
The number of X columns can either be 1 or must be equal to the number
of Y columns. [default
**2**]. **xmin=***x_min*- Minimum value along X-axis to include [default: minimum of datapoints].
**xmax=***x_max*- Maximum value along X-axis to include [default: maximum of datapoints].
**ymin=***y_min*- Minimum value along y-axis to include [default: minimum of datapoints].
**ymax=***y_max*- Maximum value along y-axis to include [default: maximum of datapoints].
**xbin=***boundaries*- When used either the number of datapoints used to average to a plotted
datapoint or the bin boundaries (in X-world-coordinates) must be given. The
program can distinguish from both cases by the number of variables given
to this keyword. One means fixed number of datapoints used in averaging,
more than one means the numbers are bin boundaries. The output is controlled
using
**tab=**and contains the mean X, Y followed by the dispersion in X and Y and the number of points in that bin. [default: not used, datapoints from file are used]. **point=***type,size*- Pairs of integers, (one pair for each plotted
column) describing the point type (0=none, 1=point, 2=circle, 3=plus, 4=square)
and size in cm (see also
*yapp(3NEMO)*). Pairs not specified inherit from the last one entered. Default: 1,0.1 **line=***type,width*- Pairs of integers, (one
pair for each plotted column) describing the line type and width (see
*plltype(3NEMO)*). Default: 0,0 **color=***color*- Integer denoting color. This will be
*yapp(3NEMO)*specific. Colors not specified will inherit from the last one entered. Default: not used (i.e. default drawing color used) **errors=x|y|xy**- Specify which error bars to draw in case binning is used. If error bars are used in either raw X or Y columns, this option cannot be used. Default: none.
**xlab=***x-label*- Label
along the X-axis [default:
**X**]. **ylab=***y-label*- Label along the Y-axis [default:
**Y**]. **xcoord=***x1,x2,...*- A list of numbers (see
*nemoinp(3NEMO)*for valid syntax) that will cause vertical lines at these X coordinate to be drawn. Default: none **ycoord=***y1,y2,...*- Y coordinates for the horizontal lines, same as
**xcoord=**. **xbox=**- Extent of the plotting frame in the X direction. [Default: 2:18]
**ybox=**- Extent of the plotting frame in the Y direction. [Default: 2:18]
**nxticks=**- Number of tickmarks along the X axis. This divides the X axis in
*nxticks+1*pieces. [Default:**7**]. **nyticks=**- Same for Y.
**xscale=**- Scaling factor applied to all X values. Default: 1
**yscale=**- Scaling factor applied to all Y values. Default: 1
**dxcol=**- Columns representing error bars in X. These currently
need to match the
**xcol=**. By default no error column(s) are used. **dycol=**- Columns
representing error bars in Y. These currently need to match the
**ycol=**. By default no error column(s) are used. **nmax=**- Maximum number of lines that are allocated in pipes. [10000]
**median=f|t**- Use median to compute "average"
binning values. It is used to compute the X as well as Y coordinates of
the binned point, however error bars are still computed using the mean.
Default:
**f**. **headline=***text*- Random verbiage, will be plotted along right top
of plot for id. [default: none]. The left top will contain the filename
*infile*. **tab=t|f**- Output table to stdout if binning is used? Default: false;
**fullscale=t|f**- Use full scale in one axis if other axis is autoscaled? In versions older than 2.0 fullscale was always on (t), by default it is now off (f).
**cursor=**- This will be the name of an ascii file that will contain coordinates that have been marked with the cursor, not the nearest datapoint (currently only implemented for PGPLOT). Cursor keys are in the usual definition: A=left mouse will mark, D=middle mouse has no function, X=right mouse will exit. Default: not used.
**layout=**- Optional Layout file that contains draw commands. Default: none.
**first=t|f**- Should the layout file be called first or last ?
[
**f**] **readline=t|f**- After all batch plotting is done, should an interactive
layout annotator (see also
*layout(5NEMO)*) be called. [**f**] **pyplot=**- If given, it will be the filename where a template python script that can serve as starting point for more elaborate plotting. Default: none.

% nemoinp 1:20 | tabmath - - ’ranu(0,1),ranu(0,1)’ all > ran.tab % tabmath ran.tab - ’2+%1*16,2+%2*16,0.2’ all | awk ’{print "circle",$0}’ > ran.layout % tabplot ran.tab 1 2 0 1 0 1 layout=ran.layoutIt plots the data points from the file

Here are some examples of
plotting multiple columns/rows, assuming each example of the tab1 and tab2
table has 2 columns:

% paste tab1 tab2 | tabplot - 1 4 headline=x1,y2 % tabmath tab1,tab2 - %1-%3,%2-%4 all | tabplot - 1 2 headline=dx,dy % paste tab1 tab2 | tabplot - 1,3 2 headline=x1,x2,y1 % paste tab1 tab2 | tabplot - 1 2,4 headline=x1,y1,y2 % paste tab1 tab2 | tabplot - 1,2 3,4 headline=(x1,y1),(x2,y2) See Alsotablsqfit(1NEMO), tabmath(1NEMO), yapp(5NEMO) http://vostat.org http://www.star.bris.ac.uk/~mbt/stilts/ AuthorPeter Teuben Files ~/src/kernel/tabtabplot.c

25-nov-88V1.0 - createdPJT 13-nov-90V1.1 deleted nmax= by using file_lines()PJT 26-jan-95V1.5a multi-column plotting support, trickmarks, extra coord linesPJT 14-feb-96V1.6 added cursor= keyword (*PGPLOT only*)PJT 7-may-98V2.0 added median= for binning methodPJT 25-jul-98V2.0b added line=lwidth,lstyle w/ lstyle<0 histogram (thank Kartik)PJT 31-mar-99V2.1 autoscaling now takes range in other axis into accountPJT 28-jul-99V2.2 added color= 21-jul-00V2.3 min & max can be separately setPJT 2-aug-02V2.5 allow number of x columns to be > 1PJT 17-sep-05V2.8 added readline= and documented first=PJT 2-dec-05V2.9 implemented missing many-to-one plotting modePJT 20-dec-05V3.0 added xscale,yscale and started dxcol,dycol. Fixed xbin= bugPJT 10-oct-06V3.0e finished dxcol=, dycol=PJT 8-jan-2020V4.0 added pyplot=PJT