Name
get_stereo_model_paramT_get_stereo_model_paramGetStereoModelParamGetStereoModelParam — Get stereo model parameters.
The operator get_stereo_model_paramget_stereo_model_paramGetStereoModelParamGetStereoModelParamGetStereoModelParam can be used to inspect diverse
parameters of the stereo model StereoModelIDStereoModelIDStereoModelIDStereoModelIDstereoModelID by specifying
their names in GenParamNameGenParamNameGenParamNameGenParamNamegenParamName and getting their values in
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue.
Two types of parameters can be inspected with this operator - general and
specific for surface reconstruction. Note that no specific parameters are
provided for 3D point stereo reconstruction.
All parameters that can be set with set_stereo_model_paramset_stereo_model_paramSetStereoModelParamSetStereoModelParamSetStereoModelParam
can also be queried with get_stereo_model_paramget_stereo_model_paramGetStereoModelParamGetStereoModelParamGetStereoModelParam - for a
description see the former operator. In contrast, the following
parameters are set by other operators and cannot be modified
afterwards.
General parameters
- 'type'"type""type""type""type":
Type of the stereo model (currently either
'surface_pairwise'"surface_pairwise""surface_pairwise""surface_pairwise""surface_pairwise", 'surface_fusion'"surface_fusion""surface_fusion""surface_fusion""surface_fusion"
or 'points_3d'"points_3d""points_3d""points_3d""points_3d").
- 'camera_setup_model'"camera_setup_model""camera_setup_model""camera_setup_model""camera_setup_model":
Handle to a copy of the camera setup model set in the
stereo model.
Changing properties of the copy does not affect the camera setup model
stored in the stereo model. Once the copy is not needed anymore,
you must release its memory with clear_camera_setup_modelclear_camera_setup_modelClearCameraSetupModelClearCameraSetupModelClearCameraSetupModel.
These parameters are set when creating the stereo model with
create_stereo_modelcreate_stereo_modelCreateStereoModelCreateStereoModelCreateStereoModel.
Surface reconstruction parameters
- 'min_disparity'"min_disparity""min_disparity""min_disparity""min_disparity",'max_disparity'"max_disparity""max_disparity""max_disparity""max_disparity":
Tuple of minimum or maximum disparity settings,
respectively, for each image pair. This settings are computed
internally from the bounding box specified for the stereo model
(see set_stereo_model_paramset_stereo_model_paramSetStereoModelParamSetStereoModelParamSetStereoModelParam) and
are then used as the parameters MinDisparity and
MaxDisparity, respectively, in the internal call to
binocular_disparitybinocular_disparityBinocularDisparityBinocularDisparityBinocularDisparity or binocular_disparity_msbinocular_disparity_msBinocularDisparityMsBinocularDisparityMsBinocularDisparityMs for the
corresponding image pair. The
indices of the image pairs can be queried by
get_stereo_model_image_pairsget_stereo_model_image_pairsGetStereoModelImagePairsGetStereoModelImagePairsGetStereoModelImagePairs.
Note that this information is only
available if the 'persistence'"persistence""persistence""persistence""persistence" mode was switched on
during surface reconstruction (see reconstruct_surface_stereoreconstruct_surface_stereoReconstructSurfaceStereoReconstructSurfaceStereoReconstructSurfaceStereo).
Note furthermore that the returned values are tuple-valued and cannot
be queried together with other parameters (more on this in the
the paragraph "A note on tuple-valued model parameters" below).
A note on tuple-valued model parameters
Most of the stereo model parameters are single-valued. Thus,
you can provide a list (i.e., tuple) of parameter names and get a
list (tuple) of values that has the same length as the output tuple.
In contrast, when querying a tuple-valued parameter, a tuple
of values is returned. When querying such a parameter together with
other parameters, the value-to-parameter-name correspondence is not
obvious anymore. Thus, tuple-valued parameters like
'min_disparity'"min_disparity""min_disparity""min_disparity""min_disparity" or and 'max_disparity'"max_disparity""max_disparity""max_disparity""max_disparity" should
always be queried in a separate call to
get_stereo_model_paramget_stereo_model_paramGetStereoModelParamGetStereoModelParamGetStereoModelParam.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Handle of the stereo model.
Names of the parameters to be set.
List of values: 'binocular_filter'"binocular_filter""binocular_filter""binocular_filter""binocular_filter", 'binocular_mask_height'"binocular_mask_height""binocular_mask_height""binocular_mask_height""binocular_mask_height", 'binocular_mask_width'"binocular_mask_width""binocular_mask_width""binocular_mask_width""binocular_mask_width", 'binocular_method'"binocular_method""binocular_method""binocular_method""binocular_method", 'binocular_mg_cycle_type'"binocular_mg_cycle_type""binocular_mg_cycle_type""binocular_mg_cycle_type""binocular_mg_cycle_type", 'binocular_mg_gradient_constancy'"binocular_mg_gradient_constancy""binocular_mg_gradient_constancy""binocular_mg_gradient_constancy""binocular_mg_gradient_constancy", 'binocular_mg_gray_constancy'"binocular_mg_gray_constancy""binocular_mg_gray_constancy""binocular_mg_gray_constancy""binocular_mg_gray_constancy", 'binocular_mg_initial_guess'"binocular_mg_initial_guess""binocular_mg_initial_guess""binocular_mg_initial_guess""binocular_mg_initial_guess", 'binocular_mg_initial_level'"binocular_mg_initial_level""binocular_mg_initial_level""binocular_mg_initial_level""binocular_mg_initial_level", 'binocular_mg_iterations'"binocular_mg_iterations""binocular_mg_iterations""binocular_mg_iterations""binocular_mg_iterations", 'binocular_mg_post_relax'"binocular_mg_post_relax""binocular_mg_post_relax""binocular_mg_post_relax""binocular_mg_post_relax", 'binocular_mg_pre_relax'"binocular_mg_pre_relax""binocular_mg_pre_relax""binocular_mg_pre_relax""binocular_mg_pre_relax", 'binocular_mg_pyramid_factor'"binocular_mg_pyramid_factor""binocular_mg_pyramid_factor""binocular_mg_pyramid_factor""binocular_mg_pyramid_factor", 'binocular_mg_smoothness'"binocular_mg_smoothness""binocular_mg_smoothness""binocular_mg_smoothness""binocular_mg_smoothness", 'binocular_mg_solver'"binocular_mg_solver""binocular_mg_solver""binocular_mg_solver""binocular_mg_solver", 'binocular_ms_consistency_check'"binocular_ms_consistency_check""binocular_ms_consistency_check""binocular_ms_consistency_check""binocular_ms_consistency_check", 'binocular_ms_edge_smoothing'"binocular_ms_edge_smoothing""binocular_ms_edge_smoothing""binocular_ms_edge_smoothing""binocular_ms_edge_smoothing", 'binocular_ms_similarity_measure'"binocular_ms_similarity_measure""binocular_ms_similarity_measure""binocular_ms_similarity_measure""binocular_ms_similarity_measure", 'binocular_ms_sub_disparity'"binocular_ms_sub_disparity""binocular_ms_sub_disparity""binocular_ms_sub_disparity""binocular_ms_sub_disparity", 'binocular_ms_surface_smoothing'"binocular_ms_surface_smoothing""binocular_ms_surface_smoothing""binocular_ms_surface_smoothing""binocular_ms_surface_smoothing", 'binocular_num_levels'"binocular_num_levels""binocular_num_levels""binocular_num_levels""binocular_num_levels", 'binocular_score_thresh'"binocular_score_thresh""binocular_score_thresh""binocular_score_thresh""binocular_score_thresh", 'binocular_sub_disparity'"binocular_sub_disparity""binocular_sub_disparity""binocular_sub_disparity""binocular_sub_disparity", 'binocular_texture_thresh'"binocular_texture_thresh""binocular_texture_thresh""binocular_texture_thresh""binocular_texture_thresh", 'bounding_box'"bounding_box""bounding_box""bounding_box""bounding_box", 'camera_setup_model'"camera_setup_model""camera_setup_model""camera_setup_model""camera_setup_model", 'color'"color""color""color""color", 'color_invisible'"color_invisible""color_invisible""color_invisible""color_invisible", 'disparity_method'"disparity_method""disparity_method""disparity_method""disparity_method", 'max_disparity'"max_disparity""max_disparity""max_disparity""max_disparity", 'min_disparity'"min_disparity""min_disparity""min_disparity""min_disparity", 'min_thickness'"min_thickness""min_thickness""min_thickness""min_thickness", 'persistence'"persistence""persistence""persistence""persistence", 'point_meshing'"point_meshing""point_meshing""point_meshing""point_meshing", 'poisson_depth'"poisson_depth""poisson_depth""poisson_depth""poisson_depth", 'poisson_samples_per_node'"poisson_samples_per_node""poisson_samples_per_node""poisson_samples_per_node""poisson_samples_per_node", 'poisson_solver_divide'"poisson_solver_divide""poisson_solver_divide""poisson_solver_divide""poisson_solver_divide", 'rectif_interpolation'"rectif_interpolation""rectif_interpolation""rectif_interpolation""rectif_interpolation", 'rectif_sub_sampling'"rectif_sub_sampling""rectif_sub_sampling""rectif_sub_sampling""rectif_sub_sampling", 'resolution'"resolution""resolution""resolution""resolution", 'smoothing'"smoothing""smoothing""smoothing""smoothing", 'sub_sampling_step'"sub_sampling_step""sub_sampling_step""sub_sampling_step""sub_sampling_step", 'surface_tolerance'"surface_tolerance""surface_tolerance""surface_tolerance""surface_tolerance", 'type'"type""type""type""type"
Values of the parameters to be set.
create_stereo_modelcreate_stereo_modelCreateStereoModelCreateStereoModelCreateStereoModel,
set_stereo_model_paramset_stereo_model_paramSetStereoModelParamSetStereoModelParamSetStereoModelParam
reconstruct_surface_stereoreconstruct_surface_stereoReconstructSurfaceStereoReconstructSurfaceStereoReconstructSurfaceStereo,
reconstruct_points_stereoreconstruct_points_stereoReconstructPointsStereoReconstructPointsStereoReconstructPointsStereo
set_stereo_model_paramset_stereo_model_paramSetStereoModelParamSetStereoModelParamSetStereoModelParam
3D Metrology