Skip to content

get_texture_inspection_result_objectget_texture_inspection_result_objectGetTextureInspectionResultObjectGetTextureInspectionResultObjectget_texture_inspection_result_objectT_get_texture_inspection_result_object🔗

Short description🔗

get_texture_inspection_result_objectget_texture_inspection_result_objectGetTextureInspectionResultObjectGetTextureInspectionResultObjectget_texture_inspection_result_objectT_get_texture_inspection_result_object — Query iconic results of a texture inspection.

Signature🔗

get_texture_inspection_result_object( out object Object, texture_inspection_result TextureInspectionResultID, string ResultName )get_texture_inspection_result_object( : Object : TextureInspectionResultID, ResultName : )void GetTextureInspectionResultObject( HObject* Object, const HTuple& TextureInspectionResultID, const HTuple& ResultName )static void HOperatorSet.GetTextureInspectionResultObject( out HObject objectVal, HTuple textureInspectionResultID, HTuple resultName )def get_texture_inspection_result_object( texture_inspection_result_id: HHandle, result_name: MaybeSequence[Union[str, int]] ) -> HObject

Herror T_get_texture_inspection_result_object( 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)

HObject HTextureInspectionResult.GetTextureInspectionResultObject( HTuple resultName )

HObject HTextureInspectionResult.GetTextureInspectionResultObject( string resultName )

Description🔗

get_texture_inspection_result_objectGetTextureInspectionResultObject queries the iconic result ResultNameresultNameresult_name of the handle TextureInspectionResultIDtextureInspectionResultIDtexture_inspection_result_id returned by apply_texture_inspection_modelApplyTextureInspectionModel. The result handle TextureInspectionResultIDtextureInspectionResultIDtexture_inspection_result_id was only created when 'gen_result_handle'"gen_result_handle" was set to 'true'"true" with set_texture_inspection_model_paramSetTextureInspectionModelParam.

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

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

  • '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". Please note that if a tuple of images was passed to apply_texture_inspection_modelApplyTextureInspectionModel, it is only possible to query the novelty regions for the first image within the tuple.

  • '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". Please note that if a tuple of images was passed to apply_texture_inspection_modelApplyTextureInspectionModel, it is only possible to query the novelty score images for the first image within the tuple.

Execution information🔗

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🔗

ObjectobjectValobject (output_object) object(-array) → objectobjectHObjectHObjectHObjectHobject *

Returned iconic object.

TextureInspectionResultIDtextureInspectionResultIDtexture_inspection_result_id (input_control) texture_inspection_result → (handle)(handle)HTuple (HHandle)HTextureInspectionResult, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the texture inspection result.

ResultNameresultNameresult_name (input_control) string(-array) → (string / integer)(string / integer)HTuple (HString / Hlong)HTuple (string / int / long)MaybeSequence[Union[str, int]]Htuple (char* / Hlong)

Name of the iconic object to be returned.

Default: 'novelty_region'"novelty_region"
List of values: 'novelty_region', 'novelty_score_image'"novelty_region", "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_objectGetTextureInspectionResultObject returns the value 2 (H_MSG_TRUE) if the given parameters are valid and within acceptable range. Otherwise, an exception will be raised.

Combinations with other operators🔗

Combinations

Possible predecessors

apply_texture_inspection_modelApplyTextureInspectionModel

Possible successors

clear_texture_inspection_resultClearTextureInspectionResult, clear_texture_inspection_modelClearTextureInspectionModel

Module🔗

Matching