set_diagonal_matrix — Setzt die Diagonalelemente einer Matrix.
Der Operator set_diagonal_matrix
überschreibt die Diagonalelemente der Matrix Matrix
mit den Elementen der Matrix Vector. Die Matrizen sind
durch ihre Matrix Handles MatrixID und VectorID
gegeben. Die Matrix Vector muss eine Spalte und eine
Zeile, n Spalten und eine Zeile oder eine Spalte und n Zeilen
haben. n ist die Anzahl der Elemente, die in der Matrix
Matrix gesetzt werden (siehe unten). Wenn die Matrix
Vector eine Spalte und eine Zeile hat, d.h. die Matrix
nur einen Wert hat, so wird jedes Diagonalelement der Matrix
Matrix mit diesem Wert überschrieben. Andernfalls wird die
Diagonale mit den Elementen der Matrix Vector
überschrieben.
Wenn Diagonal = 0, wird die Hauptdiagonale der Matrix
Matrix überschrieben. Die Anzahl n = min(Anzahl der
Zeilen der Matrix Matrix, Anzahl der Spalten der Matrix
Matrix).
Die obere Diagonal-te Nebendiagonale der Matrix
wird überschrieben, wenn Diagonal eine positive Zahl
beinhaltet. Für das Beispiel 1 ist die Anzahl n = min(Anzahl der
Zeilen der Matrix Matrix, Parameter Diagonal).
Für das Beispiel 2 ist die Anzahl n = min(Anzahl der Zeilen der
Matrix Matrix, Anzahl der Spalten der Matrix
Matrix).
Die untere Diagonal-te Nebendiagonale der Matrix
wird überschrieben, wenn Diagonal eine negative Zahl
beinhaltet. Für das Beispiel 1 ist die Anzahl n = min(Anzahl der
Spalten der Matrix Matrix, Parameter Diagonal).
Für das Beispiel 2 ist die Anzahl n = min(Anzahl der Zeilen der
Matrix Matrix, Anzahl der Spalten der Matrix
Matrix).
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.
MatrixID (input_control, Zustand wird modifiziert) matrix → (handle)
Matrix Handle der Eingabematrix.
VectorID (input_control) matrix → (handle)
Matrix Handle, welches die Diagonalelemente enthält, die gesetzt werden sollen.
Diagonal (input_control) integer → (integer)
Position der Diagonale.
Defaultwert: 0
Wertevorschläge: -20, -10, -5, -4, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20
Sind die Parameterwerte korrekt, dann liefert
set_diagonal_matrix den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
get_full_matrix,
get_value_matrix
Foundation