pow_scalar_element_matrixT_pow_scalar_element_matrixPowScalarElementMatrixPowScalarElementMatrix (Operator)

Name

pow_scalar_element_matrixT_pow_scalar_element_matrixPowScalarElementMatrixPowScalarElementMatrix — Berechnet die Potenz der Elemente einer Matrix.

Signatur

pow_scalar_element_matrix( : : MatrixID, Power : MatrixPowID)

Beschreibung

Der Operator pow_scalar_element_matrixpow_scalar_element_matrixPowScalarElementMatrixPowScalarElementMatrixPowScalarElementMatrix berechnet die Potenz aller Elemente 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. Die Formel für die Berechnung lautet:

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.

Parameter

MatrixIDMatrixIDMatrixIDMatrixIDmatrixID (input_control) matrix → (handle)

Matrix Handle der Eingabematrix.

PowerPowerPowerPowerpower (input_control) number → (real / integer)

Die Potenz.

Defaultwert: 2.0

Wertevorschläge: 0.1, 0.2, 0.3, 0.5, 0.7, 1.0, 1.5, 2.0, 3.0, 5.0, 10.0

MatrixPowIDMatrixPowIDMatrixPowIDMatrixPowIDmatrixPowID (output_control) matrix → (handle)

Matrix Handle mit den potenzierten Werten der Eigabematrix.

Ergebnis

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

Vorgänger

create_matrixcreate_matrixCreateMatrixCreateMatrixCreateMatrix

Nachfolger

get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrix, get_value_matrixget_value_matrixGetValueMatrixGetValueMatrixGetValueMatrix

Alternativen

pow_scalar_element_matrix_modpow_scalar_element_matrix_modPowScalarElementMatrixModPowScalarElementMatrixModPowScalarElementMatrixMod, pow_element_matrixpow_element_matrixPowElementMatrixPowElementMatrixPowElementMatrix, pow_element_matrix_modpow_element_matrix_modPowElementMatrixModPowElementMatrixModPowElementMatrixMod

Siehe auch

sqrt_matrixsqrt_matrixSqrtMatrixSqrtMatrixSqrtMatrix, sqrt_matrix_modsqrt_matrix_modSqrtMatrixModSqrtMatrixModSqrtMatrixMod

Modul

Foundation

Operatoren