TYCreate

TYCreate erzeugt einen y/t Datensatz (1D-Datensatz).

hData = TYCreate(ssName)

hData = TYCreate(ssName, rvY)

hData = TYCreate(ssName, rvY, hDoc)

Returnwert

hData ist die Zugriffsnummer (Handle) mit der auf den Datensatz zugegriffen werden kann. Falls der Datensatz nicht erzeugt werden kann, ist hData gleich 0.

Parameter

ssName

ssName ist ein skalarer String mit maximal 40 Zeichen.

rvY

rvY ist ein Vektor mit den Y-Koordinaten. Der Vektor muss mindestens eine Koordinate enthalten.

hDoc

hDoc ist die Zugriffsnummer des Dokuments, dem der Datensatz zugeordnet werden soll. Ab UniPlot 5.3 wird dieser Parameter ignoriert.

Kommentar

TYCreate erzeugt einen 2D-Datensatz mit Delta-X gleich 1 und der ersten X-Koordinate gleich 0. Diese Werte können mit der Funktion TYSetMinAndDelta geändert werden. Auf den Datensatz können alle XY...-Funktionen angewendet werden.

Beim Aufruf ohne Daten wird ein leerer Datensatz erzeugt.

Beispiel

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	Beschreibung
5.3.0	hDoc ist nicht mehr erforderlich. Der Parameter wird ignoriert.

Siehe auch

Überblick XY-Datensätze, LayerCreate, TYSetMinAndDelta, TYSetData, TYAddData, XYIsTYDataset, XYCreate

_id-824057