.DATASET INITIALIZE

This subroutine is called to initialize a dataset.

Usage:

      PASS         <number_of_dimensions>     FIELD            SHARE? N
      PASS         <dataset_name>             FIELD            SHARE? N
      GOSUB    0CD .DATASET INITIALIZE
      IF       0CD .DATASET INITIALIZE        NE

Description:

This subroutine is called to initialize a dataset. You must call this subroutine before you can add data using .POINT ADD NEW.

<number of dimensions> must be an unsigned integer between 1-3. If <number_of_dimensions> is not received, then a default value of 1 dimension is assumed. For example, pie and bar charts only require one dimension (data is just plotted on the Y axis), while line charts require 2 dimensions (data is plotted on both the X and Y axis).

If a <dataset_name> is received, the dataset with the specified name is removed (if it exists) and a new dataset is created and initialized with the specified name.

The newly initialized dataset become the "current" dataset.

See Datasets Overview for more information on working with data.

Comments:

Read what other users have said about this page or add your own comments.

-- JeanNeron - 2011-11-11