LGF_MatrixSubtraction (FC / V3.0.1)

Autor: Siemens Digital Industries

Kurzbeschreibung

Diese Funktion subtrahiert eine Matrix vom Datentyp ARRAY[*,*] of LREAL von einer anderen.

Die einzelnen Felder der zwei Matrizen werden gelesen, subtrahiert und anschließend in der Matrix matrixResult" ausgegeben.

result = \begin{bmatrix} a_{11} & \cdots & a_{1n} \\ \vdots & \ddots & \vdots \\ a_{m1} & \cdots & a_{mn} \end{bmatrix} - \begin{bmatrix} b_{11} & \cdots & b_{1n} \\ \vdots & \ddots & \vdots \\ b_{m1} & \cdots & b_{mn} \end{bmatrix} = \begin{bmatrix} a_{11}-b_{11} & \cdots & a_{1n}-b_{1n} \\ \vdots & \ddots & \vdots \\ a_{m1}-b_{m1} & \cdots & a_{mn}-b_{mn} \end{bmatrix}

Hinweis: Beachten Sie, dass alle Ein- und Ausgangsmatrizen die gleiche Anzahl an Spalten und Zeilen haben müssen.

Baustein Schnittstelle


		Ret_Val	Void
		Ret_Val	Void
		error	Bool
		error	Bool
		status	Word
		status	Word
Array[, ] of LReal	matrix1		Array[, ] of LReal
Array[, ] of LReal			Array[, ] of LReal
Array[, ] of LReal	matrix2		Array[, ] of LReal
Array[, ] of LReal			Array[, ] of LReal
Array[, ] of LReal	matrixResult		Array[, ] of LReal
Array[, ] of LReal			Array[, ] of LReal

Output Parameter

Bezeichner	Datentyp	Beschreibung
Ret_Val	Void	Void - Funktion hat keinen Rückgabewert
error	Bool	FALSE: Kein Fehler TRUE: Während der Ausführung des FB ist ein Fehler aufgetreten
status	Word	16#0000-16#7FFF: Status des FB 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)

In/Out Parameter

Bezeichner	Datentyp	Beschreibung
matrix1	Array[, ] of LReal	Erste Matrix - Minuend
matrix2	Array[, ] of LReal	Zweite Matrix - Subtrahend
matrixResult	Array[, ] of LReal	Summen Matrix

Status & Error Meldungen

Code / Wert	Bezeichner / Beschreibung
16#0000	STATUS_NO_ERROR Abarbeitung ohne Fehler beendet
16#8200	ERR_MATR1_LOWBOUND_ROWS_MATR2_LOWBOUND_ROWS Error: Untere Grenzen rows(Dim1) der Arrays von Matrix1 und Matrix2 sind unterschiedlich.
16#8201	ERR_MATR1_LOWBOUND_ROWS_RESMATR_LOWBOUND_ROWS Error: Untere Grenzen rows(Dim1) der Arrays von Matrix1 und Result Matrix sind unterschiedlich.
16#8202	ERR_MATR1_LOWBOUND_COLUMNS_MATR2_LOWBOUND_COLUMNS Error: Untere Grenzen columns(Dim2) der Arrays von Matrix1 und Matrix2 sind unterschiedlich.
16#8203	ERR_MATR1_LOWBOUND_COLUMNS_RESMATR_LOWBOUND_COLUMNS Error: Untere Grenzen columns(Dim2) der Arrays von Matrix1 und Result Matrix sind unterschiedlich.
16#8204	ERR_MATR1_UPPBOUND_ROWS_MATR2_UPPBOUND_ROWS Error: Obere Grenzen rows(Dim1) der Arrays von Matrix1 und Matrix2 sind unterschiedlich.
16#8205	ERR_MATR1_UPPBOUND_ROWS_RESMATR_UPPBOUND_ROWS Error: Obere Grenzen rows(Dim1) der Arrays von Matrix1 und Result Matrix sind unterschiedlich.
16#8206	ERR_MATR1_UPPBOUND_COLUMNS_MATR2_UPPBOUND_COLUMNS Error: Obere Grenzen columns(Dim2) der Arrays von Matrix1 und Matrix2 sind unterschiedlich.
16#8207	ERR_MATR1_UPPBOUND_COLUMNS_RESMATR_UPPBOUND_COLUMNS Error: Obere Grenzen columns(Dim2) der Arrays von Matrix1 und Result Matrix sind unterschiedlich.

Änderungshistorie

Version & Datum		Änderungsbeschreibung
	01.00.00	Siemens Industry Online Support
	19.08.2015	First released version
	01.00.01	Siemens Industry Online Support
	02.01.2017	Upgrade: TIA Portal V14 Update 1
	02.00.00	Siemens Industry Online Support
	06.02.2017	Functionality using Array[,]
	02.00.01	Siemens Industry Online Support
	17.08.2018	Upgrade: TIA V15 Update 2
	02.00.06	Simatic Systems Support
	07.10.2019	Regions, comments and constants are added Moved matrices to IO field.
	03.00.00	Simatic Systems Support
	23.04.2020	Set version to V3.0.0, harmonize the version of the whole library
	03.00.01	Simatic Systems Support
	02.02.2020	Insert documentation