Operator Reference

HALCON Operator Reference / Matrix / Arithmetic

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

pow_matrix_modT_pow_matrix_modPowMatrixModPowMatrixModpow_matrix_mod (Operator)

pow_matrix_modT_pow_matrix_modPowMatrixModPowMatrixModpow_matrix_mod — Compute the power functions of a matrix.

Signature

pow_matrix_mod( : : MatrixID, MatrixType, Power : )

Herror T_pow_matrix_mod(const Htuple MatrixID, const Htuple MatrixType, const Htuple Power)

void PowMatrixMod(const HTuple& MatrixID, const HTuple& MatrixType, const HTuple& Power)

void HMatrix::PowMatrixMod(const HString& MatrixType, const HTuple& Power) const

void HMatrix::PowMatrixMod(const HString& MatrixType, double Power) const

void HMatrix::PowMatrixMod(const char* MatrixType, double Power) const

void HMatrix::PowMatrixMod(const wchar_t* MatrixType, double Power) const   ( Windows only)

static void HOperatorSet.PowMatrixMod(HTuple matrixID, HTuple matrixType, HTuple power)

void HMatrix.PowMatrixMod(string matrixType, HTuple power)

void HMatrix.PowMatrixMod(string matrixType, double power)

def pow_matrix_mod(matrix_id: HHandle, matrix_type: str, power: Union[int, float]) -> None

Description

The operator pow_matrix_modpow_matrix_modPowMatrixModPowMatrixModpow_matrix_mod computes the power of the input Matrix by a constant value. The input Matrix is given by the matrix handle MatrixIDMatrixIDMatrixIDmatrixIDmatrix_id. The power value is given by the parameter PowerPowerPowerpowerpower. 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 type of the Matrix can be selected via MatrixTypeMatrixTypeMatrixTypematrixTypematrix_type. The following values are supported: 'general'"general""general""general""general" for general, 'symmetric'"symmetric""symmetric""symmetric""symmetric" for symmetric, 'positive_definite'"positive_definite""positive_definite""positive_definite""positive_definite" for symmetric positive definite, 'upper_triangular'"upper_triangular""upper_triangular""upper_triangular""upper_triangular" for upper triangular, 'permuted_upper_triangular'"permuted_upper_triangular""permuted_upper_triangular""permuted_upper_triangular""permuted_upper_triangular" for permuted upper triangular, 'lower_triangular'"lower_triangular""lower_triangular""lower_triangular""lower_triangular" for lower triangular, and 'permuted_lower_triangular'"permuted_lower_triangular""permuted_lower_triangular""permuted_lower_triangular""permuted_lower_triangular" for permuted lower triangular matrices. The formula for the calculation of the result is:

Example:

PowerPowerPowerpowerpower = [2.0], MatrixTypeMatrixTypeMatrixTypematrixTypematrix_type = 'general'"general""general""general""general"

Attention

For MatrixTypeMatrixTypeMatrixTypematrixTypematrix_type = 'symmetric'"symmetric""symmetric""symmetric""symmetric", 'positive_definite'"positive_definite""positive_definite""positive_definite""positive_definite", or 'upper_triangular'"upper_triangular""upper_triangular""upper_triangular""upper_triangular" the upper triangular part of the input Matrix must contain the relevant information of the matrix. The strictly lower triangular part of the matrix is not referenced. For MatrixTypeMatrixTypeMatrixTypematrixTypematrix_type = 'lower_triangular'"lower_triangular""lower_triangular""lower_triangular""lower_triangular" the lower triangular part of the input Matrix must contain the relevant information of the matrix. The strictly upper triangular part of the matrix is not referenced. If the referenced part of the input Matrix is not of the specified type, an exception is raised.

pow_matrix_modpow_matrix_modPowMatrixModPowMatrixModpow_matrix_mod modifies the content of an already existing matrix.

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 → HMatrix, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Matrix handle of the input matrix.

MatrixTypeMatrixTypeMatrixTypematrixTypematrix_type (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

The type of the input matrix.

Default: 'general' "general" "general" "general" "general"

List of values: 'general'"general""general""general""general", 'lower_triangular'"lower_triangular""lower_triangular""lower_triangular""lower_triangular", 'permuted_lower_triangular'"permuted_lower_triangular""permuted_lower_triangular""permuted_lower_triangular""permuted_lower_triangular", 'permuted_upper_triangular'"permuted_upper_triangular""permuted_upper_triangular""permuted_upper_triangular""permuted_upper_triangular", 'positive_definite'"positive_definite""positive_definite""positive_definite""positive_definite", 'symmetric'"symmetric""symmetric""symmetric""symmetric", 'upper_triangular'"upper_triangular""upper_triangular""upper_triangular""upper_triangular"

PowerPowerPowerpowerpower (input_control)  number → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

The power.

Default: 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 pow_matrix_modpow_matrix_modPowMatrixModPowMatrixModpow_matrix_mod 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_matrixpow_matrixPowMatrixPowMatrixpow_matrix, eigenvalues_symmetric_matrixeigenvalues_symmetric_matrixEigenvaluesSymmetricMatrixEigenvaluesSymmetricMatrixeigenvalues_symmetric_matrix, eigenvalues_general_matrixeigenvalues_general_matrixEigenvaluesGeneralMatrixEigenvaluesGeneralMatrixeigenvalues_general_matrix

See also

sqrt_matrixsqrt_matrixSqrtMatrixSqrtMatrixsqrt_matrix, sqrt_matrix_modsqrt_matrix_modSqrtMatrixModSqrtMatrixModsqrt_matrix_mod

Module

Foundation

---

ClassesClasses | | Operators