get_stereo_model_objectT_get_stereo_model_objectGetStereoModelObjectGetStereoModelObjectget_stereo_model_object (Operator)

Name

get_stereo_model_objectT_get_stereo_model_objectGetStereoModelObjectGetStereoModelObjectget_stereo_model_object — Get intermediate iconic results of a stereo reconstruction.

Signature

get_stereo_model_object( : Object : StereoModelID, PairIndex, ObjectName : )

Herror T_get_stereo_model_object(Hobject* Object, const Htuple StereoModelID, const Htuple PairIndex, const Htuple ObjectName)

void GetStereoModelObject(HObject* Object, const HTuple& StereoModelID, const HTuple& PairIndex, const HTuple& ObjectName)

HObject HStereoModel::GetStereoModelObject(const HTuple& PairIndex, const HString& ObjectName) const

HObject HStereoModel::GetStereoModelObject(Hlong PairIndex, const HString& ObjectName) const

HObject HStereoModel::GetStereoModelObject(Hlong PairIndex, const char* ObjectName) const

HObject HStereoModel::GetStereoModelObject(Hlong PairIndex, const wchar_t* ObjectName) const   (Windows only)

static void HOperatorSet.GetStereoModelObject(out HObject objectVal, HTuple stereoModelID, HTuple pairIndex, HTuple objectName)

HObject HStereoModel.GetStereoModelObject(HTuple pairIndex, string objectName)

HObject HStereoModel.GetStereoModelObject(int pairIndex, string objectName)

def get_stereo_model_object(stereo_model_id: HHandle, pair_index: MaybeSequence[Union[int, str, float]], object_name: str) -> HObject

Description

With the operator get_stereo_model_objectget_stereo_model_objectGetStereoModelObjectGetStereoModelObjectGetStereoModelObjectget_stereo_model_object you can access and inspect intermediate iconic results of a surface reconstruction performed with reconstruct_surface_stereoreconstruct_surface_stereoReconstructSurfaceStereoReconstructSurfaceStereoReconstructSurfaceStereoreconstruct_surface_stereo for the stereo model StereoModelIDStereoModelIDStereoModelIDStereoModelIDstereoModelIDstereo_model_id. In particular, this is useful for troubleshooting the reconstruction process. Note that to collect the iconic results, you must enable the 'persistence'"persistence""persistence""persistence""persistence""persistence" mode for the stereo model (see set_stereo_model_paramset_stereo_model_paramSetStereoModelParamSetStereoModelParamSetStereoModelParamset_stereo_model_param) before performing the reconstruction. Iconic results are then associated with each image pair that was processed during the reconstruction (see get_stereo_model_image_pairsget_stereo_model_image_pairsGetStereoModelImagePairsGetStereoModelImagePairsGetStereoModelImagePairsget_stereo_model_image_pairs).

You select the image pair of interest by specifying the corresponding camera indices [From, To] in PairIndexPairIndexPairIndexPairIndexpairIndexpair_index. By setting one of the following values in ObjectNameObjectNameObjectNameObjectNameobjectNameobject_name, the corresponding iconic objects are then returned in ObjectObjectObjectObjectobjectValobject:

'from_image_rect'"from_image_rect""from_image_rect""from_image_rect""from_image_rect""from_image_rect", 'to_image_rect'"to_image_rect""to_image_rect""to_image_rect""to_image_rect""to_image_rect":

Rectified image corresponding to the from and to camera, respectively. Both images can be used to inspect the quality of the internal binocular stereo image rectification.

'disparity_image'"disparity_image""disparity_image""disparity_image""disparity_image""disparity_image":

Disparity image for this pair. The quality of the disparity image has a direct impact on the final surface reconstruction.

'score_image'"score_image""score_image""score_image""score_image""score_image":

Score image assigned to the disparity image for this pair.

A mismatch between the rectified images, i.e., features appearing in different rows in the two images, or errors in the disparity or the score image have direct impact on the quality of the final surface reconstruction. Therefore, we recommend to correct any detected imperfections by adjusting the stereo model parameters (see set_stereo_model_paramset_stereo_model_paramSetStereoModelParamSetStereoModelParamSetStereoModelParamset_stereo_model_param), in particular those which control the internal usage of gen_binocular_rectification_mapgen_binocular_rectification_mapGenBinocularRectificationMapGenBinocularRectificationMapGenBinocularRectificationMapgen_binocular_rectification_map and binocular_disparitybinocular_disparityBinocularDisparityBinocularDisparityBinocularDisparitybinocular_disparity (see set_stereo_model_image_pairsset_stereo_model_image_pairsSetStereoModelImagePairsSetStereoModelImagePairsSetStereoModelImagePairsset_stereo_model_image_pairs and reconstruct_surface_stereoreconstruct_surface_stereoReconstructSurfaceStereoReconstructSurfaceStereoReconstructSurfaceStereoreconstruct_surface_stereo for further details).

Execution Information

Parameters

ObjectObjectObjectObjectobjectValobject (output_object)  object(-array) objectHObjectHObjectHObjectHobject *

Iconic result.

StereoModelIDStereoModelIDStereoModelIDStereoModelIDstereoModelIDstereo_model_id (input_control)  stereo_model HStereoModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the stereo model.

PairIndexPairIndexPairIndexPairIndexpairIndexpair_index (input_control)  number(-array) HTupleMaybeSequence[Union[int, str, float]]HTupleHtuple (integer / string / real) (int / long / string / double) (Hlong / HString / double) (Hlong / char* / double)

Camera indices of the pair ([From, To]).

Suggested values: 0, 1, 2

ObjectNameObjectNameObjectNameObjectNameobjectNameobject_name (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Name of the iconic result to be returned.

Suggested values: 'from_image_rect'"from_image_rect""from_image_rect""from_image_rect""from_image_rect""from_image_rect", 'to_image_rect'"to_image_rect""to_image_rect""to_image_rect""to_image_rect""to_image_rect", 'disparity_image'"disparity_image""disparity_image""disparity_image""disparity_image""disparity_image", 'score_image'"score_image""score_image""score_image""score_image""score_image"

Possible Predecessors

reconstruct_surface_stereoreconstruct_surface_stereoReconstructSurfaceStereoReconstructSurfaceStereoReconstructSurfaceStereoreconstruct_surface_stereo

Module

3D Metrology