create_matrix — Legt eine Matrix an.
Der Operator create_matrix legt eine neue Matrix
Matrix mit Rows Zeilen und Columns
Spalten an und gibt das Matrix Handle MatrixID zurück.
Zugriff auf die Elemente der Matrix ist z.B. mit dem Operator
get_full_matrix möglich. Der Parameter Value
ist ein String oder ein Tupel von Gleitpunkt- oder ganzen Zahlen.
Ganze Zahlen werden automatisch in Gleitpunktzahlen konvertiert.
Wenn Value den Wert 'identity' enthält, muss
Rows und Columns gleich sein und eine
Einheitsmatrix wird generiert.
Beispiel: Rows = 3 Columns = 3 Value = 'identity'
Wenn der Parameter Value einen einzelnen Wert beinhaltet,
werden alle Elemente der Matrix auf diesen Wert gesetzt.
Beispiel: Rows = 3 Columns = 3 Value = 7
Wenn Value aus so vielen Werten wie die Hauptdiagonale
besteht, werden alle Hauptdiagonalelemente mit den Werten des
Parameters Value besetzt (d.h., die Anzahl der Elemente in
Value ist identisch).
Beispiel: Rows = 3 Columns = 4 Value = [3, 7, 1]
Ebenfalls ist es möglich, alle Elemente mit unterschiedlichen Werten
zu besetzen. In diesem Fall müssen in dem Parameter Value
alle Werte zeilenweise vorliegen, d.h. Zeile für Zeile gespeichert
sein. Außerdem muss die Anzahl der in Value übergebenen
Werte mit der Anzahl aller Elemente der Matrix, d.h. Rows
* Columns, identisch sein.
Beispiel: Rows = 3 Columns = 3 Value = [3,1,-2,-5,7,2,-9,-4,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.
Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.
Rows (input_control) integer → (integer)
Anzahl der Zeilen der Matrix.
Defaultwert: 3
Wertevorschläge: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100
Restriktion: Rows >= 1
Columns (input_control) integer → (integer)
Anzahl der Spalten der Matrix.
Defaultwert: 3
Wertevorschläge: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100
Restriktion: Columns >= 1
Value (input_control) number(-array) → (real / integer / string)
Werte mit denen die Elemente der Matrix initialisiert werden.
Defaultwert: 0
Wertevorschläge: 0, 1, 'identity'
MatrixID (output_control) matrix → (handle)
Matrix Handle.
Sind die Parameterwerte korrekt, dann liefert create_matrix
den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung
durchgeführt.
Foundation