KlassenKlassenKlassenKlassen | | | | Operatoren

sum_matrixsum_matrixSumMatrixsum_matrixSumMatrixSumMatrix (Operator)

Name

sum_matrixsum_matrixSumMatrixsum_matrixSumMatrixSumMatrix — Gibt elementweise die Summen der Matrix zurück.

Signatur

sum_matrix( : : MatrixID, SumType : MatrixSumID)

Herror sum_matrix(const Hlong MatrixID, const char* SumType, Hlong* MatrixSumID)

Herror T_sum_matrix(const Htuple MatrixID, const Htuple SumType, Htuple* MatrixSumID)

Herror sum_matrix(const HTuple& MatrixID, const HTuple& SumType, Hlong* MatrixSumID)

HMatrix HMatrix::SumMatrix(const HTuple& SumType) const

void SumMatrix(const HTuple& MatrixID, const HTuple& SumType, HTuple* MatrixSumID)

HMatrix HMatrix::SumMatrix(const HString& SumType) const

HMatrix HMatrix::SumMatrix(const char* SumType) const

void HOperatorSetX.SumMatrix(
[in] VARIANT MatrixID, [in] VARIANT SumType, [out] VARIANT* MatrixSumID)

IHMatrixX* HMatrixX.SumMatrix([in] BSTR SumType)

static void HOperatorSet.SumMatrix(HTuple matrixID, HTuple sumType, out HTuple matrixSumID)

HMatrix HMatrix.SumMatrix(string sumType)

Beschreibung

Der Operator sum_matrixsum_matrixSumMatrixsum_matrixSumMatrixSumMatrix berechnet die Summe der Elemente der Eingabematrix MatrixMatrixMatrixMatrixMatrixmatrix. Die Eingabematrix ist durch das Matrix Handle MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID definiert. Es wird eine neue Matrix MatrixSumMatrixSumMatrixSumMatrixSumMatrixSummatrixSum mit dem Ergebnis generiert und das Matrix Handle MatrixSumIDMatrixSumIDMatrixSumIDMatrixSumIDMatrixSumIDmatrixSumID dieser Matrix zurückgegeben. Zugriff auf die Elemente der Matrix ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixget_full_matrixGetFullMatrixGetFullMatrix möglich.

Die Art der Summierung der Matrix kann mittels des Parameters SumTypeSumTypeSumTypeSumTypeSumTypesumType gewählt werden:

'columns'"columns""columns""columns""columns""columns":

Die Summierung erfolgt für jede Spalte der Matrix MatrixMatrixMatrixMatrixMatrixmatrix einzeln. Die Ergebnismatrix MatrixSumMatrixSumMatrixSumMatrixSumMatrixSummatrixSum hat eine Zeile und die gleiche Anzahl an Spalten wie die Eingabematrix.

'rows'"rows""rows""rows""rows""rows":

Die Summierung erfolgt für jede Zeile der Matrix MatrixMatrixMatrixMatrixMatrixmatrix einzeln. Die Ergebnismatrix MatrixSumMatrixSumMatrixSumMatrixSumMatrixSummatrixSum hat die gleiche Anzahl an Zeilen wie die Eingabematrix und eine Spalte.

'full'"full""full""full""full""full":

Die Summierung erfolgt über alle Elemente der Matrix MatrixMatrixMatrixMatrixMatrixmatrix. Die Ergebnismatrix MatrixSumMatrixSumMatrixSumMatrixSumMatrixSummatrixSum hat eine Zeile und eine Spalte.

Parallelisierung

Parameter

MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID (input_control)  matrix HMatrix, HTupleHTupleHMatrix, HTupleHMatrixX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Matrix Handle der Eingabematrix.

SumTypeSumTypeSumTypeSumTypeSumTypesumType (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Art der Summierung.

Defaultwert: 'columns' "columns" "columns" "columns" "columns" "columns"

Werteliste: 'columns'"columns""columns""columns""columns""columns", 'full'"full""full""full""full""full", 'rows'"rows""rows""rows""rows""rows"

MatrixSumIDMatrixSumIDMatrixSumIDMatrixSumIDMatrixSumIDmatrixSumID (output_control)  matrix HMatrix, HTupleHTupleHMatrix, HTupleHMatrixX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Matrix Handle mit den Summen der Eingabematrix.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert sum_matrixsum_matrixSumMatrixsum_matrixSumMatrixSumMatrix den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_matrixcreate_matrixCreateMatrixcreate_matrixCreateMatrixCreateMatrix

Nachfolger

get_full_matrixget_full_matrixGetFullMatrixget_full_matrixGetFullMatrixGetFullMatrix, get_value_matrixget_value_matrixGetValueMatrixget_value_matrixGetValueMatrixGetValueMatrix

Siehe auch

norm_matrixnorm_matrixNormMatrixnorm_matrixNormMatrixNormMatrix

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren