Der Operator pow_matrixpow_matrixPowMatrixPowMatrixPowMatrix 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. Es wird eine neue Matrix
MatrixPowMatrixPowMatrixPowMatrixPowmatrixPow mit dem Ergebnis generiert. Der Operator gibt
das Matrix Handle MatrixPowIDMatrixPowIDMatrixPowIDMatrixPowIDmatrixPowID der Matrix
MatrixPowMatrixPowMatrixPowMatrixPowmatrixPow zurück. 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.
Ausführungsinformationen
Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Sind die Parameterwerte korrekt, dann liefert pow_matrixpow_matrixPowMatrixPowMatrixPowMatrix
den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung
durchgeführt.