KlassenKlassenKlassenKlassen | | | | Operatoren

pow_matrixpow_matrixPowMatrixpow_matrixPowMatrixPowMatrix (Operator)

Name

pow_matrixpow_matrixPowMatrixpow_matrixPowMatrixPowMatrix — Berechnet die Potenz einer Matrix.

Signatur

pow_matrix( : : MatrixID, MatrixType, Power : MatrixPowID)

Herror pow_matrix(const Hlong MatrixID, const char* MatrixType, double Power, Hlong* MatrixPowID)

Herror T_pow_matrix(const Htuple MatrixID, const Htuple MatrixType, const Htuple Power, Htuple* MatrixPowID)

Herror pow_matrix(const HTuple& MatrixID, const HTuple& MatrixType, const HTuple& Power, Hlong* MatrixPowID)

HMatrix HMatrix::PowMatrix(const HTuple& MatrixType, const HTuple& Power) const

void PowMatrix(const HTuple& MatrixID, const HTuple& MatrixType, const HTuple& Power, HTuple* MatrixPowID)

HMatrix HMatrix::PowMatrix(const HString& MatrixType, const HTuple& Power) const

HMatrix HMatrix::PowMatrix(const HString& MatrixType, double Power) const

HMatrix HMatrix::PowMatrix(const char* MatrixType, double Power) const

void HOperatorSetX.PowMatrix(
[in] VARIANT MatrixID, [in] VARIANT MatrixType, [in] VARIANT Power, [out] VARIANT* MatrixPowID)

IHMatrixX* HMatrixX.PowMatrix(
[in] BSTR MatrixType, [in] VARIANT Power)

static void HOperatorSet.PowMatrix(HTuple matrixID, HTuple matrixType, HTuple power, out HTuple matrixPowID)

HMatrix HMatrix.PowMatrix(string matrixType, HTuple power)

HMatrix HMatrix.PowMatrix(string matrixType, double power)

Beschreibung

Der Operator pow_matrixpow_matrixPowMatrixpow_matrixPowMatrixPowMatrix berechnet die Potenz der Eingabematrix MatrixMatrixMatrixMatrixMatrixmatrix mit einem konstanten Wert. Die Eingabematrix MatrixMatrixMatrixMatrixMatrixmatrix ist durch das Matrix Handle MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID gegeben. Die Potenz PowerPowerPowerPowerPowerpower ist durch den Parameter PowerPowerPowerPowerPowerpower gegeben. Es wird eine neue Matrix MatrixPowMatrixPowMatrixPowMatrixPowMatrixPowmatrixPow mit dem Ergebnis generiert. Der Operator gibt das Matrix Handle MatrixPowIDMatrixPowIDMatrixPowIDMatrixPowIDMatrixPowIDmatrixPowID der Matrix MatrixPowMatrixPowMatrixPowMatrixPowMatrixPowmatrixPow zurück. Zugriff auf die Elemente der Matrix ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixget_full_matrixGetFullMatrixGetFullMatrix möglich.

Der Matrixtyp wird über MatrixTypeMatrixTypeMatrixTypeMatrixTypeMatrixTypematrixType gewählt. Zur Verfügung stehen 'general'"general""general""general""general""general" für allgemeine, 'symmetric'"symmetric""symmetric""symmetric""symmetric""symmetric" für symmetrische, 'positive_definite'"positive_definite""positive_definite""positive_definite""positive_definite""positive_definite" für symmetrisch positiv definite, 'tridiagonal'"tridiagonal""tridiagonal""tridiagonal""tridiagonal""tridiagonal" für tridiagonale Matrizen, 'upper_triangular'"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""permuted_upper_triangular" für permutierte obere, 'lower_triangular'"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""permuted_lower_triangular" für permutierte untere Dreiecksmatrizen. Die Formel für die Berechnung lautet:

Achtung

Wird MatrixTypeMatrixTypeMatrixTypeMatrixTypeMatrixTypematrixType = 'symmetric'"symmetric""symmetric""symmetric""symmetric""symmetric", 'positive_definite'"positive_definite""positive_definite""positive_definite""positive_definite""positive_definite" oder 'upper_triangular'"upper_triangular""upper_triangular""upper_triangular""upper_triangular""upper_triangular" gewählt, so muss der obere Dreiecksteil der Eingabematrix MatrixMatrixMatrixMatrixMatrixmatrix die relevante Information der Matrix beinhalten. Der exakt untere Teil der Matrix wird nicht verwendet. Wird MatrixTypeMatrixTypeMatrixTypeMatrixTypeMatrixTypematrixType = 'lower_triangular'"lower_triangular""lower_triangular""lower_triangular""lower_triangular""lower_triangular" gewählt, so muss der untere Dreiecksteil der Eingabematrix MatrixMatrixMatrixMatrixMatrixmatrix die relevante Information der Matrix beinhalten. Der exakt obere Teil der Matrix wird nicht verwendet. Wenn der verwendete Teil der Eingabematrix MatrixMatrixMatrixMatrixMatrixmatrix nicht vom spezifizierten Typ ist, wird eine Fehlerbehandlung durchgeführt.

Parallelisierung

Parameter

MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID (input_control)  matrix HMatrix, HTupleHTupleHMatrix, HTupleHMatrixX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Matrix Handle der Eingabematrix.

MatrixTypeMatrixTypeMatrixTypeMatrixTypeMatrixTypematrixType (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Der Matrixtyp der Eingabematrix.

Defaultwert: 'general' "general" "general" "general" "general" "general"

Werteliste: 'general'"general""general""general""general""general", 'lower_triangular'"lower_triangular""lower_triangular""lower_triangular""lower_triangular""lower_triangular", 'permuted_lower_triangular'"permuted_lower_triangular""permuted_lower_triangular""permuted_lower_triangular""permuted_lower_triangular""permuted_lower_triangular", 'permuted_upper_triangular'"permuted_upper_triangular""permuted_upper_triangular""permuted_upper_triangular""permuted_upper_triangular""permuted_upper_triangular", 'positive_definite'"positive_definite""positive_definite""positive_definite""positive_definite""positive_definite", 'symmetric'"symmetric""symmetric""symmetric""symmetric""symmetric", 'upper_triangular'"upper_triangular""upper_triangular""upper_triangular""upper_triangular""upper_triangular"

PowerPowerPowerPowerPowerpower (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

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

MatrixPowIDMatrixPowIDMatrixPowIDMatrixPowIDMatrixPowIDmatrixPowID (output_control)  matrix HMatrix, HTupleHTupleHMatrix, HTupleHMatrixX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Matrix Handle mit der potenzierten Matrix.

Ergebnis

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

pow_matrix_modpow_matrix_modPowMatrixModpow_matrix_modPowMatrixModPowMatrixMod, eigenvalues_symmetric_matrixeigenvalues_symmetric_matrixEigenvaluesSymmetricMatrixeigenvalues_symmetric_matrixEigenvaluesSymmetricMatrixEigenvaluesSymmetricMatrix, eigenvalues_general_matrixeigenvalues_general_matrixEigenvaluesGeneralMatrixeigenvalues_general_matrixEigenvaluesGeneralMatrixEigenvaluesGeneralMatrix

Siehe auch

sqrt_matrixsqrt_matrixSqrtMatrixsqrt_matrixSqrtMatrixSqrtMatrix, sqrt_matrix_modsqrt_matrix_modSqrtMatrixModsqrt_matrix_modSqrtMatrixModSqrtMatrixMod

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren