scale_matrix_modscale_matrix_modScaleMatrixModscale_matrix_modScaleMatrixModScaleMatrixMod (Operator)

Name

scale_matrix_modscale_matrix_modScaleMatrixModscale_matrix_modScaleMatrixModScaleMatrixMod — Skaliert eine Matrix.

Signatur

scale_matrix_mod( : : MatrixID, Factor : )

Der Operator scale_matrix_modscale_matrix_modScaleMatrixModscale_matrix_modScaleMatrixModScaleMatrixMod skaliert die Matrix MatrixMatrixMatrixMatrixMatrixmatrix mit einem konstanten Wert. Die Matrix ist durch das Matrix Handle MatrixIDMatrixIDMatrixIDMatrixIDMatrixIDmatrixID gegeben. Die Eingabematrix wird mit dem Ergebnis überschrieben. 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:

  Matrix   = 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  \
  ->   Matrix = |  -3.0   9.0   3.0  |
                \  -7.5  -6.0   1.5  /

Achtung

scale_matrix_modscale_matrix_modScaleMatrixModscale_matrix_modScaleMatrixModScaleMatrixMod verändert den Inhalt einer bereits bestehenden Matrix.

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

Ergebnis

Sind die Parameterwerte korrekt, dann liefert scale_matrix_modscale_matrix_modScaleMatrixModscale_matrix_modScaleMatrixModScaleMatrixMod 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_matrixscale_matrixScaleMatrixscale_matrixScaleMatrixScaleMatrix

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