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:

  MatrixScaled   = Factor  * Matrix  .
              ij                   ij

Beispiel:

           /   3.0   1.0  -2.0  \
  Matrix = |  -2.0   6.0   2.0  |      Factor = 1.5
           \  -5.0  -4.0   1.0  /

                      /   4.5   1.5  -3.0  \
  ->   MatrixScaled = |  -3.0   9.0   3.0  |
                      \  -7.5  -6.0   1.5  /

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