Der Operator pow_matrix_modpow_matrix_modPowMatrixModPowMatrixModPowMatrixMod berechnet die Potenz der
Eingabematrix MatrixMatrixMatrixMatrixmatrix mit einem konstanten Wert. Die
Eingabematrix MatrixMatrixMatrixMatrixmatrix ist durch das Matrix Handle
MatrixIDMatrixIDMatrixIDMatrixIDmatrixID gegeben. Die Potenz PowerPowerPowerPowerpower ist durch
den Parameter PowerPowerPowerPowerpower gegeben. Die Eingabematrix wird mit
dem Ergebnis überschrieben. Zugriff auf die Elemente der Matrix
ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrix möglich.
Der Matrixtyp wird über MatrixTypeMatrixTypeMatrixTypeMatrixTypematrixType gewählt. Zur Verfügung
stehen 'general'"general""general""general""general" für allgemeine, 'symmetric'"symmetric""symmetric""symmetric""symmetric" für
symmetrische, 'positive_definite'"positive_definite""positive_definite""positive_definite""positive_definite" für symmetrisch positiv
definite, 'tridiagonal'"tridiagonal""tridiagonal""tridiagonal""tridiagonal" für tridiagonale Matrizen,
'upper_triangular'"upper_triangular""upper_triangular""upper_triangular""upper_triangular" für obere,
'permuted_upper_triangular'"permuted_upper_triangular""permuted_upper_triangular""permuted_upper_triangular""permuted_upper_triangular" für permutierte obere,
'lower_triangular'"lower_triangular""lower_triangular""lower_triangular""lower_triangular" für untere und
'permuted_lower_triangular'"permuted_lower_triangular""permuted_lower_triangular""permuted_lower_triangular""permuted_lower_triangular" für permutierte untere
Dreiecksmatrizen. Die Formel für die Berechnung lautet:
Achtung
Wird MatrixTypeMatrixTypeMatrixTypeMatrixTypematrixType = 'symmetric'"symmetric""symmetric""symmetric""symmetric",
'positive_definite'"positive_definite""positive_definite""positive_definite""positive_definite" oder 'upper_triangular'"upper_triangular""upper_triangular""upper_triangular""upper_triangular"
gewählt, so muss der obere Dreiecksteil der Eingabematrix
MatrixMatrixMatrixMatrixmatrix die relevante Information der Matrix beinhalten.
Der exakt untere Teil der Matrix wird nicht verwendet. Wird
MatrixTypeMatrixTypeMatrixTypeMatrixTypematrixType = 'lower_triangular'"lower_triangular""lower_triangular""lower_triangular""lower_triangular" gewählt, so muss
der untere Dreiecksteil der Eingabematrix MatrixMatrixMatrixMatrixmatrix die
relevante Information der Matrix beinhalten. Der exakt obere
Teil der Matrix wird nicht verwendet. Wenn der verwendete Teil der
Eingabematrix MatrixMatrixMatrixMatrixmatrix nicht vom spezifizierten Typ ist,
wird eine Fehlerbehandlung durchgeführt.
pow_matrix_modpow_matrix_modPowMatrixModPowMatrixModPowMatrixMod verändert den Inhalt einer bereits
bestehenden Matrix.
Ausführungsinformationen
Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.
Sind die Parameterwerte korrekt, dann liefert
pow_matrix_modpow_matrix_modPowMatrixModPowMatrixModPowMatrixMod den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.