HALCON Website / HALCON Operator-Referenz / Matrix / Arithmetik
KlassenKlassen | | Operatoren

pow_matrix_modpow_matrix_modPowMatrixModPowMatrixMod (Operator)

Name

pow_matrix_modpow_matrix_modPowMatrixModPowMatrixMod — Berechnet die Potenz einer Matrix.

Signatur

pow_matrix_mod( : : MatrixID, MatrixType, Power : )

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

Herror T_pow_matrix_mod(const Htuple MatrixID, const Htuple MatrixType, const Htuple Power)

void PowMatrixMod(const HTuple& MatrixID, const HTuple& MatrixType, const HTuple& Power)

void HMatrix::PowMatrixMod(const HString& MatrixType, const HTuple& Power) const

void HMatrix::PowMatrixMod(const HString& MatrixType, double Power) const

void HMatrix::PowMatrixMod(const char* MatrixType, double Power) const

static void HOperatorSet.PowMatrixMod(HTuple matrixID, HTuple matrixType, HTuple power)

void HMatrix.PowMatrixMod(string matrixType, HTuple power)

void HMatrix.PowMatrixMod(string matrixType, double power)

Beschreibung

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

Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:

Der Wert dieses Parameters darf nicht über mehrere Threads verwendet werden.

Parameter

MatrixIDMatrixIDMatrixIDMatrixIDmatrixID (input_control, Zustand wird modifiziert)  matrix → HMatrix, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Matrix Handle der Eingabematrix.

MatrixTypeMatrixTypeMatrixTypeMatrixTypematrixType (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Der Matrixtyp der Eingabematrix.

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

Werteliste: 'general'"general""general""general""general", '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_upper_triangular'"permuted_upper_triangular""permuted_upper_triangular""permuted_upper_triangular""permuted_upper_triangular", 'positive_definite'"positive_definite""positive_definite""positive_definite""positive_definite", 'symmetric'"symmetric""symmetric""symmetric""symmetric", 'upper_triangular'"upper_triangular""upper_triangular""upper_triangular""upper_triangular"

PowerPowerPowerPowerpower (input_control)  number → HTupleHTupleHtuple (real / integer) (double / int / long) (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

Ergebnis

Sind die Parameterwerte korrekt, dann liefert pow_matrix_modpow_matrix_modPowMatrixModPowMatrixModPowMatrixMod 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_matrixpow_matrixPowMatrixPowMatrixPowMatrix, eigenvalues_symmetric_matrixeigenvalues_symmetric_matrixEigenvaluesSymmetricMatrixEigenvaluesSymmetricMatrixEigenvaluesSymmetricMatrix, eigenvalues_general_matrixeigenvalues_general_matrixEigenvaluesGeneralMatrixEigenvaluesGeneralMatrixEigenvaluesGeneralMatrix

Siehe auch

sqrt_matrixsqrt_matrixSqrtMatrixSqrtMatrixSqrtMatrix, sqrt_matrix_modsqrt_matrix_modSqrtMatrixModSqrtMatrixModSqrtMatrixMod

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 17.12 Copyright © 1996-2017 MVTec Software GmbH