get_shape_model_3d_contoursT_get_shape_model_3d_contoursGetShapeModel3dContoursGetShapeModel3dContours (Operator)

Name

get_shape_model_3d_contoursT_get_shape_model_3d_contoursGetShapeModel3dContoursGetShapeModel3dContours — Return the contour representation of a 3D shape model view.

Signature

Description

The operator get_shape_model_3d_contoursget_shape_model_3d_contoursGetShapeModel3dContoursGetShapeModel3dContoursGetShapeModel3dContours returns a representation of a single model view of the 3D shape model ShapeModel3DIDShapeModel3DIDShapeModel3DIDShapeModel3DIDshapeModel3DID as XLD contours in ModelContoursModelContoursModelContoursModelContoursmodelContours. The parameters LevelLevelLevelLevellevel and ViewViewViewViewview determine for which model view the contour representation should be returned, where LevelLevelLevelLevellevel denotes the pyramid level and ViewViewViewViewview denotes the model view on this pyramid level.

The permitted range of values for LevelLevelLevelLevellevel and ViewViewViewViewview can previously be determined by using the operator get_shape_model_3d_paramsget_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParamsGetShapeModel3dParams and passing 'num_views_per_level'"num_views_per_level""num_views_per_level""num_views_per_level""num_views_per_level" for GenParamNameGenParamNameGenParamNameGenParamNamegenParamName.

The contours can be used to visualize and rate the 3D shape model that was created with create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3d. With this it is possible, for example, to decide whether the number of pyramid levels in the model is appropriate or not. If the contours on the highest pyramid do not show enough details to be representative for the model view, the number of pyramid levels that are used during the search with find_shape_model_3dfind_shape_model_3dFindShapeModel3dFindShapeModel3dFindShapeModel3d should be adjusted downwards. In contrast, if the contours show too many details even on the highest pyramid level, a higher number of pyramid levels should be chosen already during the creation of the 3D shape model by using create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3d.

Additionally, the pose of the selected view is returned in ViewPoseViewPoseViewPoseViewPoseviewPose. It can be used, for example, to project the 3D shape model according to the view pose by using project_shape_model_3dproject_shape_model_3dProjectShapeModel3dProjectShapeModel3dProjectShapeModel3d. The rating of the model contours that was described above can then be performed by comparing the ModelContoursModelContoursModelContoursModelContoursmodelContours to the projected model. Note that the position of the contours of the projection and the position of the model contours may slightly differ because of radial distortions.

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

Result

If the parameters are valid, the operator get_shape_model_3d_contoursget_shape_model_3d_contoursGetShapeModel3dContoursGetShapeModel3dContoursGetShapeModel3dContours returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Predecessors

create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3d, read_shape_model_3dread_shape_model_3dReadShapeModel3dReadShapeModel3dReadShapeModel3d, get_shape_model_3d_paramsget_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParamsGetShapeModel3dParams

Possible Successors

create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3d

Module

3D Metrology