scale_matrixT_scale_matrixScaleMatrixScaleMatrixscale_matrix (Operator)

Name

scale_matrixT_scale_matrixScaleMatrixScaleMatrixscale_matrix — Skaliert eine Matrix.

Signatur

scale_matrix( : : MatrixID, Factor : MatrixScaledID)

Beschreibung

Der Operator scale_matrixscale_matrixScaleMatrixScaleMatrixscale_matrix skaliert die Matrix Matrix mit einem konstanten Wert. Die Matrix ist durch das Matrix Handle MatrixIDMatrixIDMatrixIDmatrixIDmatrix_id gegeben. Es wird eine neue Matrix MatrixScaled mit dem Ergebnis generiert. Der Operator gibt das Matrix Handle MatrixScaledIDMatrixScaledIDMatrixScaledIDmatrixScaledIDmatrix_scaled_id zurück. Zugriff auf die Elemente der Matrix ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixget_full_matrix möglich. Die Formel für die Berechnung lautet:

Beispiel:

FactorFactorFactorfactorfactor = 1.5

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

MatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (input_control) matrix → (handle)

Matrix Handle der Eingabematrix.

FactorFactorFactorfactorfactor (input_control) number → (real / integer)

Skalierungsfaktor.

Default: 2.0

Wertevorschläge: 0.1, 0.2, 0.3, 0.5, 0.7, 1.0, 1.5, 2.0, 3.0, 5.0, 10.0

MatrixScaledIDMatrixScaledIDMatrixScaledIDmatrixScaledIDmatrix_scaled_id (output_control) matrix → (handle)

Matrix Handle mit den skalierten Elementen.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert scale_matrixscale_matrixScaleMatrixScaleMatrixscale_matrix den Wert 2 ( H_MSG_TRUE) . Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_matrixcreate_matrixCreateMatrixCreateMatrixcreate_matrix

Nachfolger

get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixget_full_matrix, get_value_matrixget_value_matrixGetValueMatrixGetValueMatrixget_value_matrix

Alternativen

scale_matrix_modscale_matrix_modScaleMatrixModScaleMatrixModscale_matrix_mod

Siehe auch

mult_element_matrixmult_element_matrixMultElementMatrixMultElementMatrixmult_element_matrix, mult_element_matrix_modmult_element_matrix_modMultElementMatrixModMultElementMatrixModmult_element_matrix_mod, div_element_matrixdiv_element_matrixDivElementMatrixDivElementMatrixdiv_element_matrix, div_element_matrix_moddiv_element_matrix_modDivElementMatrixModDivElementMatrixModdiv_element_matrix_mod

Modul

Foundation

Operatoren