MX_DIMSET – Set Matrix/Vector dimensions

Block SymbolLicensing group: STANDARD

Function Description
The function block MX_DIMSET sets number rows m of the vector or number of rows m, number of columns n and the leading dimension ld of the matrix referenced by uMV. If any of the inputs m, n, ld is not connected, its original value is retained.

The output cnt contains the actual number of occupied elements of the matrix/vector and is determined by the formula

cnt = ld * (n - 1) + m \leq amax,

where the output amax is the allocated count of matrix/vector elements. If this inequality is fulfilled the output cnt is set to the matrix/vector structure and can be retrieved by the MX_DIM block, otherwise the value of cnt shows the minimum necessary number of elements of the matrix/vector.

The output reference yMV is always set to the corresponding input reference uMV.

The error flag E is set to on if:

the reference uMV is not defined (i.e. input uMV is not connected),
the number of rows m < 1 or m > ld,
the number of columns n < 1,
the required number of elements cnt > amax.

This block does not propagate the signal quality. More information can be found in the 1.4 section.

Input

uMV	Input reference to a matrix or vector	Reference
m	Number of matrix rows	Long (I32)
n	Number of matrix columns	Long (I32)
ld	Leading dimension (>= number of rows)	Long (I32)

Output

yMV	Output reference to a matrix or vector	Reference
cnt	Count of used matrix elements	Long (I32)
amax	Count of allocated elements (>= number of rows * number of columns	Long (I32)
E	Error indicator	Bool

[Previous] [Back to top] [Up] [Next]