LOADDATASET

Purpose:

Loads an entire Dataset into a Worksheet from a starting Window.

Syntax:

LOADDATASET(win, "dsname", overwrite, onewin, usecolor)

win

-

Optional. A window, the starting Window. Defaults to the current Window.

"dsname"

-

A string. The name of the Dataset to load.

overwrite

-

Optional. An integer, the overwrite series flag.

0:

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

1:

overwrite existing series in a Window with series from the dataset.

onewin

-

Optional. An integer, the flag to load the entire Dataset 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:

loaddataset("RUN1.1")

 

loads all the series in Dataset RUN1.1 into the Windows starting from the current Window. If there are not enough consecutive Windows, the user is prompted whether the required number of Windows should be added.

 

If a version number is not specified, it is defaulted to the last (most current) version. The starting Window may also be specified as below:

Example:

loaddataset(W4, "RUN1.1")

Example:

loaddataset(W4, "RUN1")

 

Same as above, but since a version number was not included in the Dataset name, the last available version of the Dataset RUN1 is loaded.

Example:

loaddataset(W4, "RUN1.1", 1, 1)

 

loads all the series in Dataset RUN1.1 into W4 as a multi-column series.

Example:

loaddataset(W4, "RUN1.1", 1, 1, 1)

 

loads all the series in Dataset RUN1.1 into W4 as a multi-column series. Each series is displayed in a different color.

Remarks:

The specified Dataset name is case sensitive.

 

If a specified Window already contains a series, LOADDATASET by default prompts the user for overwrite permission. LOADDATASET 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 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 first available version of the Dataset.

 

Additional colors can be specified by editing the system file PALETTE.MAC.

See Also:

DELETEDATASET

IMPORTFILE

ISWINDS

LOADSERIES

OPENLABBOOK

SAVESERIES

STRIPCHART