Daten aus Datei importieren

Daten können entweder klassisch aus Dateien importiert oder programmgesteuert über die REST API gesendet werden – beide Wege führen zu einer Datenquelle, deren Signale im Source Signals Browser verfügbar sind.

Sie können persistierte Mess- oder Simulationsdaten über den “Load Data Source”-Button

im Data Source Browser oder über die Befehlsleiste (Strg+P) mit dem Befehl Load Data Source laden.

Aktuell unterstützt ScryLab den Import von Dateien in folgenden Formaten:

Die folgenden Abschnitte beschreiben, wie jedes Format aufgebaut sein muss, damit ScryLab Ihre Signale korrekt einliest.

MDF

MDF (.mf4, .mf3, .dat, .mdf) ist ein standardisiertes Messformat – hier müssen Sie nichts vorbereiten. ScryLab liest die Datei so, wie sie ist:

• Jeder Datenkanal wird zu einem Signal. Der Kanalname ist der Signalname, die Einheit stammt aus den Kanal-Metadaten.
• Der Master-Channel jeder Kanalgruppe dient als x-Achse (in der Regel die Zeit).
• Kommt derselbe Kanalname mehrfach vor, wird nur die erste Occurrence importiert.

HDF5

ScryLab liest HDF5-Dateien in einem von zwei Layouts. Das Layout wird automatisch erkannt: Enthält irgendeine Group auf oberster Ebene ein Dataset namens y, wird die gesamte Datei als grouped gelesen, sonst als flat.

Grouped-Layout (empfohlen)

Jedes Signal ist eine Group, die ihre Samples als Datasets enthält. In diesem Layout schreibt ScryLab auch selbst, wenn es HDF5 exportiert.

Die Einheiten stammen aus den Group-Attributen y_unit, x_unit und z_unit (ersatzweise wird ein unit-Attribut am x/y-Dataset verwendet). Der Group-Name ist der Signalname; verschachtelte Groups sind erlaubt und werden zu einem Pfad, z. B. motor/temperatur.

# Beispiel, geschrieben mit h5py
import h5py, numpy as np

t = np.linspace(0, 1, 1000)
with h5py.File("messung.h5", "w") as f:
    g = f.create_group("Sinus 5Hz")
    g.create_dataset("x", data=t)
    g.create_dataset("y", data=np.sin(2 * np.pi * 5 * t))
    g.attrs["x_unit"] = "s"
    g.attrs["y_unit"] = "V"

Flat-Layout

Jedes 1‑D-Dataset wird als Signal behandelt (nur y-Samples); als x-Achse dient der Laufindex. Die Einheit stammt aus dem unit-Attribut des Datasets. Verschachtelte Groups werden durchlaufen und zu einem Pfad im Signalnamen.

CSV & Excel

Tabellarische Dateien werden spaltenweise importiert: jede numerische Spalte wird zu einem Signal, die Spaltenüberschrift ist der Signalname. Text-Spalten und Spalten ohne Überschrift (Unnamed: …) werden ignoriert. Bei Excel wird jedes Blatt als eigene Datenquelle importiert.

Zeitachse

ScryLab versucht, die x-Achse automatisch zu erkennen:

1. Eine Spalte mit typischem Zeit-Namen wird als Zeitachse verwendet: time, zeit, timestamp, t, sec, secs, seconds, time_s. Der Vergleich ist unabhängig von Groß-/Kleinschreibung, und ein Einheiten-Suffix in Klammern wird ignoriert – so werden auch Zeit [s] oder TIME (s) erkannt.
2. Andernfalls wird die erste Spalte verwendet, sofern sie numerisch und streng monoton steigend ist.
3. Trifft nichts davon zu, wird der Laufindex zur x-Achse.

Zeit [s]; Drehzahl; Spannung
0.00;     0.0;      1.98
0.01;     0.5;      2.01
0.02;     1.1;      2.04

Mehrere Sensoren mit eigener Zeitachse

Enthält eine Tabelle mehr als eine Zeitspalte, verwendet ScryLab ein Spaltenpaar-Layout: Jede Zeitspalte gilt für die Wertespalten rechts von ihr bis zur nächsten Zeitspalte. So lassen sich asynchron abgetastete Kanäle nebeneinander ablegen. Kürzere Kanäle dürfen mit Leerzellen aufgefüllt sein – ScryLab schneidet dieses Padding pro Signal ab.

Damit sich die Zeitspalten unterscheiden lassen, geben Sie jeder einen Zeit-Namen mit Suffix, z. B. Time_A / Time_B oder zeit_sensor1 / zeit_sensor2 – die Präfixe time_, zeit_, timestamp_ usw. werden alle erkannt. Zwei Spalten, die schlicht Time heißen, funktionieren ebenfalls (die zweite wird beim Einlesen zu Time.1 umbenannt). Was nicht geht, ist das kurze t_-Präfix (t_1, t_2): Es ist bewusst ausgeschlossen, damit eine Spalte wie t_motor (eine Temperatur) nicht als Zeitachse missverstanden wird.

Zeit_A; Druck; Zeit_B; Temperatur
0.00;   1013;  0.0;    21.4
0.01;   1012;  0.5;    21.5
0.02;   1014;  ;       21.6