MX_WRITE – Write a Matrix/Vector to the console/system log

Block SymbolLicensing group: STANDARD
PIC

Function Description
This function block can write a vector or matrix to the console or the system log. The severity of the console/system log output is set by the parameter mode in combination with settings of system log from REXYGEN Studio, menu Target/Configure System Log. Written data can be viewed in REXYGEN Studio, after opening the system log window by the command Target/Show System Log. The function block is very useful for debugging purposes of matrix/vector algorithms.

The output references yMV is always set to the input reference uMV. If RUN = off then nothing else is done otherwise matrix or vector is written to the system log if the configured target logging level for function blocks contains the configured mode. Format of each matrix/vector element is determined by parameters mchars and mdec.

The error flag E is set to on if:

  • the reference uMV is not defined (i.e. input uMV is not connected),
  • 3 > mchars > 25,
  • 0 > mdec > mchars 2.

Inputs

uMV

Input reference to a matrix or vector

Reference

RUN

Enable execution

Bool

Parameters

Symbol

Matrix/vector symbolic name for console or log output  A

String

mchars

Number of characters per single element   3  25 8

Long (I32)

mdec

Number of decimal digits per single element   0  23 4

Long (I32)

mode

Severity mode of writing  3

Long (I32)

1 ....

None

2 ....

Verbose

3 ....

Information

4 ....

Warning

5 ....

Error

Outputs

yMV

Output reference to a matrix or vector

Reference

E

Error indicator

Bool

2024 © REX Controls s.r.o., www.rexygen.com