HALCON Operator reference

HALCON Operator Reference / Matching / Shape-Based
ClassesClasses | | Operators

get_generic_shape_model_result_objectT_get_generic_shape_model_result_objectGetGenericShapeModelResultObjectGetGenericShapeModelResultObjectget_generic_shape_model_result_object (Operator)

get_generic_shape_model_result_objectT_get_generic_shape_model_result_objectGetGenericShapeModelResultObjectGetGenericShapeModelResultObjectget_generic_shape_model_result_object — Get objects from a shape matching result.

Signature

get_generic_shape_model_result_object( : Objects : MatchResultID, MatchSelector, GenParamName : )

Herror T_get_generic_shape_model_result_object(Hobject* Objects, const Htuple MatchResultID, const Htuple MatchSelector, const Htuple GenParamName)

void GetGenericShapeModelResultObject(HObject* Objects, const HTuple& MatchResultID, const HTuple& MatchSelector, const HTuple& GenParamName)

HObject HGenericShapeModelResult::GetGenericShapeModelResultObject(const HTuple& MatchSelector, const HTuple& GenParamName) const

HObject HGenericShapeModelResult::GetGenericShapeModelResultObject(const HTuple& MatchSelector, const HString& GenParamName) const

HObject HGenericShapeModelResult::GetGenericShapeModelResultObject(const HTuple& MatchSelector, const char* GenParamName) const

HObject HGenericShapeModelResult::GetGenericShapeModelResultObject(const HTuple& MatchSelector, const wchar_t* GenParamName) const   ( Windows only)

static void HOperatorSet.GetGenericShapeModelResultObject(out HObject objects, HTuple matchResultID, HTuple matchSelector, HTuple genParamName)

HObject HGenericShapeModelResult.GetGenericShapeModelResultObject(HTuple matchSelector, HTuple genParamName)

HObject HGenericShapeModelResult.GetGenericShapeModelResultObject(HTuple matchSelector, string genParamName)

def get_generic_shape_model_result_object(match_result_id: HHandle, match_selector: Sequence[Union[str, int]], gen_param_name: Union[str, HHandle]) -> HObject

Description

get_generic_shape_model_result_objectget_generic_shape_model_result_objectGetGenericShapeModelResultObjectGetGenericShapeModelResultObjectget_generic_shape_model_result_object returns iconic results of shape-based matching in ObjectsObjectsObjectsobjectsobjects. The results are contained in MatchResultIDMatchResultIDMatchResultIDmatchResultIDmatch_result_id.

The parameter MatchSelectorMatchSelectorMatchSelectormatchSelectormatch_selector is used to select from which matches the result values shall be returned. For more information and the list of supported values for MatchSelectorMatchSelectorMatchSelectormatchSelectormatch_selector see get_generic_shape_model_resultget_generic_shape_model_resultGetGenericShapeModelResultGetGenericShapeModelResultget_generic_shape_model_result.

GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name specifies which object result value will be returned. The following values are possible:

'contours'"contours""contours""contours""contours":

Model contours transformed according to the matching result.

Attention: Model contours are only available if the search was conducted with 'prepare_contours_for_visualization'"prepare_contours_for_visualization""prepare_contours_for_visualization""prepare_contours_for_visualization""prepare_contours_for_visualization" set to 'true'"true""true""true""true".

'clutter_region'"clutter_region""clutter_region""clutter_region""clutter_region":

Region where no clutter should occur.

Attention: The clutter region is only available if a clutter region was added to the model and the search was conducted with 'prepare_clutter_region_for_visualization'"prepare_clutter_region_for_visualization""prepare_clutter_region_for_visualization""prepare_clutter_region_for_visualization""prepare_clutter_region_for_visualization" set to 'true'"true""true""true""true".

A dictionary:

Parameters which require additional information to get an iconic result are passed as a dictionary with the key 'param_name' with additional key/value pairs depending on the queried 'param_name'. Unknown keys are ignored. The following parameters can be queried:

  • score_visualization_contours: Parts of model contours where the model point score contributions are within the given interval. The contours are transformed according to the corresponding match. The following additional keys are required to get score_visualization_contours:

    • low: Low threshold of the interval. Model contours with score contributions greater or equal low are returned. low is either a real valued number in the range [-1.0, 1.0] or the string 'min'"min""min""min""min" as the lowest possible value.

    • high: High threshold of the interval. Model contours with score contributions smaller than high are returned. high is either a real valued number in the range [-1.0, 1.0] or the string 'max'"max""max""max""max" as the highest possible value. Note that for 1.0 and 'max'"max""max""max""max" the threshold is treated inclusively, i.e. contour parts with score contributions smaller than and equal to 1.0 and 'max'"max""max""max""max" are returned.

    The score contributions are calculated in find_generic_shape_modelfind_generic_shape_modelFindGenericShapeModelFindGenericShapeModelfind_generic_shape_model for each model point. All contour parts, for which the median of their surrounding score contributions is higher or equal 'low' and less than 'high', are returned.

    Details about the selection

    • 16 score contributions are considered for the median.

    • For contours with less than 16 score contributions, the median of all score contributions is evaluated once and compared to the thresholds.

    • For longer closed contours, the window in which score contributions are taken into account continues over the start and end point of closed contours.

    • For longer open contours, the first or last score contribution is repeated at the start or end respectively.

    Note that depending on 'metric'"metric""metric""metric""metric" used in each model during find_generic_shape_modelfind_generic_shape_modelFindGenericShapeModelFindGenericShapeModelfind_generic_shape_model the range of score contributions is different.

    Attention: The score contributions are only available if the search was conducted with 'score_visualization'"score_visualization""score_visualization""score_visualization""score_visualization" set to 'true'"true""true""true""true".

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Processed without parallelization.

Parameters

ObjectsObjectsObjectsobjectsobjects (output_object)  (multichannel-)object(-array) → objectHObjectHObjectHObjectHobject *

Objects of the queried result.

MatchResultIDMatchResultIDMatchResultIDmatchResultIDmatch_result_id (input_control)  generic_shape_model_result → HGenericShapeModelResult, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the shape model matches.

MatchSelectorMatchSelectorMatchSelectormatchSelectormatch_selector (input_control)  string-array → HTupleSequence[Union[str, int]]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)

Selector for the matching results to be queried.

Default: 'all' "all" "all" "all" "all"

List of values: 'all'"all""all""all""all", 'best'"best""best""best""best"

GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control)  attribute.name → HTupleUnion[str, HHandle]HTupleHtuple (string / handle) (string / HHandle) (HString / HHandle) (char* / handle)

Name of the queried result object.

Default: 'contours' "contours" "contours" "contours" "contours"

List of values: 'clutter_region'"clutter_region""clutter_region""clutter_region""clutter_region", 'contours'"contours""contours""contours""contours"

Example (HDevelop)

* Get score visualization contours by passing a dictionary for GenParamName.
GenParamName := dict{param_name: 'score_visualization_contours'}
GenParamName.low := 0.25
GenParamName.high := 'max'
get_generic_shape_model_result_object (ScoreVisContour, MatchResultID, \
                                      'all', GenParamName)

Result

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

Possible Predecessors

find_generic_shape_modelfind_generic_shape_modelFindGenericShapeModelFindGenericShapeModelfind_generic_shape_model

Module

Matching

ClassesClasses | | Operators