LOADSERIES

Purpose:

Loads Series1...SeriesN from a Dataset into a list of Windows.

Syntax:

LOADSERIES(W1, ..., WN, "ser1", ..., "serN", overwrite, onewin, usecolor)

W1, ..., WN

-

Optional. A window list, the list of target Windows to load the series into. Defaults to the current window.

"ser1", ..., "serN"

-

One or more strings. A list of series to load.

overwrite

-

Optional. An integer, the overwrite existing Window series flag.

0:

do not overwrite existing series in a Window (default).

1:

overwrite existing series in a Window.

onewin

-

Optional. An integer, the flag to load the series into the current Window or to load each series into consecutive Windows.

 

0:

Loads each series into consecutive Windows beginning at the Starting Window. If there are not enough Windows, verifies to add the required amount of Windows up to the maximum (Default).

1:

Loads all the series into the specified or default Windows. The result is a multi-column Window. The overwrite flag is ignored.

2:

Loads each series into consecutive Windows beginning at the Starting Window. If there are not enough Windows, automatically adds the required amount of Windows (up to the maximum) without verification.

3:

Loads each series into consecutive Windows beginning at the Starting Window. If there are not enough Windows, prompts the user to specify the number of Windows to add.

4:

Loads all the series into the specified Window as a multi-channel stripchart.

usecolor

-

Optional. An integer, the color flag.

0:

load series using the default color (default).

1:

load multiple series with different colors.

Example:

loadseries("MYSERIES.1.SERIES")

 

loads the series MYSERIES.1.SERIES into the current Window.

Example:

loadseries(W1, W4, W5, "D.1.S1", "D.1.S2", "D.1.S3")

 

loads D.1.S1, D.1.S2, and D.1.S3 into W1, W4, and W5 respectively.

Example:

loadseries(W2..W5,"D.1.S1","D.1.S2","D.1.S3","D.1.S4",1)

 

loads the series in W2 through W5 and automatically overwrites the previous series in the Windows if they exist.

Remarks:

The specified series name is case sensitive.

 

If a specified Window already contains a series, LOADSERIES by default prompts the user for overwrite permission. LOADSERIES also accepts an optional overwrite flag to automatically overwrite existing series in a Window without prompting.

 

If a version number is not specified in the Dataset name, the series from the last available version for the Dataset is loaded. A version number of 3 also implies last version.

 

A version number of 0 implies load the series from the first available version of the Dataset.

 

See LOADDATASET to load all the series in a Dataset into one or more windows.

See Also:

DELETESERIES

ISWINDS

LOADDATASET

OPENLABBOOK

SAVESERIES