scale_matrixscale_matrixScaleMatrixscale_matrixScaleMatrixScaleMatrix (Operator)

Name

scale_matrixscale_matrixScaleMatrixscale_matrixScaleMatrixScaleMatrix — Skaliert eine Matrix.

Signatur

scale_matrix( : : MatrixID, Factor : MatrixScaledID)

Der Operator scale_matrixscale_matrixScaleMatrixscale_matrixScaleMatrixScaleMatrix skaliert die Matrix MatrixMatrixMatrixMatrixMatrixmatrix mit einem konstanten Wert. Die Matrix ist durch das Matrix Handle MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID gegeben. Es wird eine neue Matrix MatrixScaledMatrixScaledMatrixScaledMatrixScaledMatrixScaledmatrixScaled mit dem Ergebnis generiert. Der Operator gibt das Matrix Handle MatrixScaledIDMatrixScaledIDMatrixScaledIDMatrixScaledIDMatrixScaledIDmatrixScaledID zurück. Zugriff auf die Elemente der Matrix ist z.B. mit dem Operator get_full_matrixget_full_matrixGetFullMatrixget_full_matrixGetFullMatrixGetFullMatrix möglich. Die Formel für die Berechnung lautet:

Parallelisierung

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

Parameter

MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID (input_control) matrix → (integer)

Matrix Handle der Eingabematrix.

FactorFactorFactorFactorFactorfactor (input_control) number → (real / integer)

Skalierungsfaktor.

Defaultwert: 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

MatrixScaledIDMatrixScaledIDMatrixScaledIDMatrixScaledIDMatrixScaledIDmatrixScaledID (output_control) matrix → (integer)

Matrix Handle mit den skalierten Elementen.

Ergebnis

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

Vorgänger

create_matrixcreate_matrixCreateMatrixcreate_matrixCreateMatrixCreateMatrix

Nachfolger

get_full_matrixget_full_matrixGetFullMatrixget_full_matrixGetFullMatrixGetFullMatrix, get_value_matrixget_value_matrixGetValueMatrixget_value_matrixGetValueMatrixGetValueMatrix

Alternativen

scale_matrix_modscale_matrix_modScaleMatrixModscale_matrix_modScaleMatrixModScaleMatrixMod

Siehe auch

mult_element_matrixmult_element_matrixMultElementMatrixmult_element_matrixMultElementMatrixMultElementMatrix, mult_element_matrix_modmult_element_matrix_modMultElementMatrixModmult_element_matrix_modMultElementMatrixModMultElementMatrixMod, div_element_matrixdiv_element_matrixDivElementMatrixdiv_element_matrixDivElementMatrixDivElementMatrix, div_element_matrix_moddiv_element_matrix_modDivElementMatrixModdiv_element_matrix_modDivElementMatrixModDivElementMatrixMod

Modul

Foundation

Operatoren