get_component_model_paramsT_get_component_model_paramsGetComponentModelParamsGetComponentModelParams (Operator)

Name

get_component_model_paramsT_get_component_model_paramsGetComponentModelParamsGetComponentModelParams — Return the parameters of a component model.

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)

Description

The operator get_component_model_paramsget_component_model_paramsGetComponentModelParamsGetComponentModelParamsGetComponentModelParams returns the parameters of the component model ComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelID. In particular, this output can be used to check the parameters RootRankingRootRankingRootRankingRootRankingrootRanking and MinScoreCompMinScoreCompMinScoreCompMinScoreCompminScoreComp after reading the component model with read_component_modelread_component_modelReadComponentModelReadComponentModelReadComponentModel. Additionally, the operator returns the shape model IDs ShapeModelIDsShapeModelIDsShapeModelIDsShapeModelIDsshapeModelIDs of the model components. The order of the returned shape model IDs corresponds to the indices of the components within the component model ComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelID. The IDs can be used to query their shape model parameters with get_shape_model_paramsget_shape_model_paramsGetShapeModelParamsGetShapeModelParamsGetShapeModelParams.

Execution Information

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

ComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelID (input_control)  component_model HComponentModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the component model.

MinScoreCompMinScoreCompMinScoreCompMinScoreCompminScoreComp (output_control)  real(-array) HTupleHTupleHtuple (real) (double) (double) (double)

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

RootRankingRootRankingRootRankingRootRankingrootRanking (output_control)  integer(-array) HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

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

ShapeModelIDsShapeModelIDsShapeModelIDsShapeModelIDsshapeModelIDs (output_control)  shape_model(-array) HShapeModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handles of the shape models of the individual model components.

Example (HDevelop)

read_component_model ('pliers.cpm', ComponentModelID)
get_component_model_params (ComponentModelID, MinScoreComp, RootRanking, \
                            ShapeModelIDs)
for i := 0 to |ShapeModelIDs|-1 by 1
    get_shape_model_params (ShapeModelIDs[i], NumLevels, AngleStart, \
                            AngleExtent, AngleStep, ScaleMin, ScaleMax, \
                            ScaleStep, Metric, MinContrast)
endfor

Result

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

Possible Predecessors

create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModelCreateTrainedComponentModel, create_component_modelcreate_component_modelCreateComponentModelCreateComponentModelCreateComponentModel

See also

get_shape_model_paramsget_shape_model_paramsGetShapeModelParamsGetShapeModelParamsGetShapeModelParams

Module

Matching