HALCON 20.11.0.0 / HALCON Operator Reference / Matrix / Access
ClassesClasses | | Operators

get_value_matrixT_get_value_matrixGetValueMatrixGetValueMatrixget_value_matrix (Operator)

Name

get_value_matrixT_get_value_matrixGetValueMatrixGetValueMatrixget_value_matrix — Return one ore more elements of a matrix.

Signature

get_value_matrix( : : MatrixID, Row, Column : Value)

Herror T_get_value_matrix(const Htuple MatrixID, const Htuple Row, const Htuple Column, Htuple* Value)

void GetValueMatrix(const HTuple& MatrixID, const HTuple& Row, const HTuple& Column, HTuple* Value)

HTuple HMatrix::GetValueMatrix(const HTuple& Row, const HTuple& Column) const

double HMatrix::GetValueMatrix(Hlong Row, Hlong Column) const

static void HOperatorSet.GetValueMatrix(HTuple matrixID, HTuple row, HTuple column, out HTuple value)

HTuple HMatrix.GetValueMatrix(HTuple row, HTuple column)

double HMatrix.GetValueMatrix(int row, int column)

def get_value_matrix(matrix_id: HHandle, row: MaybeSequence[int], column: MaybeSequence[int]) -> Sequence[float]

def get_value_matrix_s(matrix_id: HHandle, row: MaybeSequence[int], column: MaybeSequence[int]) -> float

Description

The operator get_value_matrixget_value_matrixGetValueMatrixGetValueMatrixGetValueMatrixget_value_matrix returns the values of one ore more elements of the MatrixMatrixMatrixMatrixmatrixmatrix as a tuple of floating point numbers. The MatrixMatrixMatrixMatrixmatrixmatrix is given by the matrix handle MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id. The row coordinates of the elements of the MatrixMatrixMatrixMatrixmatrixmatrix are determined by the tuple RowRowRowRowrowrow, the column coordinates by the tuple ColumnColumnColumnColumncolumncolumn.

Example:

Execution Information

Parameters

MatrixIDMatrixIDMatrixIDMatrixIDmatrixIDmatrix_id (input_control)  matrix → HMatrix, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Matrix handle of the input matrix.

RowRowRowRowrowrow (input_control)  integer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Row numbers of matrix elements to be returned.

Default value: 0

Suggested values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100

Restriction: Row >= 0

ColumnColumnColumnColumncolumncolumn (input_control)  integer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column numbers of matrix elements to be returned.

Default value: 0

Suggested values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 50, 100

Restriction: Column >= 0

ValueValueValueValuevaluevalue (output_control)  real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Values of indicated matrix elements.

Result

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

Possible Predecessors

create_matrixcreate_matrixCreateMatrixCreateMatrixCreateMatrixcreate_matrix

Possible Successors

clear_matrixclear_matrixClearMatrixClearMatrixClearMatrixclear_matrix

See also

set_value_matrixset_value_matrixSetValueMatrixSetValueMatrixSetValueMatrixset_value_matrix

Module

Foundation

ClassesClasses | | Operators
HALCON Operator Reference 20.11.0.0 Copyright © 1996-2020 MVTec Software GmbH