scale_matrix_modT_scale_matrix_modScaleMatrixModScaleMatrixMod (Operator)

Name

scale_matrix_modT_scale_matrix_modScaleMatrixModScaleMatrixMod — Scale a matrix.

Signature

scale_matrix_mod( : : MatrixID, Factor : )

Herror T_scale_matrix_mod(const Htuple MatrixID, const Htuple Factor)

void ScaleMatrixMod(const HTuple& MatrixID, const HTuple& Factor)

void HMatrix::ScaleMatrixMod(const HTuple& Factor) const

void HMatrix::ScaleMatrixMod(double Factor) const

static void HOperatorSet.ScaleMatrixMod(HTuple matrixID, HTuple factor)

void HMatrix.ScaleMatrixMod(HTuple factor)

void HMatrix.ScaleMatrixMod(double factor)

Description

The operator scale_matrixscale_matrixScaleMatrixScaleMatrixScaleMatrix scales the MatrixMatrixMatrixMatrixmatrix by a constant factor. The matrix is defined by the matrix handle MatrixIDMatrixIDMatrixIDMatrixIDmatrixID. The input matrix is overwritten with the result. Access to the elements of the matrix is possible e.g. with the operator get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrix. The formula for the calculation of the result is:

Example:

Execution Information

This operator modifies the state of the following input parameter:

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

MatrixIDMatrixIDMatrixIDMatrixIDmatrixID (input_control, state is modified)  matrix HMatrix, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Matrix handle of the input matrix.

FactorFactorFactorFactorfactor (input_control)  number HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Scale factor.

Default value: 2.0

Suggested values: 0.1, 0.2, 0.3, 0.5, 0.7, 1.0, 1.5, 2.0, 3.0, 5.0, 10.0

Result

If the parameters are valid, the operator scale_matrix_modscale_matrix_modScaleMatrixModScaleMatrixModScaleMatrixMod returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

create_matrixcreate_matrixCreateMatrixCreateMatrixCreateMatrix

Possible Successors

get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixGetFullMatrix, get_value_matrixget_value_matrixGetValueMatrixGetValueMatrixGetValueMatrix

Alternatives

scale_matrixscale_matrixScaleMatrixScaleMatrixScaleMatrix

See also

mult_element_matrixmult_element_matrixMultElementMatrixMultElementMatrixMultElementMatrix, mult_element_matrix_modmult_element_matrix_modMultElementMatrixModMultElementMatrixModMultElementMatrixMod, div_element_matrixdiv_element_matrixDivElementMatrixDivElementMatrixDivElementMatrix, div_element_matrix_moddiv_element_matrix_modDivElementMatrixModDivElementMatrixModDivElementMatrixMod

Module

Foundation