Vektor/Matrix Load

With this function block, saved data can be read from a file and loaded into a connected matrix (vector, single value).

The matrix (vector, single value) VX will be filled with the elements loaded from the file FName. If the dimension of an object at VX does not correspond to the dimension of the data in the file, fitting elements will be transferred, nonetheless (see example below).

Data will only be read, if a positive going edge occurs on the Trigger input. Before loading any date, the data type of the elements in the file are checked. Only if the data is compatible to VX the file will be read.

The output Num gives the number of read elements. A negative value indicates an error or shows that the function block is not operating:

-1 Function block does not operate
-2 No file name given
-3 Could not open file
-4 Unknown/invalid file format
-5 Date type incompatible
-6 Error in the file header
-1000 Target function not available

Trigger -> change to HIGH = Read data

Signals

Name I/O Type(s) Function
VX I/O Data type independent In-/output vector/matrix
FName I TEXT File name
Trigger I BIT Trigger to read data
Num O LONG Number of read elements or status information

Visualization

The selected data type will be displayed by the assorted color.

Comments

The file name must follow the principles of the target system. This covers the conventions for the name itself (e.q. accepted characters) and the use of relative or absolute path information.

Example