XYGetData gibt alle Datenpunkte oder einen Ausschnitt der Datenpunkte zurück.
Returnwert
rmXY ist die zweispaltige Matrix der Datenpunkte. rmXY[;1] sind die x-Koordinaten und rmXY[;2] sind die y-Koordinaten der Datenpunkte.
Parameter
hData ist die Zugriffsnummer (Handle) des Datensatzes, der mit XYCreate erzeugt wurde.
nFirst ist der Index des ersten Punktes der ausgelesen werden soll. Der erste Punkt hat den Index 1.
nCount ist die Anzahl der Datenpunkte, die gelesen werden sollen. Falls nCount größer ist als die Anzahl der Datenpunkte im Datensatz, wird die maximale Anzahl an Datenpunkten zurück gegeben: nCount = nData - (nFirst-1).
Der Parameter legt fest, ob die Funktion auf die Originaldaten oder die gefilterten Daten zugreift.
| Wert | Beschreibung |
|---|---|
| -1 | Falls gefilterte Daten vorhanden sind: Zugriff auf die gefilterten Daten, sonst auf die Originaldaten. Der Defaultwert ist -1. |
| 0 | Zugriff auf die Originaldaten. |
| 1 | Zugriff auf die gefilterten Daten. |
Kommentar
Wird die Funktion nur mit einem Parameter aufgerufen, werden alle Datenpunkte zurück geliefert.
Die Funktion liefert die skalierten Werte (siehe XYSetScaleOffset).
Beispiel
x = linspace(1, 100);
y = sin(x);
hvHandle = plot(x,y);
hData = hvHandle[3];
nCount = XYGetNumberOfPoints(hData);
// Hole die letzten 50 Punkte. Index: 51, 52, ... , 100
rmXY = XYGetData(hData, nCount - 50 + 1, 50);
History
| Version | Beschreibung |
|---|---|
| 5.20.0 | Die Behandlung des Parameters nCount geändert. Der Wert kann nun auch eine Maximalanzahl an gewünschten Werten enthalten. |
Siehe auch
Überblick XY-Datensätze, XYSetData, XYCreate, XYSetScaleOffset, XYSetGetOrgDataFlag
id-1966329