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