create_component_modelT_create_component_modelCreateComponentModelCreateComponentModel (Operator)

Name

create_component_modelT_create_component_modelCreateComponentModelCreateComponentModel — Prepare a component model for matching based on explicitly specified components and relations.

Signature

create_component_model(ModelImage, ComponentRegions : : VariationRow, VariationColumn, VariationAngle, AngleStart, AngleExtent, ContrastLowComp, ContrastHighComp, MinSizeComp, MinContrastComp, MinScoreComp, NumLevelsComp, AngleStepComp, OptimizationComp, MetricComp, PregenerationComp : ComponentModelID, RootRanking)

Herror T_create_component_model(const Hobject ModelImage, const Hobject ComponentRegions, const Htuple VariationRow, const Htuple VariationColumn, const Htuple VariationAngle, const Htuple AngleStart, const Htuple AngleExtent, const Htuple ContrastLowComp, const Htuple ContrastHighComp, const Htuple MinSizeComp, const Htuple MinContrastComp, const Htuple MinScoreComp, const Htuple NumLevelsComp, const Htuple AngleStepComp, const Htuple OptimizationComp, const Htuple MetricComp, const Htuple PregenerationComp, Htuple* ComponentModelID, Htuple* RootRanking)

void CreateComponentModel(const HObject& ModelImage, const HObject& ComponentRegions, const HTuple& VariationRow, const HTuple& VariationColumn, const HTuple& VariationAngle, const HTuple& AngleStart, const HTuple& AngleExtent, const HTuple& ContrastLowComp, const HTuple& ContrastHighComp, const HTuple& MinSizeComp, const HTuple& MinContrastComp, const HTuple& MinScoreComp, const HTuple& NumLevelsComp, const HTuple& AngleStepComp, const HTuple& OptimizationComp, const HTuple& MetricComp, const HTuple& PregenerationComp, HTuple* ComponentModelID, HTuple* RootRanking)

void HComponentModel::HComponentModel(const HImage& ModelImage, const HRegion& ComponentRegions, const HTuple& VariationRow, const HTuple& VariationColumn, const HTuple& VariationAngle, double AngleStart, double AngleExtent, const HTuple& ContrastLowComp, const HTuple& ContrastHighComp, const HTuple& MinSizeComp, const HTuple& MinContrastComp, const HTuple& MinScoreComp, const HTuple& NumLevelsComp, const HTuple& AngleStepComp, const HString& OptimizationComp, const HTuple& MetricComp, const HTuple& PregenerationComp, HTuple* RootRanking)

void HComponentModel::HComponentModel(const HImage& ModelImage, const HRegion& ComponentRegions, Hlong VariationRow, Hlong VariationColumn, double VariationAngle, double AngleStart, double AngleExtent, Hlong ContrastLowComp, Hlong ContrastHighComp, Hlong MinSizeComp, Hlong MinContrastComp, double MinScoreComp, Hlong NumLevelsComp, double AngleStepComp, const HString& OptimizationComp, const HString& MetricComp, const HString& PregenerationComp, Hlong* RootRanking)

void HComponentModel::HComponentModel(const HImage& ModelImage, const HRegion& ComponentRegions, Hlong VariationRow, Hlong VariationColumn, double VariationAngle, double AngleStart, double AngleExtent, Hlong ContrastLowComp, Hlong ContrastHighComp, Hlong MinSizeComp, Hlong MinContrastComp, double MinScoreComp, Hlong NumLevelsComp, double AngleStepComp, const char* OptimizationComp, const char* MetricComp, const char* PregenerationComp, Hlong* RootRanking)

void HComponentModel::HComponentModel(const HImage& ModelImage, const HRegion& ComponentRegions, Hlong VariationRow, Hlong VariationColumn, double VariationAngle, double AngleStart, double AngleExtent, Hlong ContrastLowComp, Hlong ContrastHighComp, Hlong MinSizeComp, Hlong MinContrastComp, double MinScoreComp, Hlong NumLevelsComp, double AngleStepComp, const wchar_t* OptimizationComp, const wchar_t* MetricComp, const wchar_t* PregenerationComp, Hlong* RootRanking)   (Windows only)

HTuple HComponentModel::CreateComponentModel(const HImage& ModelImage, const HRegion& ComponentRegions, const HTuple& VariationRow, const HTuple& VariationColumn, const HTuple& VariationAngle, double AngleStart, double AngleExtent, const HTuple& ContrastLowComp, const HTuple& ContrastHighComp, const HTuple& MinSizeComp, const HTuple& MinContrastComp, const HTuple& MinScoreComp, const HTuple& NumLevelsComp, const HTuple& AngleStepComp, const HString& OptimizationComp, const HTuple& MetricComp, const HTuple& PregenerationComp)

Hlong HComponentModel::CreateComponentModel(const HImage& ModelImage, const HRegion& ComponentRegions, Hlong VariationRow, Hlong VariationColumn, double VariationAngle, double AngleStart, double AngleExtent, Hlong ContrastLowComp, Hlong ContrastHighComp, Hlong MinSizeComp, Hlong MinContrastComp, double MinScoreComp, Hlong NumLevelsComp, double AngleStepComp, const HString& OptimizationComp, const HString& MetricComp, const HString& PregenerationComp)

Hlong HComponentModel::CreateComponentModel(const HImage& ModelImage, const HRegion& ComponentRegions, Hlong VariationRow, Hlong VariationColumn, double VariationAngle, double AngleStart, double AngleExtent, Hlong ContrastLowComp, Hlong ContrastHighComp, Hlong MinSizeComp, Hlong MinContrastComp, double MinScoreComp, Hlong NumLevelsComp, double AngleStepComp, const char* OptimizationComp, const char* MetricComp, const char* PregenerationComp)

Hlong HComponentModel::CreateComponentModel(const HImage& ModelImage, const HRegion& ComponentRegions, Hlong VariationRow, Hlong VariationColumn, double VariationAngle, double AngleStart, double AngleExtent, Hlong ContrastLowComp, Hlong ContrastHighComp, Hlong MinSizeComp, Hlong MinContrastComp, double MinScoreComp, Hlong NumLevelsComp, double AngleStepComp, const wchar_t* OptimizationComp, const wchar_t* MetricComp, const wchar_t* PregenerationComp)   (Windows only)

HComponentModel HImage::CreateComponentModel(const HRegion& ComponentRegions, const HTuple& VariationRow, const HTuple& VariationColumn, const HTuple& VariationAngle, double AngleStart, double AngleExtent, const HTuple& ContrastLowComp, const HTuple& ContrastHighComp, const HTuple& MinSizeComp, const HTuple& MinContrastComp, const HTuple& MinScoreComp, const HTuple& NumLevelsComp, const HTuple& AngleStepComp, const HString& OptimizationComp, const HTuple& MetricComp, const HTuple& PregenerationComp, HTuple* RootRanking) const

HComponentModel HImage::CreateComponentModel(const HRegion& ComponentRegions, Hlong VariationRow, Hlong VariationColumn, double VariationAngle, double AngleStart, double AngleExtent, Hlong ContrastLowComp, Hlong ContrastHighComp, Hlong MinSizeComp, Hlong MinContrastComp, double MinScoreComp, Hlong NumLevelsComp, double AngleStepComp, const HString& OptimizationComp, const HString& MetricComp, const HString& PregenerationComp, Hlong* RootRanking) const

HComponentModel HImage::CreateComponentModel(const HRegion& ComponentRegions, Hlong VariationRow, Hlong VariationColumn, double VariationAngle, double AngleStart, double AngleExtent, Hlong ContrastLowComp, Hlong ContrastHighComp, Hlong MinSizeComp, Hlong MinContrastComp, double MinScoreComp, Hlong NumLevelsComp, double AngleStepComp, const char* OptimizationComp, const char* MetricComp, const char* PregenerationComp, Hlong* RootRanking) const

HComponentModel HImage::CreateComponentModel(const HRegion& ComponentRegions, Hlong VariationRow, Hlong VariationColumn, double VariationAngle, double AngleStart, double AngleExtent, Hlong ContrastLowComp, Hlong ContrastHighComp, Hlong MinSizeComp, Hlong MinContrastComp, double MinScoreComp, Hlong NumLevelsComp, double AngleStepComp, const wchar_t* OptimizationComp, const wchar_t* MetricComp, const wchar_t* PregenerationComp, Hlong* RootRanking) const   (Windows only)

static void HOperatorSet.CreateComponentModel(HObject modelImage, HObject componentRegions, HTuple variationRow, HTuple variationColumn, HTuple variationAngle, HTuple angleStart, HTuple angleExtent, HTuple contrastLowComp, HTuple contrastHighComp, HTuple minSizeComp, HTuple minContrastComp, HTuple minScoreComp, HTuple numLevelsComp, HTuple angleStepComp, HTuple optimizationComp, HTuple metricComp, HTuple pregenerationComp, out HTuple componentModelID, out HTuple rootRanking)

public HComponentModel(HImage modelImage, HRegion componentRegions, HTuple variationRow, HTuple variationColumn, HTuple variationAngle, double angleStart, double angleExtent, HTuple contrastLowComp, HTuple contrastHighComp, HTuple minSizeComp, HTuple minContrastComp, HTuple minScoreComp, HTuple numLevelsComp, HTuple angleStepComp, string optimizationComp, HTuple metricComp, HTuple pregenerationComp, out HTuple rootRanking)

public HComponentModel(HImage modelImage, HRegion componentRegions, int variationRow, int variationColumn, double variationAngle, double angleStart, double angleExtent, int contrastLowComp, int contrastHighComp, int minSizeComp, int minContrastComp, double minScoreComp, int numLevelsComp, double angleStepComp, string optimizationComp, string metricComp, string pregenerationComp, out int rootRanking)

HTuple HComponentModel.CreateComponentModel(HImage modelImage, HRegion componentRegions, HTuple variationRow, HTuple variationColumn, HTuple variationAngle, double angleStart, double angleExtent, HTuple contrastLowComp, HTuple contrastHighComp, HTuple minSizeComp, HTuple minContrastComp, HTuple minScoreComp, HTuple numLevelsComp, HTuple angleStepComp, string optimizationComp, HTuple metricComp, HTuple pregenerationComp)

int HComponentModel.CreateComponentModel(HImage modelImage, HRegion componentRegions, int variationRow, int variationColumn, double variationAngle, double angleStart, double angleExtent, int contrastLowComp, int contrastHighComp, int minSizeComp, int minContrastComp, double minScoreComp, int numLevelsComp, double angleStepComp, string optimizationComp, string metricComp, string pregenerationComp)

HComponentModel HImage.CreateComponentModel(HRegion componentRegions, HTuple variationRow, HTuple variationColumn, HTuple variationAngle, double angleStart, double angleExtent, HTuple contrastLowComp, HTuple contrastHighComp, HTuple minSizeComp, HTuple minContrastComp, HTuple minScoreComp, HTuple numLevelsComp, HTuple angleStepComp, string optimizationComp, HTuple metricComp, HTuple pregenerationComp, out HTuple rootRanking)

HComponentModel HImage.CreateComponentModel(HRegion componentRegions, int variationRow, int variationColumn, double variationAngle, double angleStart, double angleExtent, int contrastLowComp, int contrastHighComp, int minSizeComp, int minContrastComp, double minScoreComp, int numLevelsComp, double angleStepComp, string optimizationComp, string metricComp, string pregenerationComp, out int rootRanking)

Description

create_component_modelcreate_component_modelCreateComponentModelCreateComponentModelCreateComponentModel prepares patterns, which are passed in the form of a model image ModelImageModelImageModelImageModelImagemodelImage and several regions ComponentRegionsComponentRegionsComponentRegionsComponentRegionscomponentRegions, as a component model for matching. The output parameter ComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelID is a handle for this model, which is used in subsequent calls to find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModel. In contrast to create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModelCreateTrainedComponentModel, no preceding training with train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponents needs to be performed before calling create_component_modelcreate_component_modelCreateComponentModelCreateComponentModelCreateComponentModel.

Each of the regions passed in ComponentRegionsComponentRegionsComponentRegionsComponentRegionscomponentRegions describes a separate model component. Later, the index of a component region in ComponentRegionsComponentRegionsComponentRegionsComponentRegionscomponentRegions is used to denote the model component. The reference point of a component is the center of gravity of its associated region, which is passed in ComponentRegionsComponentRegionsComponentRegionsComponentRegionscomponentRegions. It can be calculated by calling area_centerarea_centerAreaCenterAreaCenterAreaCenter.

The relative movements (relations) of the model components can be set by passing VariationRowVariationRowVariationRowVariationRowvariationRow, VariationColumnVariationColumnVariationColumnVariationColumnvariationColumn, and VariationAngleVariationAngleVariationAngleVariationAnglevariationAngle. Because directly passing the relations is complicated, instead of the relations the variations of the model components are passed. The variations describe the movements of the components independently from each other relative to their poses in the model image ModelImageModelImageModelImageModelImagemodelImage. The parameters VariationRowVariationRowVariationRowVariationRowvariationRow and VariationColumnVariationColumnVariationColumnVariationColumnvariationColumn describe the movement of the components in row and column direction by and , respectively. The parameter VariationAngleVariationAngleVariationAngleVariationAnglevariationAngle describes the angle variation of the component by . Based on these values, the relations are automatically computed. The three parameters must either contain one element, in which case the parameter is used for all model components, or must contain the same number of elements as ComponentRegionsComponentRegionsComponentRegionsComponentRegionscomponentRegions, in which case each parameter element refers to the corresponding model component in ComponentRegionsComponentRegionsComponentRegionsComponentRegionscomponentRegions.

The parameters AngleStartAngleStartAngleStartAngleStartangleStart and AngleExtentAngleExtentAngleExtentAngleExtentangleExtent determine the range of possible rotations of the component model in an image.

Internally, a separate shape model is built for each model component (see create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelCreateShapeModel). Therefore, the parameters ContrastLowCompContrastLowCompContrastLowCompContrastLowCompcontrastLowComp, ContrastHighCompContrastHighCompContrastHighCompContrastHighCompcontrastHighComp, MinSizeCompMinSizeCompMinSizeCompMinSizeCompminSizeComp, MinContrastCompMinContrastCompMinContrastCompMinContrastCompminContrastComp, MinScoreCompMinScoreCompMinScoreCompMinScoreCompminScoreComp, NumLevelsCompNumLevelsCompNumLevelsCompNumLevelsCompnumLevelsComp, AngleStepCompAngleStepCompAngleStepCompAngleStepCompangleStepComp, OptimizationCompOptimizationCompOptimizationCompOptimizationCompoptimizationComp, MetricCompMetricCompMetricCompMetricCompmetricComp, and PregenerationCompPregenerationCompPregenerationCompPregenerationComppregenerationComp correspond to the parameters of create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelCreateShapeModel, with the following differences: First, in the parameter ContrastContrastContrastContrastcontrast of create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelCreateShapeModel the upper as well as the lower threshold for the hysteresis threshold method can be passed. Additionally, a third value, which suppresses small connected contour regions, can be passed. In contrast, the operator create_component_modelcreate_component_modelCreateComponentModelCreateComponentModelCreateComponentModel offers three separate parameters ContrastHighCompContrastHighCompContrastHighCompContrastHighCompcontrastHighComp, ContrastLowCompContrastLowCompContrastLowCompContrastLowCompcontrastLowComp, and MinScoreCompMinScoreCompMinScoreCompMinScoreCompminScoreComp in order to set these three values. Consequently, also the automatic computation of the contrast threshold(s) is different. If both hysteresis threshold should be automatically determined, both ContrastLowCompContrastLowCompContrastLowCompContrastLowCompcontrastLowComp and ContrastHighCompContrastHighCompContrastHighCompContrastHighCompcontrastHighComp must be set to 'auto'"auto""auto""auto""auto". In contrast, if only one threshold value should be determined, ContrastLowCompContrastLowCompContrastLowCompContrastLowCompcontrastLowComp must be set to 'auto'"auto""auto""auto""auto" while ContrastHighCompContrastHighCompContrastHighCompContrastHighCompcontrastHighComp must be set to an arbitrary value different from 'auto'"auto""auto""auto""auto". Secondly, the parameter OptimizationOptimizationOptimizationOptimizationoptimization of create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelCreateShapeModel provides the possibility to reduce the number of model points as well as the possibility to completely pregenerate the shape model. In contrast, the operator create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModelCreateTrainedComponentModel uses a separate parameter PregenerationCompPregenerationCompPregenerationCompPregenerationComppregenerationComp in order to decide whether the shape models should be completely pregenerated or not. A third difference concerning the parameter MinScoreCompMinScoreCompMinScoreCompMinScoreCompminScoreComp should be noted. When using the shape-based matching, this parameter needs not be passed when preparing the shape model using create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelCreateShapeModel, but only during the search using find_shape_modelfind_shape_modelFindShapeModelFindShapeModelFindShapeModel. In contrast, when preparing the component model it is favorable to analyze rotational symmetries of the model components and similarities between the model components. However, this analysis only leads to meaningful results if the value for MinScoreCompMinScoreCompMinScoreCompMinScoreCompminScoreComp that is used during the search (see find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModel) is already approximately known.

In addition to the parameters ContrastLowCompContrastLowCompContrastLowCompContrastLowCompcontrastLowComp, ContrastHighCompContrastHighCompContrastHighCompContrastHighCompcontrastHighComp, and MinSizeCompMinSizeCompMinSizeCompMinSizeCompminSizeComp also the parameters MinContrastCompMinContrastCompMinContrastCompMinContrastCompminContrastComp, NumLevelsCompNumLevelsCompNumLevelsCompNumLevelsCompnumLevelsComp, AngleStepCompAngleStepCompAngleStepCompAngleStepCompangleStepComp, and OptimizationCompOptimizationCompOptimizationCompOptimizationCompoptimizationComp can be automatically determined by passing 'auto'"auto""auto""auto""auto" for the respective parameters.

All component-specific input parameters (parameter names terminate with the suffix Comp) must either contain one element, in which case the parameter is used for all model components, or must contain the same number of elements as the number of regions in ComponentRegionsComponentRegionsComponentRegionsComponentRegionscomponentRegions, in which case each parameter element refers to the corresponding element in ComponentRegionsComponentRegionsComponentRegionsComponentRegionscomponentRegions.

In addition to the individual shape models, the component model also contains information about the way the single model components must be searched relative to each other using find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModel in order to minimize the computation time of the search. For this, the components are represented in a tree structure. First, the component that stands at the root of this search tree (root component) is searched. Then, the remaining components are searched relative to the pose of their predecessor in the search tree.

The root component can be passed as an input parameter of find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModel during the search. To what extent a model component is suited to act as the root component depends on several factors. In principle, a model component that can be found in the image with a high probability should be chosen. Therefore, a component that is sometimes occluded to a high degree or that is missing in some cases is not well suited to act as the root component. Additionally, the computation time that is associated with the root component during the search can serve as a criterion. A ranking of the model components that is based on the latter criterion is returned in RootRankingRootRankingRootRankingRootRankingrootRanking. In this parameter the indices of the model components are sorted in descending order according to their associated search time, i.e., RootRankingRootRankingRootRankingRootRankingrootRanking[0] contains the index of the model component that, chosen as root component, allows the fastest search. Note that the ranking returned in RootRankingRootRankingRootRankingRootRankingrootRanking represents only a coarse estimation. Furthermore, the calculation of the root ranking assumes that the image size as well as the value of the system parameter 'border_shape_models'"border_shape_models""border_shape_models""border_shape_models""border_shape_models" are identical when calling create_component_modelcreate_component_modelCreateComponentModelCreateComponentModelCreateComponentModel and find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModel.

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

ModelImageModelImageModelImageModelImagemodelImage (input_object)  (multichannel-)image objectHImageHImageHobject (byte / uint2)

Input image from which the shape models of the model components should be created.

ComponentRegionsComponentRegionsComponentRegionsComponentRegionscomponentRegions (input_object)  region-array objectHRegionHRegionHobject

Input regions from which the shape models of the model components should be created.

VariationRowVariationRowVariationRowVariationRowvariationRow (input_control)  integer(-array) HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Variation of the model components in row direction.

Suggested values: 0, 1, 2, 3, 4, 5, 10, 20, 30, 40, 50, 100, 150

Restriction: VariationRow >= 0

VariationColumnVariationColumnVariationColumnVariationColumnvariationColumn (input_control)  integer(-array) HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Variation of the model components in column direction.

Suggested values: 0, 1, 2, 3, 4, 5, 10, 20, 30, 40, 50, 100, 150

Restriction: VariationColumn >= 0

VariationAngleVariationAngleVariationAngleVariationAnglevariationAngle (input_control)  angle.rad(-array) HTupleHTupleHtuple (real) (double) (double) (double)

Angle variation of the model components.

Suggested values: 0.0, 0.017, 0.035, 0.05, 0.07, 0.09, 0.17, 0.35, 0.52, 0.67, 0.87

Restriction: VariationAngle >= 0

AngleStartAngleStartAngleStartAngleStartangleStart (input_control)  angle.rad HTupleHTupleHtuple (real) (double) (double) (double)

Smallest rotation of the component model.

Default value: -0.39

Suggested values: -3.14, -1.57, -0.79, -0.39, -0.20, 0.0

AngleExtentAngleExtentAngleExtentAngleExtentangleExtent (input_control)  angle.rad HTupleHTupleHtuple (real) (double) (double) (double)

Extent of the rotation of the component model.

Default value: 0.79

Suggested values: 6.28, 3.14, 1.57, 0.79, 0.39

Restriction: AngleExtent >= 0

ContrastLowCompContrastLowCompContrastLowCompContrastLowCompcontrastLowComp (input_control)  integer(-array) HTupleHTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)

Lower hysteresis threshold for the contrast of the components in the model image.

Default value: 'auto' "auto" "auto" "auto" "auto"

Suggested values: 'auto'"auto""auto""auto""auto", 10, 20, 30, 40, 60, 80, 100, 120, 140, 160

Restriction: ContrastLowComp > 0

ContrastHighCompContrastHighCompContrastHighCompContrastHighCompcontrastHighComp (input_control)  integer(-array) HTupleHTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)

Upper hysteresis threshold for the contrast of the components in the model image.

Default value: 'auto' "auto" "auto" "auto" "auto"

Suggested values: 'auto'"auto""auto""auto""auto", 10, 20, 30, 40, 60, 80, 100, 120, 140, 160

Restriction: ContrastHighComp > 0 && ContrastHighComp >= ContrastLowComp

MinSizeCompMinSizeCompMinSizeCompMinSizeCompminSizeComp (input_control)  integer(-array) HTupleHTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)

Minimum size of the contour regions in the model.

Default value: 'auto' "auto" "auto" "auto" "auto"

Suggested values: 'auto'"auto""auto""auto""auto", 0, 5, 10, 20, 30, 40

Restriction: MinSizeComp >= 0

MinContrastCompMinContrastCompMinContrastCompMinContrastCompminContrastComp (input_control)  integer(-array) HTupleHTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)

Minimum contrast of the components in the search images.

Default value: 'auto' "auto" "auto" "auto" "auto"

Suggested values: 'auto'"auto""auto""auto""auto", 10, 20, 20, 40

Restriction: MinContrastComp <= ContrastLowComp && MinContrastComp >= 0

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

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

Default value: 0.5

Suggested values: 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0

Minimum increment: 0.01

Recommended increment: 0.05

Restriction: 0 <= MinScoreComp && MinScoreComp <= 1

NumLevelsCompNumLevelsCompNumLevelsCompNumLevelsCompnumLevelsComp (input_control)  integer(-array) HTupleHTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)

Maximum number of pyramid levels for the components.

Default value: 'auto' "auto" "auto" "auto" "auto"

List of values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 'auto'"auto""auto""auto""auto"

AngleStepCompAngleStepCompAngleStepCompAngleStepCompangleStepComp (input_control)  angle.rad(-array) HTupleHTupleHtuple (real / string) (double / string) (double / HString) (double / char*)

Step length of the angles (resolution) for the components.

Default value: 'auto' "auto" "auto" "auto" "auto"

Suggested values: 'auto'"auto""auto""auto""auto", 0.0175, 0.0349, 0.0524, 0.0698, 0.0873

Restriction: AngleStepComp >= 0

OptimizationCompOptimizationCompOptimizationCompOptimizationCompoptimizationComp (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Kind of optimization for the components.

Default value: 'auto' "auto" "auto" "auto" "auto"

List of values: 'auto'"auto""auto""auto""auto", 'none'"none""none""none""none", 'point_reduction_high'"point_reduction_high""point_reduction_high""point_reduction_high""point_reduction_high", 'point_reduction_low'"point_reduction_low""point_reduction_low""point_reduction_low""point_reduction_low", 'point_reduction_medium'"point_reduction_medium""point_reduction_medium""point_reduction_medium""point_reduction_medium"

MetricCompMetricCompMetricCompMetricCompmetricComp (input_control)  string(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Match metric used for the components.

Default value: 'use_polarity' "use_polarity" "use_polarity" "use_polarity" "use_polarity"

List of values: 'ignore_color_polarity'"ignore_color_polarity""ignore_color_polarity""ignore_color_polarity""ignore_color_polarity", 'ignore_global_polarity'"ignore_global_polarity""ignore_global_polarity""ignore_global_polarity""ignore_global_polarity", 'ignore_local_polarity'"ignore_local_polarity""ignore_local_polarity""ignore_local_polarity""ignore_local_polarity", 'use_polarity'"use_polarity""use_polarity""use_polarity""use_polarity"

PregenerationCompPregenerationCompPregenerationCompPregenerationComppregenerationComp (input_control)  string(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Complete pregeneration of the shape models for the components if equal to 'true'"true""true""true""true".

Default value: 'false' "false" "false" "false" "false"

List of values: 'false'"false""false""false""false", 'true'"true""true""true""true"

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

Handle of the component model.

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

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

Example (HDevelop)

* Read the model image.
read_image (ModelImage, 'model_image.tif')
* Describe the model components.
gen_rectangle2 (ComponentRegions, 318, 109, -1.62, 34, 19)
gen_rectangle2 (Rectangle2, 342, 238, -1.63, 32, 17)
gen_rectangle2 (Rectangle3, 355, 505, 1.41, 25, 17)
concat_obj (ComponentRegions, Rectangle2, ComponentRegions)
concat_obj (ComponentRegions, Rectangle3, ComponentRegions)
* Create the component model by explicitly specifying the relations.
create_component_model (ModelImage, ComponentRegions, 20, 20, rad(25), 0, \
                        rad(360), 15, 40, 15, 10, 0.8, 'auto', 'auto', \
                        'none', 'use_polarity', 'false', ComponentModelID, \
                        RootRanking)
* Find the component model in a run-time image.
read_image (SearchImage, 'search_image.tif')
find_component_model (SearchImage, ComponentModelID, RootRanking, 0, \
                      rad(360), 0.5, 0, 0.5, 'stop_search', \
                      'search_from_best', 'none', 0.8, 'least_squares', 0, \
                      0.8, ModelStart, ModelEnd, Score, RowComp, \
                      ColumnComp, AngleComp, ScoreComp, ModelComp)

Result

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

Possible Predecessors

draw_regiondraw_regionDrawRegionDrawRegionDrawRegion, concat_objconcat_objConcatObjConcatObjConcatObj

Possible Successors

find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModel

Alternatives

create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModelCreateTrainedComponentModel

See also

create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelCreateShapeModel, find_shape_modelfind_shape_modelFindShapeModelFindShapeModelFindShapeModel

Module

Matching