Name
find_component_modelfind_component_modelFindComponentModelfind_component_modelFindComponentModelFindComponentModel — Find the best matches of a component model in an image.
find_component_model(Image : : ComponentModelID, RootComponent, AngleStartRoot, AngleExtentRoot, MinScore, NumMatches, MaxOverlap, IfRootNotFound, IfComponentNotFound, PosePrediction, MinScoreComp, SubPixelComp, NumLevelsComp, GreedinessComp : ModelStart, ModelEnd, Score, RowComp, ColumnComp, AngleComp, ScoreComp, ModelComp)
Herror find_component_model(const Hobject Image, const Hlong ComponentModelID, const Hlong RootComponent, double AngleStartRoot, double AngleExtentRoot, double MinScore, const Hlong NumMatches, double MaxOverlap, const char* IfRootNotFound, const char* IfComponentNotFound, const char* PosePrediction, double MinScoreComp, const char* SubPixelComp, const Hlong NumLevelsComp, double GreedinessComp, Hlong* ModelStart, Hlong* ModelEnd, double* Score, double* RowComp, double* ColumnComp, double* AngleComp, double* ScoreComp, Hlong* ModelComp)
Herror T_find_component_model(const Hobject Image, const Htuple ComponentModelID, const Htuple RootComponent, const Htuple AngleStartRoot, const Htuple AngleExtentRoot, const Htuple MinScore, const Htuple NumMatches, const Htuple MaxOverlap, const Htuple IfRootNotFound, const Htuple IfComponentNotFound, const Htuple PosePrediction, const Htuple MinScoreComp, const Htuple SubPixelComp, const Htuple NumLevelsComp, const Htuple GreedinessComp, Htuple* ModelStart, Htuple* ModelEnd, Htuple* Score, Htuple* RowComp, Htuple* ColumnComp, Htuple* AngleComp, Htuple* ScoreComp, Htuple* ModelComp)
Herror find_component_model(Hobject Image, const HTuple& ComponentModelID, const HTuple& RootComponent, const HTuple& AngleStartRoot, const HTuple& AngleExtentRoot, const HTuple& MinScore, const HTuple& NumMatches, const HTuple& MaxOverlap, const HTuple& IfRootNotFound, const HTuple& IfComponentNotFound, const HTuple& PosePrediction, const HTuple& MinScoreComp, const HTuple& SubPixelComp, const HTuple& NumLevelsComp, const HTuple& GreedinessComp, Hlong* ModelStart, Hlong* ModelEnd, double* Score, double* RowComp, double* ColumnComp, double* AngleComp, double* ScoreComp, Hlong* ModelComp)
Herror find_component_model(Hobject Image, const HTuple& ComponentModelID, const HTuple& RootComponent, const HTuple& AngleStartRoot, const HTuple& AngleExtentRoot, const HTuple& MinScore, const HTuple& NumMatches, const HTuple& MaxOverlap, const HTuple& IfRootNotFound, const HTuple& IfComponentNotFound, const HTuple& PosePrediction, const HTuple& MinScoreComp, const HTuple& SubPixelComp, const HTuple& NumLevelsComp, const HTuple& GreedinessComp, HTuple* ModelStart, HTuple* ModelEnd, HTuple* Score, HTuple* RowComp, HTuple* ColumnComp, HTuple* AngleComp, HTuple* ScoreComp, HTuple* ModelComp)
HTuple HImage::FindComponentModel(const HComponentModel& ComponentModelID, const HTuple& RootComponent, const HTuple& AngleStartRoot, const HTuple& AngleExtentRoot, const HTuple& MinScore, const HTuple& NumMatches, const HTuple& MaxOverlap, const HTuple& IfRootNotFound, const HTuple& IfComponentNotFound, const HTuple& PosePrediction, const HTuple& MinScoreComp, const HTuple& SubPixelComp, const HTuple& NumLevelsComp, const HTuple& GreedinessComp, HTuple* ModelEnd, HTuple* Score, HTuple* RowComp, HTuple* ColumnComp, HTuple* AngleComp, HTuple* ScoreComp, HTuple* ModelComp) const
HTuple HComponentModel::FindComponentModel(const HImage& Image, const HTuple& RootComponent, const HTuple& AngleStartRoot, const HTuple& AngleExtentRoot, const HTuple& MinScore, const HTuple& NumMatches, const HTuple& MaxOverlap, const HTuple& IfRootNotFound, const HTuple& IfComponentNotFound, const HTuple& PosePrediction, const HTuple& MinScoreComp, const HTuple& SubPixelComp, const HTuple& NumLevelsComp, const HTuple& GreedinessComp, HTuple* ModelEnd, HTuple* Score, HTuple* RowComp, HTuple* ColumnComp, HTuple* AngleComp, HTuple* ScoreComp, HTuple* ModelComp) const
void FindComponentModel(const HObject& Image, const HTuple& ComponentModelID, const HTuple& RootComponent, const HTuple& AngleStartRoot, const HTuple& AngleExtentRoot, const HTuple& MinScore, const HTuple& NumMatches, const HTuple& MaxOverlap, const HTuple& IfRootNotFound, const HTuple& IfComponentNotFound, const HTuple& PosePrediction, const HTuple& MinScoreComp, const HTuple& SubPixelComp, const HTuple& NumLevelsComp, const HTuple& GreedinessComp, HTuple* ModelStart, HTuple* ModelEnd, HTuple* Score, HTuple* RowComp, HTuple* ColumnComp, HTuple* AngleComp, HTuple* ScoreComp, HTuple* ModelComp)
HTuple HComponentModel::FindComponentModel(const HImage& Image, const HTuple& RootComponent, const HTuple& AngleStartRoot, const HTuple& AngleExtentRoot, double MinScore, Hlong NumMatches, double MaxOverlap, const HString& IfRootNotFound, const HString& IfComponentNotFound, const HString& PosePrediction, const HTuple& MinScoreComp, const HTuple& SubPixelComp, const HTuple& NumLevelsComp, const HTuple& GreedinessComp, HTuple* ModelEnd, HTuple* Score, HTuple* RowComp, HTuple* ColumnComp, HTuple* AngleComp, HTuple* ScoreComp, HTuple* ModelComp) const
Hlong HComponentModel::FindComponentModel(const HImage& Image, Hlong RootComponent, double AngleStartRoot, double AngleExtentRoot, double MinScore, Hlong NumMatches, double MaxOverlap, const HString& IfRootNotFound, const HString& IfComponentNotFound, const HString& PosePrediction, double MinScoreComp, const HString& SubPixelComp, Hlong NumLevelsComp, double GreedinessComp, Hlong* ModelEnd, double* Score, double* RowComp, double* ColumnComp, double* AngleComp, double* ScoreComp, Hlong* ModelComp) const
Hlong HComponentModel::FindComponentModel(const HImage& Image, Hlong RootComponent, double AngleStartRoot, double AngleExtentRoot, double MinScore, Hlong NumMatches, double MaxOverlap, const char* IfRootNotFound, const char* IfComponentNotFound, const char* PosePrediction, double MinScoreComp, const char* SubPixelComp, Hlong NumLevelsComp, double GreedinessComp, Hlong* ModelEnd, double* Score, double* RowComp, double* ColumnComp, double* AngleComp, double* ScoreComp, Hlong* ModelComp) const
HTuple HImage::FindComponentModel(const HComponentModel& ComponentModelID, const HTuple& RootComponent, const HTuple& AngleStartRoot, const HTuple& AngleExtentRoot, double MinScore, Hlong NumMatches, double MaxOverlap, const HString& IfRootNotFound, const HString& IfComponentNotFound, const HString& PosePrediction, const HTuple& MinScoreComp, const HTuple& SubPixelComp, const HTuple& NumLevelsComp, const HTuple& GreedinessComp, HTuple* ModelEnd, HTuple* Score, HTuple* RowComp, HTuple* ColumnComp, HTuple* AngleComp, HTuple* ScoreComp, HTuple* ModelComp) const
Hlong HImage::FindComponentModel(const HComponentModel& ComponentModelID, Hlong RootComponent, double AngleStartRoot, double AngleExtentRoot, double MinScore, Hlong NumMatches, double MaxOverlap, const HString& IfRootNotFound, const HString& IfComponentNotFound, const HString& PosePrediction, double MinScoreComp, const HString& SubPixelComp, Hlong NumLevelsComp, double GreedinessComp, Hlong* ModelEnd, double* Score, double* RowComp, double* ColumnComp, double* AngleComp, double* ScoreComp, Hlong* ModelComp) const
Hlong HImage::FindComponentModel(const HComponentModel& ComponentModelID, Hlong RootComponent, double AngleStartRoot, double AngleExtentRoot, double MinScore, Hlong NumMatches, double MaxOverlap, const char* IfRootNotFound, const char* IfComponentNotFound, const char* PosePrediction, double MinScoreComp, const char* SubPixelComp, Hlong NumLevelsComp, double GreedinessComp, Hlong* ModelEnd, double* Score, double* RowComp, double* ColumnComp, double* AngleComp, double* ScoreComp, Hlong* ModelComp) const
void HOperatorSetX.FindComponentModel(
[in] IHUntypedObjectX* Image, [in] VARIANT ComponentModelID, [in] VARIANT RootComponent, [in] VARIANT AngleStartRoot, [in] VARIANT AngleExtentRoot, [in] VARIANT MinScore, [in] VARIANT NumMatches, [in] VARIANT MaxOverlap, [in] VARIANT IfRootNotFound, [in] VARIANT IfComponentNotFound, [in] VARIANT PosePrediction, [in] VARIANT MinScoreComp, [in] VARIANT SubPixelComp, [in] VARIANT NumLevelsComp, [in] VARIANT GreedinessComp, [out] VARIANT* ModelStart, [out] VARIANT* ModelEnd, [out] VARIANT* Score, [out] VARIANT* RowComp, [out] VARIANT* ColumnComp, [out] VARIANT* AngleComp, [out] VARIANT* ScoreComp, [out] VARIANT* ModelComp)
VARIANT HComponentModelX.FindComponentModel(
[in] IHImageX* Image, [in] VARIANT RootComponent, [in] VARIANT AngleStartRoot, [in] VARIANT AngleExtentRoot, [in] double MinScore, [in] Hlong NumMatches, [in] double MaxOverlap, [in] BSTR IfRootNotFound, [in] BSTR IfComponentNotFound, [in] BSTR PosePrediction, [in] VARIANT MinScoreComp, [in] VARIANT SubPixelComp, [in] VARIANT NumLevelsComp, [in] VARIANT GreedinessComp, [out] VARIANT* ModelEnd, [out] VARIANT* Score, [out] VARIANT* RowComp, [out] VARIANT* ColumnComp, [out] VARIANT* AngleComp, [out] VARIANT* ScoreComp, [out] VARIANT* ModelComp)
VARIANT HImageX.FindComponentModel(
[in] IHComponentModelX* ComponentModelID, [in] VARIANT RootComponent, [in] VARIANT AngleStartRoot, [in] VARIANT AngleExtentRoot, [in] double MinScore, [in] Hlong NumMatches, [in] double MaxOverlap, [in] BSTR IfRootNotFound, [in] BSTR IfComponentNotFound, [in] BSTR PosePrediction, [in] VARIANT MinScoreComp, [in] VARIANT SubPixelComp, [in] VARIANT NumLevelsComp, [in] VARIANT GreedinessComp, [out] VARIANT* ModelEnd, [out] VARIANT* Score, [out] VARIANT* RowComp, [out] VARIANT* ColumnComp, [out] VARIANT* AngleComp, [out] VARIANT* ScoreComp, [out] VARIANT* ModelComp)
static void HOperatorSet.FindComponentModel(HObject image, HTuple componentModelID, HTuple rootComponent, HTuple angleStartRoot, HTuple angleExtentRoot, HTuple minScore, HTuple numMatches, HTuple maxOverlap, HTuple ifRootNotFound, HTuple ifComponentNotFound, HTuple posePrediction, HTuple minScoreComp, HTuple subPixelComp, HTuple numLevelsComp, HTuple greedinessComp, out HTuple modelStart, out HTuple modelEnd, out HTuple score, out HTuple rowComp, out HTuple columnComp, out HTuple angleComp, out HTuple scoreComp, out HTuple modelComp)
HTuple HComponentModel.FindComponentModel(HImage image, HTuple rootComponent, HTuple angleStartRoot, HTuple angleExtentRoot, double minScore, int numMatches, double maxOverlap, string ifRootNotFound, string ifComponentNotFound, string posePrediction, HTuple minScoreComp, HTuple subPixelComp, HTuple numLevelsComp, HTuple greedinessComp, out HTuple modelEnd, out HTuple score, out HTuple rowComp, out HTuple columnComp, out HTuple angleComp, out HTuple scoreComp, out HTuple modelComp)
int HComponentModel.FindComponentModel(HImage image, int rootComponent, double angleStartRoot, double angleExtentRoot, double minScore, int numMatches, double maxOverlap, string ifRootNotFound, string ifComponentNotFound, string posePrediction, double minScoreComp, string subPixelComp, int numLevelsComp, double greedinessComp, out int modelEnd, out double score, out double rowComp, out double columnComp, out double angleComp, out double scoreComp, out int modelComp)
HTuple HImage.FindComponentModel(HComponentModel componentModelID, HTuple rootComponent, HTuple angleStartRoot, HTuple angleExtentRoot, double minScore, int numMatches, double maxOverlap, string ifRootNotFound, string ifComponentNotFound, string posePrediction, HTuple minScoreComp, HTuple subPixelComp, HTuple numLevelsComp, HTuple greedinessComp, out HTuple modelEnd, out HTuple score, out HTuple rowComp, out HTuple columnComp, out HTuple angleComp, out HTuple scoreComp, out HTuple modelComp)
int HImage.FindComponentModel(HComponentModel componentModelID, int rootComponent, double angleStartRoot, double angleExtentRoot, double minScore, int numMatches, double maxOverlap, string ifRootNotFound, string ifComponentNotFound, string posePrediction, double minScoreComp, string subPixelComp, int numLevelsComp, double greedinessComp, out int modelEnd, out double score, out double rowComp, out double columnComp, out double angleComp, out double scoreComp, out int modelComp)
The operator find_component_modelfind_component_modelFindComponentModelfind_component_modelFindComponentModelFindComponentModel finds the best
NumMatchesNumMatchesNumMatchesNumMatchesNumMatchesnumMatches instances of the component model
ComponentModelIDComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelID in the input image ImageImageImageImageImageimage. The
model must have been created previously by calling
create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModel,
create_component_modelcreate_component_modelCreateComponentModelcreate_component_modelCreateComponentModelCreateComponentModel, or read_component_modelread_component_modelReadComponentModelread_component_modelReadComponentModelReadComponentModel.
The components of the component model ComponentModelIDComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelID are
represented in in a tree structure. The component that stands at the
root of this search tree (root component) is searched within the
full search space, i.e., at all allowed positions and in the allowed
range of orientations (see below). In contrast, the remaining
components are searched relative to the pose of their predecessor in
the search tree within a restricted search space that is computed
from the relations (recursive search). The index of the root
component can be passed in RootComponentRootComponentRootComponentRootComponentRootComponentrootComponent. To what extent a
model component is suited to act as 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 root
component. The behavior of the operator when dealing with a missing
or strongly occluded root component can be set with
IfRootNotFoundIfRootNotFoundIfRootNotFoundIfRootNotFoundIfRootNotFoundifRootNotFound (see below). Also, 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 RootRankingRootRankingRootRankingRootRankingRootRankingrootRanking
of the operator create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModel or
create_component_modelcreate_component_modelCreateComponentModelcreate_component_modelCreateComponentModelCreateComponentModel, respectively. If the complete
ranking is passed in RootComponentRootComponentRootComponentRootComponentRootComponentrootComponent, the first value
RootComponentRootComponentRootComponentRootComponentRootComponentrootComponent[0] is automatically selected as the root
component. The domain of the image ImageImageImageImageImageimage determines the
search space for the reference point, i.e., the allowed positions,
of the root component. The parameters AngleStartRootAngleStartRootAngleStartRootAngleStartRootAngleStartRootangleStartRoot and
AngleExtentRootAngleExtentRootAngleExtentRootAngleExtentRootAngleExtentRootangleExtentRoot specify the allowed angle range within which
the root component is searched. If necessary, the range of rotations
is clipped to the range given when the component model was created
with create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModel or
create_component_modelcreate_component_modelCreateComponentModelcreate_component_modelCreateComponentModelCreateComponentModel, respectively. The angle range for
each component can be queried with get_shape_model_paramsget_shape_model_paramsGetShapeModelParamsget_shape_model_paramsGetShapeModelParamsGetShapeModelParams
after requesting the corresponding shape model handles with
get_component_model_paramsget_component_model_paramsGetComponentModelParamsget_component_model_paramsGetComponentModelParamsGetComponentModelParams.
The position and rotation of the model components of all found
component model instances are returned in RowCompRowCompRowCompRowCompRowComprowComp,
ColumnCompColumnCompColumnCompColumnCompColumnCompcolumnComp, and AngleCompAngleCompAngleCompAngleCompAngleCompangleComp. The coordinates
RowCompRowCompRowCompRowCompRowComprowComp and ColumnCompColumnCompColumnCompColumnCompColumnCompcolumnComp are the coordinates of the
origin (reference point) of the component in the search image. If
the component model was created with
create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModel by training, the origin of
the component is the center of gravity of the respective returned
contour region in ModelComponentsModelComponentsModelComponentsModelComponentsModelComponentsmodelComponents of the operator
train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents. Otherwise, if the component model
was created manually with create_component_modelcreate_component_modelCreateComponentModelcreate_component_modelCreateComponentModelCreateComponentModel, the origin
of the component is the center of gravity of the corresponding
passed component region ComponentRegionComponentRegionComponentRegionComponentRegionComponentRegioncomponentRegion of the operator
create_component_modelcreate_component_modelCreateComponentModelcreate_component_modelCreateComponentModelCreateComponentModel. Since the relations between the
components in ComponentModelIDComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelID refer to this reference
point, the origin of the components must not be modified by using
set_shape_model_originset_shape_model_originSetShapeModelOriginset_shape_model_originSetShapeModelOriginSetShapeModelOrigin.
Additionally, the score of each found component instance is returned
in ScoreCompScoreCompScoreCompScoreCompScoreCompscoreComp. The score is a number between 0 and 1, and
is an approximate measure of how much of the component is visible in
the image. If, for example, half of the component is occluded, the
score cannot exceed 0.5. While ScoreCompScoreCompScoreCompScoreCompScoreCompscoreComp represents the
score of the instances of the single components, ScoreScoreScoreScoreScorescore
contains the score of the instances of the entire component
model. More precisely, ScoreScoreScoreScoreScorescore contains the weighted mean of
the associated values of ScoreCompScoreCompScoreCompScoreCompScoreCompscoreComp. The weighting is
performed according to the number of model points within the
respective component.
In order to assign the values in RowCompRowCompRowCompRowCompRowComprowComp,
ColumnCompColumnCompColumnCompColumnCompColumnCompcolumnComp, AngleCompAngleCompAngleCompAngleCompAngleCompangleComp, and ScoreCompScoreCompScoreCompScoreCompScoreCompscoreComp to
the associated model component, the index of the model component
(see create_component_modelcreate_component_modelCreateComponentModelcreate_component_modelCreateComponentModelCreateComponentModel and
train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents, respectively) is returned in
ModelCompModelCompModelCompModelCompModelCompmodelComp. Furthermore, for each found instance of the
component model its associated component matches are given in
ModelStartModelStartModelStartModelStartModelStartmodelStart and ModelEndModelEndModelEndModelEndModelEndmodelEnd. Thus, the matches of the
components that correspond to the first found instance of the
component model are given by the interval of indices
[ModelStartModelStartModelStartModelStartModelStartmodelStart[0],ModelEndModelEndModelEndModelEndModelEndmodelEnd[0]]. The indices refer to
the parameters RowCompRowCompRowCompRowCompRowComprowComp, ColumnCompColumnCompColumnCompColumnCompColumnCompcolumnComp,
AngleCompAngleCompAngleCompAngleCompAngleCompangleComp, ScoreCompScoreCompScoreCompScoreCompScoreCompscoreComp, and
ModelCompModelCompModelCompModelCompModelCompmodelComp. Assume, for example, that two instances of the
component model, which consists of three components, are found in
the image, where for one instance only two components (component 0
and component 2) could be found. Then the returned parameters could,
for example, have the following elements: RowCompRowCompRowCompRowCompRowComprowComp =
[100,200,300,150,250], ColumnCompColumnCompColumnCompColumnCompColumnCompcolumnComp =
[200,210,220,400,425], AngleCompAngleCompAngleCompAngleCompAngleCompangleComp =
[0,0.1,-0.2,0.1,0.2,0], ScoreCompScoreCompScoreCompScoreCompScoreCompscoreComp =
[1,1,1,1,1], ModelCompModelCompModelCompModelCompModelCompmodelComp = [0,1,2,0,2],
ModelStartModelStartModelStartModelStartModelStartmodelStart = [0,3], ModelEndModelEndModelEndModelEndModelEndmodelEnd =
[2,4], ScoreScoreScoreScoreScorescore = [1,1]. The operator
get_found_component_modelget_found_component_modelGetFoundComponentModelget_found_component_modelGetFoundComponentModelGetFoundComponentModel can be used to visualize the
result of the search and to extract the component matches of a
certain component model instance.
By default, the components are searched at image positions where the
components lie completely within the image. This means that the
components will not be found if they extend beyond the borders of
the image, even if they would achieve a score greater than
MinScoreCompMinScoreCompMinScoreCompMinScoreCompMinScoreCompminScoreComp (see below). This behavior can be changed
with set_system('border_shape_models','true')set_system("border_shape_models","true")SetSystem("border_shape_models","true")set_system("border_shape_models","true")SetSystem("border_shape_models","true")SetSystem("border_shape_models","true"), which will
cause components that extend beyond the image border to be found if
they achieve a score greater than MinScoreCompMinScoreCompMinScoreCompMinScoreCompMinScoreCompminScoreComp. Here,
points lying outside the image are regarded as being occluded, i.e.,
they lower the score. It should be noted that the runtime of the
search will increase in this mode.
The parameter MinScoreMinScoreMinScoreMinScoreMinScoreminScore determines what score a potential
match of the component model must at least have to be regarded as an
instance of the component model in the image. If the component model
can be expected never to be occluded in the images,
MinScoreMinScoreMinScoreMinScoreMinScoreminScore may be set as high as 0.8 or even
0.9. If a missing or strongly occluded root component must
be assumed, and hence IfRootNotFoundIfRootNotFoundIfRootNotFoundIfRootNotFoundIfRootNotFoundifRootNotFound is set to
'select_new_root'"select_new_root""select_new_root""select_new_root""select_new_root""select_new_root" (see below), the search is faster the
larger MinScoreMinScoreMinScoreMinScoreMinScoreminScore is chosen. Otherwise, the value of this
parameter only slightly influences the computation time.
The maximum number of model instances to be found can be determined
with NumMatchesNumMatchesNumMatchesNumMatchesNumMatchesnumMatches. If more than NumMatchesNumMatchesNumMatchesNumMatchesNumMatchesnumMatches
instances with a score greater than MinScoreMinScoreMinScoreMinScoreMinScoreminScore are found in
the image, only the best NumMatchesNumMatchesNumMatchesNumMatchesNumMatchesnumMatches instances are returned.
If fewer than NumMatchesNumMatchesNumMatchesNumMatchesNumMatchesnumMatches are found, only that number is
returned, i.e., the parameter MinScoreMinScoreMinScoreMinScoreMinScoreminScore takes precedence
over NumMatchesNumMatchesNumMatchesNumMatchesNumMatchesnumMatches. If all model instances exceeding
MinScoreMinScoreMinScoreMinScoreMinScoreminScore in the image should be found, NumMatchesNumMatchesNumMatchesNumMatchesNumMatchesnumMatches
must be set to 0.
In some cases, found instances only differ in the pose of one or a
few components. The parameter MaxOverlapMaxOverlapMaxOverlapMaxOverlapMaxOverlapmaxOverlap determines by what
fraction (i.e., a number between 0 and 1) two instances may at most
overlap in order to consider them as different instances, and hence
to return them separately. If two instances overlap each other by
more than MaxOverlapMaxOverlapMaxOverlapMaxOverlapMaxOverlapmaxOverlap only the best instance is returned.
The calculation of the overlap is based on the smallest enclosing
rectangles of arbitrary orientation (see
smallest_rectangle2smallest_rectangle2SmallestRectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2) of the found component instances. If
MaxOverlapMaxOverlapMaxOverlapMaxOverlapMaxOverlapmaxOverlap = 0, the found instances may not
overlap at all, while for MaxOverlapMaxOverlapMaxOverlapMaxOverlapMaxOverlapmaxOverlap = 1 no
check for overlap is performed, and hence all instances are
returned.
The parameter IfRootNotFoundIfRootNotFoundIfRootNotFoundIfRootNotFoundIfRootNotFoundifRootNotFound specifies the behavior of the
operator when dealing with a missing or strongly occluded root
component. This parameter strongly influences the computation time
of the operator. If IfRootNotFoundIfRootNotFoundIfRootNotFoundIfRootNotFoundIfRootNotFoundifRootNotFound is set to
'stop_search'"stop_search""stop_search""stop_search""stop_search""stop_search", it is assumed that the root component is
always found in the image. Consequently, for instances for which
the root component could not be found the search for the remaining
components is not continued. If IfRootNotFoundIfRootNotFoundIfRootNotFoundIfRootNotFoundIfRootNotFoundifRootNotFound is set to
'select_new_root'"select_new_root""select_new_root""select_new_root""select_new_root""select_new_root", different components are successively
chosen as the root component and searched within the full search
space. The order in which the selection of the root component is
performed corresponds to the order passed in
RootRankingRootRankingRootRankingRootRankingRootRankingrootRanking. The poses of the found instances of all root
components are then used to start the recursive search for the
remaining components. Hence, it is possible to find instances even
if the original root component is not found. However, the
computation time of the search increases significantly in comparison
to the search when choosing 'stop_search'"stop_search""stop_search""stop_search""stop_search""stop_search". The number of
root components to search depends on the value specified for
MinScoreMinScoreMinScoreMinScoreMinScoreminScore. The higher the value for MinScoreMinScoreMinScoreMinScoreMinScoreminScore is
chosen the fewer root components must be searched, and thus the
faster the search is performed. If the number of elements in
RootComponentRootComponentRootComponentRootComponentRootComponentrootComponent is less than the number of required root
components during the search, the root components are completed by
the automatically computed order (see
create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModel or
create_component_modelcreate_component_modelCreateComponentModelcreate_component_modelCreateComponentModelCreateComponentModel).
The parameter IfComponentNotFoundIfComponentNotFoundIfComponentNotFoundIfComponentNotFoundIfComponentNotFoundifComponentNotFound specifies the behavior of
the operator when dealing with missing or strongly occluded
components other than the root component. Here, it can be stated in
which way components that must be searched relative to the pose of
another (predecessor) component should be treated if the predecessor
component was not found. If IfComponentNotFoundIfComponentNotFoundIfComponentNotFoundIfComponentNotFoundIfComponentNotFoundifComponentNotFound is set to
'prune_branch'"prune_branch""prune_branch""prune_branch""prune_branch""prune_branch", such components are not searched at all and
are also treated as 'not found'. If IfComponentNotFoundIfComponentNotFoundIfComponentNotFoundIfComponentNotFoundIfComponentNotFoundifComponentNotFound is
set to 'search_from_upper'"search_from_upper""search_from_upper""search_from_upper""search_from_upper""search_from_upper", such components are searched
relative to the pose of the predecessor component of the predecessor
component. If IfComponentNotFoundIfComponentNotFoundIfComponentNotFoundIfComponentNotFoundIfComponentNotFoundifComponentNotFound is set to
'search_from_best'"search_from_best""search_from_best""search_from_best""search_from_best""search_from_best", such components are searched relative
to the pose of the already found component from which the relative
search can be performed with minimum computational effort.
The parameter PosePredictionPosePredictionPosePredictionPosePredictionPosePredictionposePrediction determines whether the pose of
components that could not be found should be estimated. If
PosePredictionPosePredictionPosePredictionPosePredictionPosePredictionposePrediction is set to 'none'"none""none""none""none""none", only the poses of
the found components are returned. In contrast, if
PosePredictionPosePredictionPosePredictionPosePredictionPosePredictionposePrediction is set to 'from_neighbors'"from_neighbors""from_neighbors""from_neighbors""from_neighbors""from_neighbors" or
'from_all'"from_all""from_all""from_all""from_all""from_all", the poses of components that could not be found
are estimated and returned with a score of ScoreCompScoreCompScoreCompScoreCompScoreCompscoreComp =
0.0. The estimation of the poses is then either based on
the poses of the found neighboring components in the search tree
('from_neighbors'"from_neighbors""from_neighbors""from_neighbors""from_neighbors""from_neighbors") or on the poses of all found components
('from_all'"from_all""from_all""from_all""from_all""from_all").
Internally, the shape-based matching is used for the component-based
matching in order to search the individual components (see
find_shape_modelfind_shape_modelFindShapeModelfind_shape_modelFindShapeModelFindShapeModel). Therefore, the parameters
MinScoreCompMinScoreCompMinScoreCompMinScoreCompMinScoreCompminScoreComp, SubPixelCompSubPixelCompSubPixelCompSubPixelCompSubPixelCompsubPixelComp,
NumLevelsCompNumLevelsCompNumLevelsCompNumLevelsCompNumLevelsCompnumLevelsComp, and GreedinessCompGreedinessCompGreedinessCompGreedinessCompGreedinessCompgreedinessComp have the same
meaning as the corresponding parameters in find_shape_modelfind_shape_modelFindShapeModelfind_shape_modelFindShapeModelFindShapeModel.
These parameters must either contain one element, in which case the
parameter is used for all components, or must contain the same
number of elements as model components in ComponentModelIDComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelID,
in which case each parameter element refers to the corresponding
component in ComponentModelIDComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelID. NumLevelsCompNumLevelsCompNumLevelsCompNumLevelsCompNumLevelsCompnumLevelsComp may
also contain two elements or twice the number of elements as model
components. The first value determines the number of pyramid levels
to use. The second value determines the lowest pyramid level to
which the found matches are tracked. If different values should be
used for different components, the number of pyramid levels and the
lowest pyramid level must be specified interleaved in
NumLevelsCompNumLevelsCompNumLevelsCompNumLevelsCompNumLevelsCompnumLevelsComp. If, for example, two components are
contained in ComponentModelIDComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelID, and the number of pyramid
levels is 5 for the first component and 4 for the second component,
and the lowest pyramid level is 2 for the first component and 1 for
the second component, NumLevelsCompNumLevelsCompNumLevelsCompNumLevelsCompNumLevelsCompnumLevelsComp = [5,2,4,1]
must be selected. Besides the subpixel extraction,
SubPixelCompSubPixelCompSubPixelCompSubPixelCompSubPixelCompsubPixelComp may also contain a second element that
contains the maximum object deformation. The deformation must be
specified in pixels. This can be done by passing the optional
parameter value 'max_deformation '"max_deformation ""max_deformation ""max_deformation ""max_deformation ""max_deformation " followed by an integer
value between 0 and 32 (in the same string), which
specifies the maximum deformation. To get a meaningful score value
and to avoid erroneous matches, we recommend to always combine the
allowance of a deformation with a subpixel extraction that applies
a least-squares adjustment. If the subpixel extraction and/or
the maximum object deformation is specified separately for each
component, for each component in ComponentModelIDComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelID exactly
one value for the subpixel extraction must be passed in
SubPixelCompSubPixelCompSubPixelCompSubPixelCompSubPixelCompsubPixelComp. After each value for the subpixel extraction
optionally a second value can be passed, which describes the maximum
object deformation of the corresponding mode. If for a certain
component no value for the maximum object deformation is passed, the
component is searched without taking deformations into
account. Further details can be found in the documentation of
find_shape_modelsfind_shape_modelsFindShapeModelsfind_shape_modelsFindShapeModelsFindShapeModels.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Input image in which the component model should be
found.
Handle of the component model.
Index of the root component.
Suggested values: 0, 1, 2, 3, 4, 5, 6, 7, 8
Smallest rotation of the root component
Default value: -0.39
Suggested values: -3.14, -1.57, -0.78, -0.39, -0.20, 0.0
Extent of the rotation of the root component.
Default value: 0.79
Suggested values: 6.28, 3.14, 1.57, 0.78, 0.39, 0.0
Restriction: AngleExtentRoot >= 0
Minimum score of the instances of the component
model 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 <= MinScore && MinScore <= 1
Number of instances of the component model to be
found (or 0 for all matches).
Default value: 1
Suggested values: 0, 1, 2, 3, 4, 5, 10, 20
Maximum overlap of the instances of the
component models to be found.
Default value: 0.5
Suggested values: 0.0, 0.1, 0.2, 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 <= MaxOverlap && MaxOverlap <= 1
Behavior if the root component is missing.
Default value:
'stop_search'
"stop_search"
"stop_search"
"stop_search"
"stop_search"
"stop_search"
List of values: 'select_new_root'"select_new_root""select_new_root""select_new_root""select_new_root""select_new_root", 'stop_search'"stop_search""stop_search""stop_search""stop_search""stop_search"
Behavior if a component is missing.
Default value:
'prune_branch'
"prune_branch"
"prune_branch"
"prune_branch"
"prune_branch"
"prune_branch"
List of values: 'prune_branch'"prune_branch""prune_branch""prune_branch""prune_branch""prune_branch", 'search_from_best'"search_from_best""search_from_best""search_from_best""search_from_best""search_from_best", 'search_from_upper'"search_from_upper""search_from_upper""search_from_upper""search_from_upper""search_from_upper"
Pose prediction of components that are not found.
Default value:
'none'
"none"
"none"
"none"
"none"
"none"
List of values: 'from_all'"from_all""from_all""from_all""from_all""from_all", 'from_neighbors'"from_neighbors""from_neighbors""from_neighbors""from_neighbors""from_neighbors", 'none'"none""none""none""none""none"
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
Subpixel accuracy of the component poses if not
equal to 'none'"none""none""none""none""none".
Default value:
'least_squares'
"least_squares"
"least_squares"
"least_squares"
"least_squares"
"least_squares"
List of values: 'interpolation'"interpolation""interpolation""interpolation""interpolation""interpolation", 'least_squares'"least_squares""least_squares""least_squares""least_squares""least_squares", 'least_squares_high'"least_squares_high""least_squares_high""least_squares_high""least_squares_high""least_squares_high", 'least_squares_very_high'"least_squares_very_high""least_squares_very_high""least_squares_very_high""least_squares_very_high""least_squares_very_high", 'max_deformation 1'"max_deformation 1""max_deformation 1""max_deformation 1""max_deformation 1""max_deformation 1", 'max_deformation 2'"max_deformation 2""max_deformation 2""max_deformation 2""max_deformation 2""max_deformation 2", 'max_deformation 3'"max_deformation 3""max_deformation 3""max_deformation 3""max_deformation 3""max_deformation 3", 'max_deformation 4'"max_deformation 4""max_deformation 4""max_deformation 4""max_deformation 4""max_deformation 4", 'max_deformation 5'"max_deformation 5""max_deformation 5""max_deformation 5""max_deformation 5""max_deformation 5", 'max_deformation 6'"max_deformation 6""max_deformation 6""max_deformation 6""max_deformation 6""max_deformation 6", 'none'"none""none""none""none""none"
Number of pyramid levels for the components used in
the matching
(and lowest pyramid level to use if
|NumLevelsCompNumLevelsCompNumLevelsCompNumLevelsCompNumLevelsCompnumLevelsComp| = 2n).
Default value: 0
List of values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
“Greediness” of the search heuristic for the
components (0: safe
but slow; 1: fast but matches may be missed).
Default value: 0.9
Suggested values: 0.0, 0.1, 0.2, 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 <= GreedinessComp && GreedinessComp <= 1
Start index of each found instance of the component
model in the tuples describing the component matches.
End index of each found instance of the component
model in the tuples describing the component matches.
Score of the found instances of the component model.
Row coordinate of the found component matches.
Column coordinate of the found component matches.
Rotation angle of the found component matches.
Score of the found component matches.
Index of the found components.
If the parameter values are correct, the operator
find_component_modelfind_component_modelFindComponentModelfind_component_modelFindComponentModelFindComponentModel returns the value 2 (H_MSG_TRUE). If the input
is empty (no input image available) the behavior can be set via
set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an
exception is raised.
create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModel,
create_component_modelcreate_component_modelCreateComponentModelcreate_component_modelCreateComponentModelCreateComponentModel,
read_component_modelread_component_modelReadComponentModelread_component_modelReadComponentModelReadComponentModel
get_found_component_modelget_found_component_modelGetFoundComponentModelget_found_component_modelGetFoundComponentModelGetFoundComponentModel
find_shape_modelsfind_shape_modelsFindShapeModelsfind_shape_modelsFindShapeModelsFindShapeModels
find_shape_modelfind_shape_modelFindShapeModelfind_shape_modelFindShapeModelFindShapeModel,
find_shape_modelsfind_shape_modelsFindShapeModelsfind_shape_modelsFindShapeModelsFindShapeModels,
get_shape_model_paramsget_shape_model_paramsGetShapeModelParamsget_shape_model_paramsGetShapeModelParamsGetShapeModelParams,
get_component_model_paramsget_component_model_paramsGetComponentModelParamsget_component_model_paramsGetComponentModelParamsGetComponentModelParams,
train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents,
set_shape_model_originset_shape_model_originSetShapeModelOriginset_shape_model_originSetShapeModelOriginSetShapeModelOrigin,
smallest_rectangle2smallest_rectangle2SmallestRectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2
Matching