Name
add_matrix_modadd_matrix_modAddMatrixModadd_matrix_modAddMatrixModAddMatrixMod — Add two matrices.
The operator add_matrix_modadd_matrix_modAddMatrixModadd_matrix_modAddMatrixModAddMatrixMod computes the sum of the input
matrices MatrixAMatrixAMatrixAMatrixAMatrixAmatrixA and MatrixBMatrixBMatrixBMatrixBMatrixBmatrixB given by the matrix
handles MatrixAIDMatrixAIDMatrixAIDMatrixAIDMatrixAIDmatrixAID and MatrixBIDMatrixBIDMatrixBIDMatrixBIDMatrixBIDmatrixBID. Both matrices
must have identical dimensions. The input matrix
MatrixAMatrixAMatrixAMatrixAMatrixAmatrixA is overwritten with the result. Access to the
elements of the matrix is possible e.g. with the operator
get_full_matrixget_full_matrixGetFullMatrixget_full_matrixGetFullMatrixGetFullMatrix. The formula for the calculation of the
result is:
MatrixAMatrixAMatrixAMatrixAMatrixAmatrixA = MatrixAMatrixAMatrixAMatrixAMatrixAmatrixA + MatrixBMatrixBMatrixBMatrixBMatrixBmatrixB.
Example:
/ 3.0 1.0 -2.0 \ / 2.0 8.0 -3.0 \
MatrixA = | -5.0 7.0 2.0 | MatrixB = | -4.0 -1.0 5.0 |
\ -9.0 -4.0 1.0 / \ 2.0 -4.0 7.0 /
/ 5.0 9.0 -5.0 \
-> MatrixA = | -9.0 6.0 7.0 |
\ -7.0 -8.0 8.0 /
add_matrix_modadd_matrix_modAddMatrixModadd_matrix_modAddMatrixModAddMatrixMod modifies the content of an already existing
matrix.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Matrix handle of the input matrix A.
Matrix handle of the input matrix B.
If the parameters are valid, the operator add_matrix_modadd_matrix_modAddMatrixModadd_matrix_modAddMatrixModAddMatrixMod
returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.
create_matrixcreate_matrixCreateMatrixcreate_matrixCreateMatrixCreateMatrix
get_full_matrixget_full_matrixGetFullMatrixget_full_matrixGetFullMatrixGetFullMatrix,
get_value_matrixget_value_matrixGetValueMatrixget_value_matrixGetValueMatrixGetValueMatrix
add_matrixadd_matrixAddMatrixadd_matrixAddMatrixAddMatrix
sub_matrixsub_matrixSubMatrixsub_matrixSubMatrixSubMatrix,
sub_matrix_modsub_matrix_modSubMatrixModsub_matrix_modSubMatrixModSubMatrixMod
Foundation