Operator Reference

HALCON Operator Reference / Inspection / Texture Inspection
ClassesClasses | | Operators

get_texture_inspection_result_objectT_get_texture_inspection_result_objectGetTextureInspectionResultObjectGetTextureInspectionResultObjectget_texture_inspection_result_object (Operator)

get_texture_inspection_result_objectT_get_texture_inspection_result_objectGetTextureInspectionResultObjectGetTextureInspectionResultObjectget_texture_inspection_result_object — Query iconic results of a texture inspection.

Signature

get_texture_inspection_result_object( : Object : TextureInspectionResultID, ResultName : )

Herror T_get_texture_inspection_result_object(Hobject* Object, const Htuple TextureInspectionResultID, const Htuple ResultName)

void GetTextureInspectionResultObject(HObject* Object, const HTuple& TextureInspectionResultID, const HTuple& ResultName)

HObject HTextureInspectionResult::GetTextureInspectionResultObject(const HTuple& ResultName) const

HObject HTextureInspectionResult::GetTextureInspectionResultObject(const HString& ResultName) const

HObject HTextureInspectionResult::GetTextureInspectionResultObject(const char* ResultName) const

HObject HTextureInspectionResult::GetTextureInspectionResultObject(const wchar_t* ResultName) const   ( Windows only)

static void HOperatorSet.GetTextureInspectionResultObject(out HObject objectVal, HTuple textureInspectionResultID, HTuple resultName)

HObject HTextureInspectionResult.GetTextureInspectionResultObject(HTuple resultName)

HObject HTextureInspectionResult.GetTextureInspectionResultObject(string resultName)

def get_texture_inspection_result_object(texture_inspection_result_id: HHandle, result_name: MaybeSequence[Union[str, int]]) -> HObject

Description

get_texture_inspection_result_objectget_texture_inspection_result_objectGetTextureInspectionResultObjectGetTextureInspectionResultObjectget_texture_inspection_result_object queries the iconic result ResultNameResultNameResultNameresultNameresult_name of the handle TextureInspectionResultIDTextureInspectionResultIDTextureInspectionResultIDtextureInspectionResultIDtexture_inspection_result_id returned by apply_texture_inspection_modelapply_texture_inspection_modelApplyTextureInspectionModelApplyTextureInspectionModelapply_texture_inspection_model. The result handle TextureInspectionResultIDTextureInspectionResultIDTextureInspectionResultIDtextureInspectionResultIDtexture_inspection_result_id was only created when 'gen_result_handle'"gen_result_handle""gen_result_handle""gen_result_handle""gen_result_handle" was set to 'true'"true""true""true""true" with set_texture_inspection_model_paramset_texture_inspection_model_paramSetTextureInspectionModelParamSetTextureInspectionModelParamset_texture_inspection_model_param.

For an explanation of the concept of the texture inspection see the introduction of chapter Inspection / Texture Inspection.

In the following the possible parameter values for ResultNameResultNameResultNameresultNameresult_name are listed:

'novelty_region'"novelty_region""novelty_region""novelty_region""novelty_region":

Returns the novelty regions of all pyramid levels in an object tuple. To query the novelty regions of single pyramid levels the corresponding index has to be added, e.g., 'novelty_region_1'"novelty_region_1""novelty_region_1""novelty_region_1""novelty_region_1". Please note that if a tuple of images was passed to apply_texture_inspection_modelapply_texture_inspection_modelApplyTextureInspectionModelApplyTextureInspectionModelapply_texture_inspection_model, it is only possible to query the novelty regions for the first image within the tuple.

'novelty_score_image'"novelty_score_image""novelty_score_image""novelty_score_image""novelty_score_image":

Returns the novelty score images of all pyramid levels in an object tuple. To query the novelty regions of single pyramid levels the corresponding index has to be added, e.g., 'novelty_score_image_1'"novelty_score_image_1""novelty_score_image_1""novelty_score_image_1""novelty_score_image_1". Please note that if a tuple of images was passed to apply_texture_inspection_modelapply_texture_inspection_modelApplyTextureInspectionModelApplyTextureInspectionModelapply_texture_inspection_model, it is only possible to query the novelty score images for the first image within the tuple.

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

ObjectObjectObjectobjectValobject (output_object)  object(-array) → objectHObjectHObjectHObjectHobject *

Returned iconic object.

TextureInspectionResultIDTextureInspectionResultIDTextureInspectionResultIDtextureInspectionResultIDtexture_inspection_result_id (input_control)  texture_inspection_result → HTextureInspectionResult, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the texture inspection result.

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

Name of the iconic object to be returned.

Default: 'novelty_region' "novelty_region" "novelty_region" "novelty_region" "novelty_region"

List of values: 'novelty_region'"novelty_region""novelty_region""novelty_region""novelty_region", 'novelty_score_image'"novelty_score_image""novelty_score_image""novelty_score_image""novelty_score_image"

Example (HDevelop)

* Create texture inspection model
create_texture_inspection_model ('basic', TextureInspectionModel)
* Set parameters
set_texture_inspection_model_param (TextureInspectionModel, \
                                    'gen_result_handle', 'true')
* Make this short example fast:
set_texture_inspection_model_param (TextureInspectionModel, \
                                    'gmm_em_max_iter', 1)
* Read and add training images
read_image (TrainImage, 'carpet/carpet_01')
add_texture_inspection_model_image (TrainImage, TextureInspectionModel, \
                                    Indices)
* Train the model
train_texture_inspection_model (TextureInspectionModel)
* Read and apply a test image
read_image (TestImage, 'carpet/carpet_02')
apply_texture_inspection_model (TestImage, DefectCandidates, \
                                TextureInspectionModel, \
                                TextureInspectionResultID)
* Get result objects
get_texture_inspection_result_object (Object, TextureInspectionResultID, \
                                      'novelty_score_image')

Result

The operator get_texture_inspection_result_objectget_texture_inspection_result_objectGetTextureInspectionResultObjectGetTextureInspectionResultObjectget_texture_inspection_result_object returns the value 2 ( H_MSG_TRUE) if the given parameters are valid and within acceptable range. Otherwise, an exception will be raised.

Possible Predecessors

apply_texture_inspection_modelapply_texture_inspection_modelApplyTextureInspectionModelApplyTextureInspectionModelapply_texture_inspection_model

Possible Successors

clear_texture_inspection_resultclear_texture_inspection_resultClearTextureInspectionResultClearTextureInspectionResultclear_texture_inspection_result, clear_texture_inspection_modelclear_texture_inspection_modelClearTextureInspectionModelClearTextureInspectionModelclear_texture_inspection_model

Module

Matching

ClassesClasses | | Operators