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