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)

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

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

ComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelID (input_control) component_model → (handle)

Handle of the component model.

MinScoreCompMinScoreCompMinScoreCompMinScoreCompminScoreComp (output_control) real(-array) → (real)

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

RootRankingRootRankingRootRankingRootRankingrootRanking (output_control) integer(-array) → (integer)

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

ShapeModelIDsShapeModelIDsShapeModelIDsShapeModelIDsshapeModelIDs (output_control) shape_model(-array) → (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

Module

Matching

Operators