sum_matrix
— Gibt elementweise die Summen der Matrix zurück.
sum_matrix( : : MatrixID, SumType : MatrixSumID)
Der Operator sum_matrix
berechnet die Summe der Elemente der
Eingabematrix Matrix
. Die Eingabematrix ist durch das
Matrix Handle MatrixID
definiert. Es wird eine neue Matrix
MatrixSum
mit dem Ergebnis generiert und das Matrix Handle
MatrixSumID
dieser Matrix zurückgegeben. Zugriff auf die
Elemente der Matrix ist z.B. mit dem Operator get_full_matrix
möglich.
Die Art der Summierung der Matrix kann mittels des Parameters
SumType
gewählt werden:
Die Summierung erfolgt für
jede Spalte der Matrix Matrix
einzeln. Die
Ergebnismatrix MatrixSum
hat eine Zeile und die gleiche
Anzahl an Spalten wie die Eingabematrix.
Die Summierung erfolgt für
jede Zeile der Matrix Matrix
einzeln. Die
Ergebnismatrix MatrixSum
hat die gleiche Anzahl an
Zeilen wie die Eingabematrix und eine Spalte.
Die Summierung erfolgt
über alle Elemente der Matrix Matrix
. Die
Ergebnismatrix MatrixSum
hat eine Zeile und eine Spalte.
MatrixID
(input_control) matrix →
(handle)
Matrix Handle der Eingabematrix.
SumType
(input_control) string →
(string)
Art der Summierung.
Defaultwert: 'columns'
Werteliste: 'columns' , 'full' , 'rows'
MatrixSumID
(output_control) matrix →
(handle)
Matrix Handle mit den Summen der Eingabematrix.
Sind die Parameterwerte korrekt, dann liefert sum_matrix
den
Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung
durchgeführt.
get_full_matrix
,
get_value_matrix
Foundation