div_element_matrixdiv_element_matrixDivElementMatrixdiv_element_matrixDivElementMatrixDivElementMatrix (Operator)

Name

div_element_matrixdiv_element_matrixDivElementMatrixdiv_element_matrixDivElementMatrixDivElementMatrix — Dividiert Matrizen elementweise.

Signatur

div_element_matrix( : : MatrixAID, MatrixBID : MatrixDivID)

Der Operator div_element_matrixdiv_element_matrixDivElementMatrixdiv_element_matrixDivElementMatrixDivElementMatrix dividiert 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. Die neu erstellte Matrix MatrixDivMatrixDivMatrixDivMatrixDivMatrixDivmatrixDiv enthält das Ergebnis. Der Operator gibt das Matrix Handle MatrixDivIDMatrixDivIDMatrixDivIDMatrixDivIDMatrixDivIDmatrixDivID der Matrix MatrixDivMatrixDivMatrixDivMatrixDivMatrixDivmatrixDiv 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:

  MatrixDiv   =  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  /

                    /  2.0   1.0   0.0  \
  ->    MatrixDiv = |  1.5  -7.0   0.5  |
                    \  4.5  -1.0   0.5  /

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.

MatrixDivIDMatrixDivIDMatrixDivIDMatrixDivIDMatrixDivIDmatrixDivID (output_control) matrix → (integer)

Matrix Handle mit den dividierten Werten der Eingabematrizen.

Ergebnis

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

div_element_matrix_moddiv_element_matrix_modDivElementMatrixModdiv_element_matrix_modDivElementMatrixModDivElementMatrixMod

Siehe auch

mult_element_matrixmult_element_matrixMultElementMatrixmult_element_matrixMultElementMatrixMultElementMatrix, mult_element_matrix_modmult_element_matrix_modMultElementMatrixModmult_element_matrix_modMultElementMatrixModMultElementMatrixMod, scale_matrixscale_matrixScaleMatrixscale_matrixScaleMatrixScaleMatrix, scale_matrix_modscale_matrix_modScaleMatrixModscale_matrix_modScaleMatrixModScaleMatrixMod

Modul

Foundation

Operatoren