get_diagonal_matrix — Gibt die Diagonalelemente einer Matrix zurück.
Der Operator get_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 MatrixID. Die
Matrix Vector hat eine Spalte und n Zeilen mit n =
Anzahl der Diagonalelemente. Der Operator gibt das Matrix Handle
VectorID der Matrix Vector zurück. Zugriff auf
die Elemente der Matrix ist z.B. mit dem Operator
get_full_matrix möglich.
Wenn Diagonal = 0, wird in den Vector die
Hauptdiagonale der Matrix kopiert.
Beispiel:
Diagonal = 0
Die obere Diagonal-te Nebendiagonale der Eingabematrix
Matrix wird kopiert, wenn Diagonal eine positive
Zahl ist.
Beispiel:
Diagonal = 2
Die untere Diagonal-te Nebendiagonale der Eingabematrix
Matrix wird kopiert, wenn Diagonal eine negative
Zahl ist.
Beispiel:
Diagonal = -1
MatrixID (input_control) matrix → (handle)
Matrix Handle der Eingabematrix.
Diagonal (input_control) integer → (integer)
Nummer der gewünschten Diagonale.
Default: 0
Wertevorschläge: -20, -10, -5, -4, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20
VectorID (output_control) matrix → (handle)
Matrix Handle mit den Diagonalelementen.
Sind die Parameterwerte korrekt, dann liefert
get_diagonal_matrix den Wert 2 (
H_MSG_TRUE)
. Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
get_full_matrix,
get_value_matrix
Foundation