| Operatoren |
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.
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
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
Werte mit denen die Elemente der Matrix initialisiert werden.
Defaultwert: 0
Wertevorschläge: 0, 1, 'identity'
Matrix Handle.
Sind die Parameterwerte korrekt, dann liefert create_matrix den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Foundation
| Operatoren |