Wie importiere ich Datendateien und stelle Kanäle per Skript dar?¶
Zwei Funktionen erledigen die Hauptarbeit. auto_ImportData() liest eine
Datendatei in jedem von UniPlot unterstützten Format und wandelt sie in eine
NC-Datei um. auto_LoadDataset() übernimmt Kanäle aus dieser Datei und
fügt sie als Kurve oder Kennfeld in ein Diagramm der Vorlage ein. Zusammen mit
auto_LoadTemplate() und auto_UpdatePage() entsteht so mit wenigen
Zeilen ein vollständiger Bericht.
Mit auto_GetFileNameDialog() wählt der Anwender die Datendateien aus.¶
So funktioniert es¶
Dieses Beispiel aus den UniPlot-Beispielen (samples/automate) erzeugt zwei
Kennfelder aus der Datei map-data.xls:
auto_AddToUI("Examples", "Example 1: Map", "RS_Example1");
def RS_Example1()
{
auto_SetFileNameDialogInit("*.xls", GetRootDirectory() + "samples/");
svFile = auto_GetFileNameDialog(1);
if (svFile[1] == "DLG_CANCEL") {
return;
}
auto_LoadTemplate(GetRootDirectory() + "samples/automate/Example.ipw");
auto_ImportData(svFile[1]);
auto_LoadDataset("Diagramm 1", "N", "EWGMOM", "EWGLST");
auto_LoadDataset("Diagramm 2", "N", "EWGMOM", "BEEWG");
auto_ScaleAxes();
auto_UpdatePage();
}
auto_GetFileNameDialog(n)fragt bis zu n Dateien ab (höchstens 16) und gibt"DLG_CANCEL"zurück, wenn der Anwender abbricht.auto_LoadTemplate()kopiert eine Seite der Vorlage in ein neues Dokument und gibt das Seiten-Handle zurück.auto_ImportData()wandelt die Datei um und gibt den Namen der NC-Datei zurück. Die Datei wird außerdem für die folgendenauto_LoadDataset()- Aufrufe gemerkt.auto_LoadDataset("Diagramm 1", x, y)erzeugt eine 2D-Kurve,auto_LoadDataset("Diagramm 1", x, y, z)ein 3D-Kennfeld. Das Diagramm wird über seinen Namen in der Vorlage angesprochen.auto_UpdatePage()schließt die Seite ab.
Vorteile¶
Dieselben Zeilen funktionieren für Excel, Text, MDF und jedes andere Format, das UniPlot importieren kann.
Das Diagrammlayout liegt in der Vorlage, das Skript legt nur fest, welcher Kanal wohin gehört.
Mit den zurückgegebenen Handles lassen sich weitere Schritte ausführen, etwa Berechnungen, Stile oder Platzhalter.
Gut zu wissen¶
Kurvenstile werden der Reihe nach aus der aktiven Stildatei genommen.
auto_SetDatasetStyle()legt den Stil der nächsten Kurve fest,auto_LoadStyleFile()lädt eine andere Stildatei.Eine Vorlage kann mehrere Seiten haben. Rufen Sie vor dem nächsten
auto_LoadTemplate()die Funktionauto_AddPage()auf, um eine Seite zum selben Dokument hinzuzufügen.Die Beispiele
RS_Example1bisRS_Example5insamples/automatezeigen die nächsten Schritte: mehrere Dateien, mehrere Seiten und berechnete Kurven.
Weiterführende Themen¶
Wie vergleiche ich denselben Kanal aus Hunderten von Messdateien?
Wie erstelle ich eine Berichtsvorlage, die ich für jeden Versuch wiederverwenden kann?
Wie fülle ich Platzhalter im Bericht ohne Dialog aus der Datendatei?
Handbuch: Automatisierung der Diagrammerstellung, auto_ImportData, auto_LoadDataset, auto_LoadTemplate
Support-Fragen: Wie importiere ich eine Datei (MF4, MDF, ASCII, Excel) mit einem Script und prüfe, ob es funktioniert hat?, Wie lade ich MDF3/MDF4-Kanäle mit auto_LoadDataset, sodass jeder Kanal seinen eigenen Zeitkanal verwendet?