pow_element_matrix_modT_pow_element_matrix_modPowElementMatrixModPowElementMatrixModpow_element_matrix_mod (Operator)

Name

pow_element_matrix_modT_pow_element_matrix_modPowElementMatrixModPowElementMatrixModpow_element_matrix_mod — Compute the power functions of the elements of a matrix.

Signature

pow_element_matrix_mod( : : MatrixID, MatrixExpID : )

Description

The operator pow_element_matrix_modpow_element_matrix_modPowElementMatrixModPowElementMatrixModpow_element_matrix_mod computes the power of all elements of the input Matrix with the elements of the input matrix MatrixExp. The input matrices Matrix and MatrixExp are defined by the matrix handles MatrixIDMatrixIDMatrixIDmatrixIDmatrix_id and MatrixExpIDMatrixExpIDMatrixExpIDmatrixExpIDmatrix_exp_id. Both matrices must have identical dimensions. 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_matrixGetFullMatrixGetFullMatrixget_full_matrix. The formula for the calculation of the result is:

Example:

Execution Information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

This operator modifies the state of the following input parameter:

MatrixIDMatrixIDMatrixIDmatrixIDmatrix_id

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

Parameters

MatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (input_control, state is modified) matrix → (handle)

Matrix handle of the input matrix of the base.

MatrixExpIDMatrixExpIDMatrixExpIDmatrixExpIDmatrix_exp_id (input_control) matrix → (handle)

Matrix handle of the input matrix with exponents.

Result

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