Create the representation of a shape model.

inspect_shape_model creates a representation of a shape model. The operator is particularly useful in order to determine the parameters NumLevels and Contrast, which are used in create_shape_model, quickly and conveniently. The representation of the model is created on multiple image pyramid levels, where the number of levels is determined by NumLevels. In contrast to create_shape_model, the model is only created for the rotation of the object in the input image, i.e., 0°. As output, inspect_shape_model creates an image object ModelImages containing the images of the individual levels of the image pyramid as well as a region in ModelRegions for each pyramid level that represents the model at the respective pyramid level. The individual objects can be accessed with select_obj. As described for create_shape_model, the number of pyramid levels should be chosen as large as possible, while taking into account that the model must be recognizable on the highest pyramid level and must have enough model points. The parameter Contrast should be chosen such that only the significant features of the template object are used for the model. Contrast can also contain a tuple with two values. In this case, the model is segmented using a method similar to the hysteresis threshold method used in edges_image. Here, the first element of the tuple determines the lower threshold, while the second element determines the upper threshold. For more information about the hysteresis threshold method, see hysteresis_threshold. Optionally, Contrast can contain a third value as the last element of the tuple. This value determines a threshold for the selection of significant model components based on the size of the components, i.e., components that have fewer points than the minimum size thus specified are suppressed. This threshold for the minimum size is divided by two for each successive pyramid level. If small model components should be suppressed, but hysteresis thresholding should not be performed, nevertheless three values must be specified in Contrast. In this case, the first two values can simply be set to identical values. In its typical use, inspect_shape_model is called interactively multiple times with different parameters for NumLevels and Contrast, until a satisfactory model is obtained. After this, create_shape_model is called with the parameters thus obtained.

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

inspect_shape_model is reentrant and processed without parallelization.

reduce_domain

select_obj

create_shape_model

Foundation