mult_element_matrixmult_element_matrixMultElementMatrixmult_element_matrixMultElementMatrixMultElementMatrix (Operator)

Name

mult_element_matrixmult_element_matrixMultElementMatrixmult_element_matrixMultElementMatrixMultElementMatrix — Multipliziert Matrizen elementweise.

Signatur

mult_element_matrix( : : MatrixAID, MatrixBID : MatrixMultID)

Der Operator mult_element_matrixmult_element_matrixMultElementMatrixmult_element_matrixMultElementMatrixMultElementMatrix multipliziert die zwei Eingabematrizen MatrixAMatrixAMatrixAMatrixAMatrixAmatrixA und MatrixBMatrixBMatrixBMatrixBMatrixBmatrixB Element für Element. Die Matrizen sind durch die Matrix Handles MatrixAIDMatrixAIDMatrixAIDMatrixAIDMatrixAIDmatrixAID und MatrixBIDMatrixBIDMatrixBIDMatrixBIDMatrixBIDmatrixBID gegeben. Beide Eingabematrizen müssen die gleiche Dimension besitzen. Es wird eine neue Matrix MatrixMultMatrixMultMatrixMultMatrixMultMatrixMultmatrixMult generiert und das Ergebnis in dieser gespeichert. Der Operator gibt das Matrix Handle MatrixMultIDMatrixMultIDMatrixMultIDMatrixMultIDMatrixMultIDmatrixMultID der Matrix MatrixMultMatrixMultMatrixMultMatrixMultMatrixMultmatrixMult zurück. Zugriff auf die Elemente der Matrix ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixget_full_matrixGetFullMatrixGetFullMatrix möglich. Die Formel für die Berechnung lautet:

  MatrixMult   =  MatrixA    * MatrixB  .
            ij           ij           ij

Beispiel:

            /   4.0   8.0   0.0  \                /   2.0   8.0  -3.0  \
  MatrixA = |  -6.0   7.0   2.0  |      MatrixB = |  -4.0  -1.0   4.0  |
            \  -9.0   4.0   1.0  /                \  -2.0  -4.0   2.0  /

                     /   8.0   64.0   0.0  \
  ->    MatrixMult = |  24.0   -7.0   8.0  |
                     \  18.0  -16.0   2.0  /

Parallelisierung

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

MatrixAIDMatrixAIDMatrixAIDMatrixAIDMatrixAIDmatrixAID (input_control) matrix → (integer)

Matrix Handle der Eingabematrix A.

MatrixBIDMatrixBIDMatrixBIDMatrixBIDMatrixBIDmatrixBID (input_control) matrix → (integer)

Matrix Handle der Eingabematrix B.

MatrixMultIDMatrixMultIDMatrixMultIDMatrixMultIDMatrixMultIDmatrixMultID (output_control) matrix → (integer)

Matrix Handle mit den multiplizierten Werten der Eingabematrizen.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert mult_element_matrixmult_element_matrixMultElementMatrixmult_element_matrixMultElementMatrixMultElementMatrix 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

Alternativen

mult_element_matrix_modmult_element_matrix_modMultElementMatrixModmult_element_matrix_modMultElementMatrixModMultElementMatrixMod

Siehe auch

div_element_matrixdiv_element_matrixDivElementMatrixdiv_element_matrixDivElementMatrixDivElementMatrix, div_element_matrix_moddiv_element_matrix_modDivElementMatrixModdiv_element_matrix_modDivElementMatrixModDivElementMatrixMod, scale_matrixscale_matrixScaleMatrixscale_matrixScaleMatrixScaleMatrix, scale_matrix_modscale_matrix_modScaleMatrixModscale_matrix_modScaleMatrixModScaleMatrixMod

Modul

Foundation

Operatoren