Operator Reference

pow_element_matrixT_pow_element_matrixPowElementMatrixPowElementMatrixpow_element_matrix (Operator)

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

Signature

pow_element_matrix( : : MatrixID, MatrixExpID : MatrixPowID)

Herror T_pow_element_matrix(const Htuple MatrixID, const Htuple MatrixExpID, Htuple* MatrixPowID)

void PowElementMatrix(const HTuple& MatrixID, const HTuple& MatrixExpID, HTuple* MatrixPowID)

HMatrix HMatrix::PowElementMatrix(const HMatrix& MatrixExpID) const

static void HOperatorSet.PowElementMatrix(HTuple matrixID, HTuple matrixExpID, out HTuple matrixPowID)

HMatrix HMatrix.PowElementMatrix(HMatrix matrixExpID)

def pow_element_matrix(matrix_id: HHandle, matrix_exp_id: HHandle) -> HHandle

Description

The operator pow_element_matrixpow_element_matrixPowElementMatrixPowElementMatrixpow_element_matrix 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. A new matrix MatrixPow is generated with the result. The operator returns the matrix handle MatrixPowIDMatrixPowIDMatrixPowIDmatrixPowIDmatrix_pow_id of the matrix MatrixPow. 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.

Parameters

MatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (input_control)  matrix HMatrix, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Matrix handle of the input matrix of the base.

MatrixExpIDMatrixExpIDMatrixExpIDmatrixExpIDmatrix_exp_id (input_control)  matrix HMatrix, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Matrix handle of the input matrix with exponents.

MatrixPowIDMatrixPowIDMatrixPowIDmatrixPowIDmatrix_pow_id (output_control)  matrix HMatrix, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Matrix handle with the raised power of the input matrix.

Result

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

Possible Predecessors

create_matrixcreate_matrixCreateMatrixCreateMatrixcreate_matrix

Possible Successors

get_full_matrixget_full_matrixGetFullMatrixGetFullMatrixget_full_matrix, get_value_matrixget_value_matrixGetValueMatrixGetValueMatrixget_value_matrix

Alternatives

pow_element_matrix_modpow_element_matrix_modPowElementMatrixModPowElementMatrixModpow_element_matrix_mod, pow_scalar_element_matrixpow_scalar_element_matrixPowScalarElementMatrixPowScalarElementMatrixpow_scalar_element_matrix, pow_scalar_element_matrix_modpow_scalar_element_matrix_modPowScalarElementMatrixModPowScalarElementMatrixModpow_scalar_element_matrix_mod

See also

sqrt_matrixsqrt_matrixSqrtMatrixSqrtMatrixsqrt_matrix, sqrt_matrix_modsqrt_matrix_modSqrtMatrixModSqrtMatrixModsqrt_matrix_mod

Module

Foundation