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.

Dateiauswahl-Dialog, geöffnet von auto_GetFileNameDialog

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();
}
  1. auto_GetFileNameDialog(n) fragt bis zu n Dateien ab (höchstens 16) und gibt "DLG_CANCEL" zurück, wenn der Anwender abbricht.

  2. auto_LoadTemplate() kopiert eine Seite der Vorlage in ein neues Dokument und gibt das Seiten-Handle zurück.

  3. auto_ImportData() wandelt die Datei um und gibt den Namen der NC-Datei zurück. Die Datei wird außerdem für die folgenden auto_LoadDataset()- Aufrufe gemerkt.

  4. 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.

  5. 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 Funktion auto_AddPage() auf, um eine Seite zum selben Dokument hinzuzufügen.

  • Die Beispiele RS_Example1 bis RS_Example5 in samples/automate zeigen die nächsten Schritte: mehrere Dateien, mehrere Seiten und berechnete Kurven.

Weiterführende Themen