XYCreate

XYCreate erzeugt einen 2D-Datensatz.

hData = XYCreate(ssName)

hData = XYCreate(ssName, rvX, rvY)

hData = XYCreate(ssName, rvX, 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.

rvX

rvX ist ein Vektor mit den X-Koordinaten.

rvY

rvY ist ein Vektor mit den Y-Koordinaten.

hDoc

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

Kommentar

Die Anzahl der Elemente der Vektoren rvX und rvY muss übereinstimmen. Die Mindestanzahl ist 1.

Beim Aufruf ohne Daten wird ein leerer Datensatz erzeugt.

Beispiel

def test()
{
    hDoc = DocCreate();
    hPage = PageCreate();
    DocAddPage(hDoc, hPage);
    hLayer = LayerCreate();
    PageAddLayer(hPage, hLayer);
    hData = XYCreate("Test", [1.6,2,4,6.3], [3,5,6.5,1.5]);
    LayerAddDataset(hLayer, hData);
    XYShowMarker(hData, 1)
    LayerAutoScale(hLayer);
    PageReplot(hPage);
}
test()

History

Version	Beschreibung
5.3.0	Aufruf mit einem Parameter erzeugt einen leeren Datensatz.

Siehe auch

Überblick XY-Datensätze, Überblick Datendatei-Informationen für Datensätze, XYSetData, XYAddData, LayerCreate, TYCreate, DS_SetDataSource

_id-769003