DADiSP Worksheet Functions > Function Categories > Display and Manipulation > STRIPCHART

 

STRIPCHART

Purpose:

Overlays multiple series with separate stacked scales.

Syntax:

STRIPCHART(s1, …, sN, alt, gap, xgrid, ygrid, dir, color1, …, colorN)

sN

-

Optional. Zero or more series to stack. Defaults to the series in the current Window.

alt

-

Optional. An integer, the scales location:

 0:

left side of Window (default)

  1:

alternate left and right sides

gap

-

Optional. A real between 0 and 100. The percentage gap between each overlay. Defaults to 10.

xgrid

-

Optional. An integer, the X grid style for each overlay:

-1:

inherit current Window stripchart style (default)

 0:

no grids

 1:

solid

 2:

dashed

 3:

dotted

ygrid

-

Optional. An integer, the Y grid style for each overlay:

-1:

inherit current Window stripchart style (default)

 0:

no grids

 1:

solid

 2:

dashed

  3:

dotted

dir

-

Optional. An integer, the stacking direction:

0:

bottom-up (default)

   1:

top-down

colorN

-

Optional. A list of integers, the color for each series.

-2:

force each series to a different color

-1:

inherit current Window stripchart setting (default)

≥ 0:

one or more colors, if only one color is specified, all the series are set to that color.

Returns:

Nothing. The series are displayed as a stacked stripchart.

Examples:

W1: stripchart(gnorm(100,1), integ(gnorm(100, 1)), 1..100)

W2: integ(W1);

 

image\strip01.gif

 

W1 displays a stripchart of 3 series spaced equally apart. W2 contains a stripchart where each series is the integration of the series in W1

Example:

W1: stripchart(gnorm(100,1), integ(gnorm(100, 1)), 1..100, 1, 20, 3, 3, 1, lblue)

 

Same as above accept the scales alternate, a 20 percent gap is inserted between each overlay, dotted grids are displayed, the traces are drawn with the first trace at the top and each series is plotted in light blue.

Example:

W1: stripchart(gnorm(100,1),integ(gnorm(100,1)),1..100,1,10,3,3)

W2: integ(w1);stripchart(1,10,3,3,0,lblue,lgreen,lred)

 

W1 contains a 3 trace stripchart. W2 integrates each trace and displays a stripchart with alternating scales, a 10 percent gap and dotted grids. The color of the third trace is set to light red.

 

When W1 changes, W2 will automatically integrate each series in W1 and display the result in W2 as a stripchart.

Example:

W1: rand(1000, 3);stripchart

 

Converts the 1000x3 table of random values into a 3 trace stripchart.

Remarks:

STRIPCHART can operate on a list of input series as shown in the first example. STRIPCHART can also be used to set a plot style as part a Window formula (shown in W2 of the last example) or on a standalone basis.

 

If the value of a parameter is -1 or unspecified, the parameter is set to the corresponding Window stripchart default setting.

 

STRIPCHART uses SPANY and SETY to arrange the series as overlays with separate, stacked scales. See SETSTRIPCHARTY to set the y-range of one or more traces of the stripchart.

 

Use SETPLOTTYPE to convert a multi-column series or a Window with one or more overlays into a stacked stripchart.

 

If only one color is specified, all series are plotted in that color.

 

Set colorN to -2 to force each series to a different color irrespective of the Window stripchart setting.

 

STRIPCHART also works with XY series. For example:

 

 a = xy(1..100, gnorm(100, 1));

 b = integ(a);

 c = deriv(a);

 W1: stripchart(a, b, c);

 

The X plotting range is set to the minimum and maximum of all the traces.

 

See OVERPLOTALL to add overplots to a stripchart.

See Also:

OVERPLOTALL

SETPLOTTYPE

SETSTRIPCHARTALT

SETSTRIPCHARTCOLORMODE

SETSTRIPCHARTDIR

SETSTRIPCHARTGAP

SETSTRIPCHARTY

UNOVERPLOTALL

XYALT