get_texture_inspection_result_objectT_get_texture_inspection_result_objectGetTextureInspectionResultObjectGetTextureInspectionResultObject (Operator)

Name

get_texture_inspection_result_objectT_get_texture_inspection_result_objectGetTextureInspectionResultObjectGetTextureInspectionResultObject — 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)

Description

get_texture_inspection_result_objectget_texture_inspection_result_objectGetTextureInspectionResultObjectGetTextureInspectionResultObjectGetTextureInspectionResultObject queries the iconic result ResultNameResultNameResultNameResultNameresultName of the handle TextureInspectionResultIDTextureInspectionResultIDTextureInspectionResultIDTextureInspectionResultIDtextureInspectionResultID returned by apply_texture_inspection_modelapply_texture_inspection_modelApplyTextureInspectionModelApplyTextureInspectionModelApplyTextureInspectionModel. The result handle TextureInspectionResultIDTextureInspectionResultIDTextureInspectionResultIDTextureInspectionResultIDtextureInspectionResultID 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_paramSetTextureInspectionModelParamSetTextureInspectionModelParamSetTextureInspectionModelParam.

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 ResultNameResultNameResultNameResultNameresultName 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_modelApplyTextureInspectionModelApplyTextureInspectionModelApplyTextureInspectionModel, 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_modelApplyTextureInspectionModelApplyTextureInspectionModelApplyTextureInspectionModel, it is only possible to query the novelty score images for the first image within the tuple.

Execution Information

Parameters

ObjectObjectObjectObjectobjectVal (output_object)  object(-array) objectHObjectHObjectHobject *

Returned iconic object.

TextureInspectionResultIDTextureInspectionResultIDTextureInspectionResultIDTextureInspectionResultIDtextureInspectionResultID (input_control)  texture_inspection_result HTextureInspectionResult, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the texture inspection result.

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

Name of the iconic object to be returned.

Default value: '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_objectGetTextureInspectionResultObjectGetTextureInspectionResultObjectGetTextureInspectionResultObject 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_modelApplyTextureInspectionModelApplyTextureInspectionModelApplyTextureInspectionModel

Possible Successors

clear_texture_inspection_resultclear_texture_inspection_resultClearTextureInspectionResultClearTextureInspectionResultClearTextureInspectionResult, clear_texture_inspection_modelclear_texture_inspection_modelClearTextureInspectionModelClearTextureInspectionModelClearTextureInspectionModel

Module

Matching