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.
Beispiel:
SumType = 'columns'
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.
Beispiel:
SumType = 'rows'
Die Summierung erfolgt
über alle Elemente der Matrix Matrix. Die
Ergebnismatrix MatrixSum hat eine Zeile und eine Spalte.
Beispiel:
SumType = 'full'
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