DADiSP Worksheet Functions > Function Categories > XY Functions > XYTAB

 

XYTAB

Purpose:

Creates a table of multiple XY series from a table.

Syntax:

XYTAB(data, x, collist, interval)

data

-

A table or series of Y values.

x

-

Optional. A series or integer. A series of X values or the column number in data containing the X values. Defaults to the first column in data.

collist

-

Optional. A series or column number from data to use as the Y values. Defaults to all the columns except the X column.

interval

-

Optional. A real specifying the interpolation interval.

-2.0:

No interpolation, return XY series (default).

-1.0:

Automatically determine interpolation interval.

0.0:

Create interval series but preserve all Y values.

> 0.0:

Use the specified interpolation interval.

Returns:

A table of one or more XY series or interpolated interval series.

Example:

W1: ravel(1..10, randn(10, 1), integ(randn(10, 1)));

W2: xytab(w1)

W3: getitem(W2, 2)

 

W1 contains 3 columns of data where the first column is the X data and columns 2 and 3 are the Y values.

 

W2 converts the 3 column table into 2 XY plots (a total of 4 columns) where the X data for each XY series is column 1 of W1.

 

W3 returns the second XY plot from the XY table in W2.

Example:

W1: ravel(1..10, randn(10, 1), integ(randn(10, 1)));

W2: stripchart(xytab(w1))

 

W1 contains 3 columns of data where the first column is the X data and columns 2 and 3 are the Y values.

 

W2 converts the 3 column table into 2 XY plots (a total of 4 columns) and plots each XY as a STRIPCHART.

Example:

W1: ravel(1..10, randn(10, 1), integ(randn(10, 1)));

W2: stripchart(xytab(w1, 2))

 

Same as above except the X values are column 2 of W1 and the Y values are column 1 and column 3 of W1.

Example:

W1: ravel(1..10, randn(10, 1), integ(randn(10, 1)));

W2: stripchart(xytab(w1, 1, 0.5))

 

W1 contains 3 columns of data where the first column is the X data and columns 2 and 3 are the Y values.

 

W2 converts the 3 column table into 2 regularly sampled interval series with a DELTAX of 0.5 (a total of 2 columns) and plots each series as a STRIPCHART.

Remarks:

XYTAB creates a table of XY plots from a table where typically one column is the X data and the remaining columns are the Y data. By default, the first column of the input table is considered the X values and the remaining columns are the Y values.

 

See XYINTERP for a discussion of interval series and XY interpolation.

 

Use GETITEM  to extract a specific XY plot from the result.

 

See XYDTTAB to create a table of XY plots from date, time and Y data.

See Also:

GETITEM

STRIPCHART

XY

XYDT

XYDTTAB

XYINTERP