DADiSP Worksheet Functions > Function Categories > Query Functions > NUMFOCUS

 

NUMFOCUS

Purpose:

Returns the total number of overlay foci in a Window.

Syntax:

NUMFOCUS(win)

win

-

Optional. Window reference. Defaults to current Window.

Returns:

An integer, the total number of overlays (foci) in a Window.

Example:

W1: integ(gnorm(1000, 1))

W2: integ(gnorm(1000, 1))

W3: W1;overplot(w2, lred)

W4: W1;overlay(w2, lred)

 

f1 = numfocus(w3);

f2 = numfocus(w4);

 

f1 == 1

f2 == 2

 

W3 contains a series and an overplot.  W4 contains a series and an overlay.  Although W3 contains two series, there is only one focus, i.e.  no overlay so f1 == 1. Because W4 contains an overlay, f2 == 2 indicating there are two foci in W4.

Remarks:

See OVERLAY, OVERPLOT and STRIPCHART for methods to plot multiple series in a single window.

See Also:

ITEMCOUNT

NUMCOLS

NUMITEMS

OVERLAY

OVERPLOT

STRIPCHART