Vektor/Matrix-Laden
Mit diesem Baustein können abgespeicherte Daten aus einer Datei gelesen und in einer anliegenden Matrix (Vektor, Einzelwert) abgelegt werden.
Die aus der Datei FName gelesenen Werte werden in die bereitgestellte Matrix (Vektor, Einzelwert) VX geschrieben. Stimmen die Dimension der Matrix aus der Datei und der bereitgestellten Matrix VX nicht überein, so werden dennoch so viele Werte wie möglich übertragen (siehe Beispiel unten). Gleiches gilt dem entsprechend für Vektoren.
Der Lesevorgang wird nur ausgeführt, wenn am Trigger-Eingang ein Flankenwechsel auf HIGH stattfindet. Vor dem Laden wird der in der Datei gespeicherte Datentyp überprüft. Inkompatible Dateien können nicht geladen werden.
Am Ausgang Num wird die Anzahl der gelesenen Elemente bereitgestellt. Negative Werte weisen den Lesestatus aus oder auf Fehler hin:
| -1 | Kein Lesevorgang ausgeführt |
| -2 | Kein Dateiname übergeben |
| -3 | Datei konnte nicht geöffnet werden |
| -4 | Dateiformat nicht erkannt/ungültig |
| -5 | Inkompatible Datentypen |
| -6 | Fehler im Dateiheader |
| -1000 | Baustein ist nicht im Zielsystem implementiert |
Trigger -> Wechsel auf HIGH = Lesevorgang
Beispiel
Signale
| Name | I/O | Typ(en) | Funktion |
|---|---|---|---|
| VX | I/O | datentypunabhängig | Ein- und Ausgangsvektor |
| FName | I | TEXT | Dateiname |
| Trigger | I | BIT | Triggert den Lesevorgang |
| Num | O | LONG | Anzahl der gelesenen Elemente, Status- bzw. Fehlermeldung |
Visualisierung
Der ausgewählte Datentyp wird farblich dargestellt.
Bemerkungen
Bei der Wahl des Dateinamens müssen die Einschränkungen des vorliegenden Zielsystems beachtet werden. Dieser Hinweis bezieht sich neben den Konventionen für die Namensbildung (z.B. unerlaubte Zeichen) auch auf die Angabe von relativen oder absoluten Pfaden.
Beispiel
