CDDatasetInitialize < Main

Tags: view all tags
---+ .DATASET INITIALIZE

_This subroutine is called to initialize a dataset._

<br />%TOC%
---++ Usage:
<pre>      PASS         &lt;number_of_dimensions&gt;     FIELD            SHARE? N
      PASS         &lt;dataset_name&gt;             FIELD            SHARE? N
      GOSUB    0CD .DATASET INITIALIZE
      IF       0CD .DATASET INITIALIZE        NE

</pre>
---++ Description:

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

&lt;number of dimensions&gt; must be an unsigned integer between 1-3. If &lt;number_of_dimensions&gt; 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 &lt;dataset_name&gt; 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.

<div id="_mcePaste">If no &lt;dataset_name&gt; is received, the "unnamed" dataset is removed (if it exists) and a new "unnamed" dataset is created and initialized.</div>

The newly initialized dataset become the "current" dataset.

See [[CDOverviewDatasetDefinition][Datasets Overview]] for more information on working with data.
---++ Comments:

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

<br />%COMMENT%

-- Main.JeanNeron - 2011-11-11
Topic revision: r4 - 2013-02-19 - RayPelegrino