pow_element_matrix_modpow_element_matrix_modPowElementMatrixModpow_element_matrix_modPowElementMatrixModPowElementMatrixMod (Operator)

Name

pow_element_matrix_modpow_element_matrix_modPowElementMatrixModpow_element_matrix_modPowElementMatrixModPowElementMatrixMod — Berechnet die Potenz der Elemente einer Matrix.

Signatur

pow_element_matrix_mod( : : MatrixID, MatrixExpID : )

Der Operator pow_element_matrix_modpow_element_matrix_modPowElementMatrixModpow_element_matrix_modPowElementMatrixModPowElementMatrixMod berechnet die Potenz aller Elemente der Eingabematrix MatrixMatrixMatrixMatrixMatrixmatrix mit den Elementen der Eingabematrix MatrixExpMatrixExpMatrixExpMatrixExpMatrixExpmatrixExp. Die Eingabematrizen MatrixMatrixMatrixMatrixMatrixmatrix und MatrixExpMatrixExpMatrixExpMatrixExpMatrixExpmatrixExp sind durch die Matrix Handles MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID und MatrixExpIDMatrixExpIDMatrixExpIDMatrixExpIDMatrixExpIDmatrixExpID gegeben. Beide Eingabematrizen müssen die gleichen Dimensionen besitzen. Die Eingabematrix MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID wird mit dem Ergebnis überschrieben. 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:


                       MatrixExp
                                ij
  Matrix   =   Matrix              .
        ij           ij

Beispiel:

           / 3.0  1.0  2.0 \                 / 1.0  2.0  2.0 \
  Matrix = | 5.0  7.0  2.0 |      PowerExp = | 2.0  0.0  3.0 |
           \ 9.0  4.0  1.0 /                 \ 0.5  3.0  1.0 /

                 /  3.0   1.0   4.0 \
  ->    Matrix = | 25.0   1.0   8.0 |
                 \  3.0  64.0   1.0 /

Achtung

pow_element_matrix_modpow_element_matrix_modPowElementMatrixModpow_element_matrix_modPowElementMatrixModPowElementMatrixMod verändert den Inhalt einer bereits bestehenden Matrix.

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

MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID (input_control) matrix → (integer)

Matrix Handle der Eingabematrix der Basis.

MatrixExpIDMatrixExpIDMatrixExpIDMatrixExpIDMatrixExpIDmatrixExpID (input_control) matrix → (integer)

Matrix Handle der Eingabematrix mit den Exponenten.

Ergebnis

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