auto_LoadDataset

auto_LoadDataset lädt aus einer Daten-Datei, die mit der Funktion auto_ImportData geöffnet wurde, einen 1D-, 2D- oder 3D-Datensatz.

hData = auto_LoadDataset(ssDiagram, ssYName)

hData = auto_LoadDataset(ssDiagram, ssXName, ssYName)

hData = auto_LoadDataset(ssDiagram, ssXName, ssYName, ssZName)

hData = auto_LoadDataset(hLayer, ssYName)

hData = auto_LoadDataset(hLayer, ssXName, ssYName)

hData = auto_LoadDataset(hLayer, ssXName, ssYName, ssZName)

Returnwert

hData ist eine Zugriffsnummer, mit der auf den Datensatz zugegriffen werden kann (siehe Beispiel).

Parameter

ssDiagram

ssDiagram ist der Name des Diagramms, in das der Datensatz ausgegeben werden soll.

hLayer

hLayer ist die Zugriffsnummer des Diagramms, in das der Datensatz ausgegeben werden soll (siehe PageGetLayerHandle).

ssXName

ssXName Name des Kanals mit den x-Koordinaten. Die Schreibweise sollte mit der Schreibweise in der NC-Datei übereinstimmen (siehe Datei=>Daten importieren).

ssYName

ssYName Name des Kanals mit den y-Koordinaten. Die Schreibweise sollte mit der Schreibweise in der NC-Datei übereinstimmen (siehe Datei=>Daten importieren).

ssZName

ssZName Name des Kanals mit den z-Koordinaten. Die Schreibweise sollte mit der Schreibweise in der NC-Datei übereinstimmen (siehe Datei=>Daten importieren).

Kommentar

Anmerkung zum Kurvenstil: Bei 1D und 2D-Datensätzen wird der Kurvenstil des Datensatzes aus der Kurvenstildatei entnommen. Die Kurvenstile werden beginnend bei 1 durchgezählt. Für jedes Diagramm wird ein Zähler geführt. Für den ersten Datensatz, der einem Diagramm zugewiesen wird, wird der erste Datensatzstil verwendet, für den zweiten Datensatz der zweite Kurvenstil usw. Soll diese Reihenfolge geändert werden, können Sie den Zähler für das entsprechende Diagramm mit der Funktion auto_SetDatasetStyle auf den gewünschten Wert setzen.

Beispiel

Wird die Funktion nur mit einem Variablennamen aufgerufen, wird ein 1D-Datensatz erzeugt. Beispiel:

auto_LoadDataset("Diagramm 1", "Signal")

Wird die Funktion mit zwei Variablen aufgerufen, wird ein 2D-Datensatz erzeugt.

auto_LoadDataset("Diagramm 1", "Drehzahl", "Moment")

Bei Aufruf mit drei Variablen wird ein 3D-Datensatz erzeugt (Kennfeld).

auto_LoadDataset("Diagramm 1", "Drehzahl", "Moment", "be")

Im folgenden Beispiel wird gezeigt, wie die geladenen Daten transformiert werden können. Die Funktion auto_LoadDataset gibt eine Zahl zurück (Zugriffsnummer oder Handle genannt), mit der auf den geladenen Datensatz zugegriffen werden kann:

hData = auto_LoadDataset("Diagramm 1", "Drehzahl", "Moment")
if (hData != 0) {
    yscale = 2.0;
    yoffset = 1.0;
    XYSetScaleOffset(hData, [1,0,yscale, yoffset]);
}

History

Version	Beschreibung
R2013.14	Neuer erster Parameter hLayer.

Siehe auch

Überblick Automatisierung der Diagrammerstellung, auto_LoadTemplate, auto_SetTemplate, auto_LoadMatrixDataset, auto_LoadCompressorMap, PageGetLayerHandle, GetParent

_id-404676