max_matrix — Gibt den elementweisen Maximalwert der Matrix zurück.
max_matrix( : : MatrixID, MaxType : MatrixMaxID)
Der Operator max_matrix gibt den Maximalwert der Elemente
der Eingabematrix Matrix zurück. Die Eingabematrix ist
durch das Matrix Handle MatrixID definiert. Es wird eine
neue Matrix MatrixMax mit dem Ergebnis generiert und das
Matrix Handle MatrixMaxID dieser Matrix zurückgegeben.
Zugriff auf die Elemente der Matrix ist z.B. mit dem Operator
get_full_matrix möglich.
Die Art der Maximalwertbildung der Matrix kann mittels des
Parameters MaxType gewählt werden:
Die Maximalwertbildung
erfolgt für jede Spalte der Matrix Matrix einzeln. Die
Ergebnismatrix MatrixMax hat eine Zeile und die gleiche
Anzahl an Spalten wie die Eingabematrix.
Beispiel:
MaxType = 'columns'
Die Maximalwertbildung erfolgt
für jede Zeile der Matrix Matrix einzeln. Die
Ergebnismatrix MatrixMax hat die gleiche Anzahl an
Zeilen wie die Eingabematrix und eine Spalte.
Beispiel:
MaxType = 'rows'
Die Maximalwertbildung erfolgt
über alle Elemente der Matrix Matrix. Die
Ergebnismatrix MatrixMax hat eine Zeile und eine Spalte.
Beispiel:
MaxType = 'full'
MatrixID (input_control) matrix → (handle)
Matrix Handle der Eingabematrix.
MaxType (input_control) string → (string)
Art der Maximalwertbildung.
Defaultwert: 'columns'
Werteliste: 'columns', 'full', 'rows'
MatrixMaxID (output_control) matrix → (handle)
Matrix Handle mit den Maximalwerten der Eingabematrix.
Sind die Parameterwerte korrekt, dann liefert max_matrix den
Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung
durchgeführt.
get_full_matrix,
get_value_matrix
Foundation