get_diagonal_matrixT_get_diagonal_matrixGetDiagonalMatrixGetDiagonalMatrixget_diagonal_matrix (Operator)

Name

get_diagonal_matrixT_get_diagonal_matrixGetDiagonalMatrixGetDiagonalMatrixget_diagonal_matrix — Gibt die Diagonalelemente einer Matrix zurück.

Signatur

get_diagonal_matrix( : : MatrixID, Diagonal : VectorID)

Beschreibung

Der Operator get_diagonal_matrixget_diagonal_matrixGetDiagonalMatrixGetDiagonalMatrixGetDiagonalMatrixget_diagonal_matrix generiert eine neue Matrix Vector und kopiert die Diagonalelemente der Matrix Matrix in diese neue Matrix. Gegeben ist die Matrix Matrix durch das Matrix Handle MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id. Die Matrix Vector hat eine Spalte und n Zeilen mit n = Anzahl der Diagonalelemente. Der Operator gibt das Matrix Handle VectorIDVectorIDVectorIDVectorIDvectorIDvector_id der Matrix Vector zurück. Zugriff auf die Elemente der Matrix ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrixget_full_matrix möglich.

Wenn DiagonalDiagonalDiagonalDiagonaldiagonaldiagonal = 0, wird in den Vector die Hauptdiagonale der Matrix kopiert.

Beispiel:

DiagonalDiagonalDiagonalDiagonaldiagonaldiagonal = 0

Die obere DiagonalDiagonalDiagonalDiagonaldiagonaldiagonal-te Nebendiagonale der Eingabematrix Matrix wird kopiert, wenn DiagonalDiagonalDiagonalDiagonaldiagonaldiagonal eine positive Zahl ist.

Beispiel:

DiagonalDiagonalDiagonalDiagonaldiagonaldiagonal = 2

Die untere DiagonalDiagonalDiagonalDiagonaldiagonaldiagonal-te Nebendiagonale der Eingabematrix Matrix wird kopiert, wenn DiagonalDiagonalDiagonalDiagonaldiagonaldiagonal eine negative Zahl ist.

Beispiel:

DiagonalDiagonalDiagonalDiagonaldiagonaldiagonal = -1

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

MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (input_control) matrix → (handle)

Matrix Handle der Eingabematrix.

DiagonalDiagonalDiagonalDiagonaldiagonaldiagonal (input_control) integer → (integer)

Nummer der gewünschten Diagonale.

Defaultwert: 0

Wertevorschläge: -20, -10, -5, -4, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20

VectorIDVectorIDVectorIDVectorIDvectorIDvector_id (output_control) matrix → (handle)

Matrix Handle mit den Diagonalelementen.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert get_diagonal_matrixget_diagonal_matrixGetDiagonalMatrixGetDiagonalMatrixGetDiagonalMatrixget_diagonal_matrix den Wert 2 (H_MSG_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

Siehe auch

set_diagonal_matrixset_diagonal_matrixSetDiagonalMatrixSetDiagonalMatrixSetDiagonalMatrixset_diagonal_matrix

Modul

Foundation

Operatoren