decompose_matrixT_decompose_matrixDecomposeMatrixDecomposeMatrixdecompose_matrix (Operator)

Name

decompose_matrixT_decompose_matrixDecomposeMatrixDecomposeMatrixdecompose_matrix — Zerlegt eine Matrix.

Signatur

decompose_matrix( : : MatrixID, MatrixType : Matrix1ID, Matrix2ID)

Herror T_decompose_matrix(const Htuple MatrixID, const Htuple MatrixType, Htuple* Matrix1ID, Htuple* Matrix2ID)

void DecomposeMatrix(const HTuple& MatrixID, const HTuple& MatrixType, HTuple* Matrix1ID, HTuple* Matrix2ID)

HMatrix HMatrix::DecomposeMatrix(const HString& MatrixType, HMatrix* Matrix2ID) const

HMatrix HMatrix::DecomposeMatrix(const char* MatrixType, HMatrix* Matrix2ID) const

HMatrix HMatrix::DecomposeMatrix(const wchar_t* MatrixType, HMatrix* Matrix2ID) const   (Nur Windows)

static void HOperatorSet.DecomposeMatrix(HTuple matrixID, HTuple matrixType, out HTuple matrix1ID, out HTuple matrix2ID)

HMatrix HMatrix.DecomposeMatrix(string matrixType, out HMatrix matrix2ID)

def decompose_matrix(matrix_id: HHandle, matrix_type: str) -> Tuple[HHandle, HHandle]

Beschreibung

Der Operator decompose_matrixdecompose_matrixDecomposeMatrixDecomposeMatrixDecomposeMatrixdecompose_matrix zerlegt die quadratische Eingabematrix MatrixMatrixMatrixMatrixmatrixmatrix, die durch das Matrix Handle MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id gegeben ist. Die Ergebnisse werden in zwei generierten Matrizen Matrix1Matrix1Matrix1Matrix1matrix1matrix_1 und Matrix2Matrix2Matrix2Matrix2matrix2matrix_2 gespeichert und deren Matrix Handles Matrix1IDMatrix1IDMatrix1IDMatrix1IDmatrix1IDmatrix_1id und Matrix2IDMatrix2IDMatrix2IDMatrix2IDmatrix2IDmatrix_2id werden zurückgegeben. Zugriff auf die Elemente der Matrizen ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrixget_full_matrix möglich.

Der Typ der Eingabematrix MatrixMatrixMatrixMatrixmatrixmatrix kann über den Parameter MatrixTypeMatrixTypeMatrixTypeMatrixTypematrixTypematrix_type gewählt werden. Die folgenden Werte stehen zur Verfügung: '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 und 'tridiagonal'"tridiagonal""tridiagonal""tridiagonal""tridiagonal""tridiagonal" für tridiagonale Matrizen.

Wenn MatrixTypeMatrixTypeMatrixTypeMatrixTypematrixTypematrix_type = 'general'"general""general""general""general""general" oder 'tridiagonal'"tridiagonal""tridiagonal""tridiagonal""tridiagonal""tridiagonal" gewählt ist, wird eine LU Zerlegung (Lower/Upper) der Form MatrixMatrixMatrixMatrixmatrixmatrix = Matrix1Matrix1Matrix1Matrix1matrix1matrix_1 * Matrix2Matrix2Matrix2Matrix2matrix2matrix_2 vorgenommen. Die Ausgabematrix Matrix1Matrix1Matrix1Matrix1matrix1matrix_1 ist eine untere Dreiecksmatrix mit Einheitsdiagonalelementen, deren Zeilen vertauscht sind. Die Ausgabematrix Matrix2Matrix2Matrix2Matrix2matrix2matrix_2 ist eine obere Dreiecksmatrix.

Ist MatrixTypeMatrixTypeMatrixTypeMatrixTypematrixTypematrix_type = 'symmetric'"symmetric""symmetric""symmetric""symmetric""symmetric" gesetzt, wird eine UDU^T Zerlegung (Upper/Diagonal/Upper) verwendet. Sie hat die Form Hierbei ist die Ausgabematrix Matrix1Matrix1Matrix1Matrix1matrix1matrix_1 eine obere Dreiecksmatrix, deren Zeilen vertauscht sind. Die Ausgabematrix Matrix2Matrix2Matrix2Matrix2matrix2matrix_2 ist eine symmetrische Blockdiagonalmatrix mit 1 x 1 und 2 x 2 Blöcken auf der Hauptdiagonalen.

Eine Cholesky Zerlegung wird berechnet, wenn MatrixTypeMatrixTypeMatrixTypeMatrixTypematrixTypematrix_type = 'positive_definite'"positive_definite""positive_definite""positive_definite""positive_definite""positive_definite" gesetzt ist. Die Zerlegung hat die Form MatrixMatrixMatrixMatrixmatrixmatrix = Matrix1Matrix1Matrix1Matrix1matrix1matrix_1 * Matrix2Matrix2Matrix2Matrix2matrix2matrix_2 wobei die Ausgabematrix Matrix1Matrix1Matrix1Matrix1matrix1matrix_1 eine untere Dreiecksmatrix und Ausgabematrix Matrix2Matrix2Matrix2Matrix2matrix2matrix_2 eine obere Dreiecksmatrix ist. Außerdem ist die Matrix Matrix2Matrix2Matrix2Matrix2matrix2matrix_2 die Transponierte der Matrix Matrix1Matrix1Matrix1Matrix1matrix1matrix_1.

Es ist zu beachten, dass in den Beispielen Unterschiede in der Bedeutung der Werte in den Ausgabematrizen zu finden sind: Wenn ein Wert als ganze Zahl dargestellt ist, z.B. 0 oder 1, ist der Wert dieses Elements per Definition dieser bestimmte Wert. Wenn der Wert als Gleitpunktzahl dargestellt ist, z.B. 0.0 oder 1.0, ist der Wert von dem Operator berechnet worden.

Achtung

Wird MatrixTypeMatrixTypeMatrixTypeMatrixTypematrixTypematrix_type = 'symmetric'"symmetric""symmetric""symmetric""symmetric""symmetric" oder 'positive_definite'"positive_definite""positive_definite""positive_definite""positive_definite""positive_definite" 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 MatrixTypeMatrixTypeMatrixTypeMatrixTypematrixTypematrix_type = 'tridiagonal'"tridiagonal""tridiagonal""tridiagonal""tridiagonal""tridiagonal" gesetzt, wird nur die Hauptdiagonale und die beiden Nebendiagonalen der Eingabematrix MatrixMatrixMatrixMatrixmatrixmatrix genutzt. Die anderen Teile der Matrix werden nicht verwendet. Wenn der verwendete Teil der Eingabematrix MatrixMatrixMatrixMatrixmatrixmatrix nicht vom spezifizierten Typ ist, wird eine Fehlerbehandlung durchgeführt.

Ausführungsinformationen

Parameter

MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (input_control)  matrix HMatrix, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Matrix Handle der Eingabematrix.

MatrixTypeMatrixTypeMatrixTypeMatrixTypematrixTypematrix_type (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Matrixtyp der Eingabematrix.

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

Werteliste: 'general'"general""general""general""general""general", 'positive_definite'"positive_definite""positive_definite""positive_definite""positive_definite""positive_definite", 'symmetric'"symmetric""symmetric""symmetric""symmetric""symmetric", 'tridiagonal'"tridiagonal""tridiagonal""tridiagonal""tridiagonal""tridiagonal"

Matrix1IDMatrix1IDMatrix1IDMatrix1IDmatrix1IDmatrix_1id (output_control)  matrix HMatrix, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Matrix Handle mit der Ausgabematrix 1.

Matrix2IDMatrix2IDMatrix2IDMatrix2IDmatrix2IDmatrix_2id (output_control)  matrix HMatrix, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Matrix Handle mit der Ausgabematrix 2.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert decompose_matrixdecompose_matrixDecomposeMatrixDecomposeMatrixDecomposeMatrixdecompose_matrix den Wert TRUE. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_matrixcreate_matrixCreateMatrixCreateMatrixCreateMatrixcreate_matrix

Nachfolger

get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrixget_full_matrix, get_value_matrixget_value_matrixGetValueMatrixGetValueMatrixGetValueMatrixget_value_matrix

Alternativen

orthogonal_decompose_matrixorthogonal_decompose_matrixOrthogonalDecomposeMatrixOrthogonalDecomposeMatrixOrthogonalDecomposeMatrixorthogonal_decompose_matrix, solve_matrixsolve_matrixSolveMatrixSolveMatrixSolveMatrixsolve_matrix

Literatur

David Poole: „Linear Algebra: A Modern Introduction“; Thomson; Belmont; 2006.
Gene H. Golub, Charles F. van Loan: „Matrix Computations“; The Johns Hopkins University Press; Baltimore and London; 1996.

Modul

Foundation