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

Block SymbolLicensing group: STANDARD

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

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