TYCreate

TYCreate creates a new y/t datasets (1D dataset).

hData = TYCreate(ssName)

hData = TYCreate(ssName, rvY)

hData = TYCreate(ssName, rvY, hDoc)

Return Value

If the function succeeds, the return value is the handle of the newly created 1D dataset. If the function fails, the return value is 0.

Parameters

ssName

ssName is the name for the dataset.

rvY

rvY is a vector with y-coordinates.The vector must contain at least 2 elements.

hDoc

hDoc is the handle of a document which will hold the created dataset. Beginning with UniPlot 5.3 this parameter is ignored.

Comment

TYCreate creates a 2D dataset with delta x equal 1 and the first x-coordinate equal 0. These values can be changed with the TYSetMinAndDelta function. The XY…-functions can be used to modify the dataset.

A function call without data creates an empty dataset.

Example

def test_TYCreate()
{
    hDoc = DocCreate();
    hPage = PageCreate();
    DocAddPage(hDoc, hPage);

    hLayer = LayerCreate();
    PageAddLayer(hPage, hLayer);
    hData = TYCreate("Test", [3.5,5,7.5,1.5], hDoc);
    LayerAddDataset(hLayer, hData);

    TYSetMinAndDelta(hData, [1.5, 2]);

    LayerAutoScale(hLayer);
    PageReplot(hPage);
}

test_TYCreate();

History

Version	Description
5.3.0	Parameter hDoc is ignored

See also

Overview XY-Datasets, LayerCreate, TYSetMinAndDelta, TYSetData, TYAddData, XYIsTYDataset, XYCreate

_id-824057