Operator Reference

HALCON Operator Reference / Legacy / Matching, Component-Based
ClassesClasses | | Operators

get_component_model_paramsT_get_component_model_paramsGetComponentModelParamsGetComponentModelParamsget_component_model_params (Operator)

get_component_model_paramsT_get_component_model_paramsGetComponentModelParamsGetComponentModelParamsget_component_model_params — Return the parameters of a component model.

Warning

get_component_model_paramsget_component_model_paramsGetComponentModelParamsGetComponentModelParamsget_component_model_params is obsolete and is only provided for reasons of backward compatibility. The operator will be removed with HALCON 26.11.

Signature

get_component_model_params( : : ComponentModelID : MinScoreComp, RootRanking, ShapeModelIDs)

Herror T_get_component_model_params(const Htuple ComponentModelID, Htuple* MinScoreComp, Htuple* RootRanking, Htuple* ShapeModelIDs)

void GetComponentModelParams(const HTuple& ComponentModelID, HTuple* MinScoreComp, HTuple* RootRanking, HTuple* ShapeModelIDs)

HTuple HComponentModel::GetComponentModelParams(HTuple* RootRanking, HShapeModelArray* ShapeModelIDs) const

double HComponentModel::GetComponentModelParams(Hlong* RootRanking, HShapeModel* ShapeModelIDs) const

static void HOperatorSet.GetComponentModelParams(HTuple componentModelID, out HTuple minScoreComp, out HTuple rootRanking, out HTuple shapeModelIDs)

HTuple HComponentModel.GetComponentModelParams(out HTuple rootRanking, out HShapeModel[] shapeModelIDs)

double HComponentModel.GetComponentModelParams(out int rootRanking, out HShapeModel shapeModelIDs)

def get_component_model_params(component_model_id: HHandle) -> Tuple[Sequence[float], Sequence[int], Sequence[HHandle]]

def get_component_model_params_s(component_model_id: HHandle) -> Tuple[float, int, HHandle]

Description

The operator get_component_model_paramsget_component_model_paramsGetComponentModelParamsGetComponentModelParamsget_component_model_params returns the parameters of the component model ComponentModelIDComponentModelIDComponentModelIDcomponentModelIDcomponent_model_id. In particular, this output can be used to check the parameters RootRankingRootRankingRootRankingrootRankingroot_ranking and MinScoreCompMinScoreCompMinScoreCompminScoreCompmin_score_comp after reading the component model with read_component_modelread_component_modelReadComponentModelReadComponentModelread_component_model. Additionally, the operator returns the shape model IDs ShapeModelIDsShapeModelIDsShapeModelIDsshapeModelIDsshape_model_ids of the model components. The order of the returned shape model IDs corresponds to the indices of the components within the component model ComponentModelIDComponentModelIDComponentModelIDcomponentModelIDcomponent_model_id. The IDs can be used to query their shape model parameters with get_shape_model_paramsget_shape_model_paramsGetShapeModelParamsGetShapeModelParamsget_shape_model_params.

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 returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

Parameters

ComponentModelIDComponentModelIDComponentModelIDcomponentModelIDcomponent_model_id (input_control)  component_model → HComponentModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the component model.

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

Minimum score of the instances of the components to be found.

RootRankingRootRankingRootRankingrootRankingroot_ranking (output_control)  integer(-array) → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Ranking of the model components expressing their suitability to act as root component.

ShapeModelIDsShapeModelIDsShapeModelIDsshapeModelIDsshape_model_ids (output_control)  shape_model(-array) → HShapeModel, HTupleSequence[HHandle]HTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handles of the shape models of the individual model components.

Result

If the handle of the component model is valid, the operator get_component_model_paramsget_component_model_paramsGetComponentModelParamsGetComponentModelParamsget_component_model_params returns the value 2 ( H_MSG_TRUE) . If necessary, an exception is raised.

Module

Matching

ClassesClasses | | Operators