get_shape_model

get_shape_model_params ( : : ModelID : NumLevels, AngleStart, AngleExtent, AngleStep, ScaleMin, ScaleMax, ScaleStep, Metric, MinContrast )

Return the parameters of a shape model.

The operator get_shape_model_params returns the parameters of the shape model ModelID that were used to create it using create_shape_model or create_scaled_shape_model. In particular, this output can be used to check the parameters NumLevels, AngleStep, ScaleStep and MinContrast if they were determined automatically during the model creation with create_shape_model or create_scaled_shape_model.

Note that the parameters Optimization and Contrast that also can be determined automatically during the model creation cannot be queried by using get_shape_model_params. If their value is of interest determine_shape_model_params should be used instead.

Parameters

`ModelID` (input_control)	shape_model `->` integer
Handle of the model.

`NumLevels` (output_control)	integer `->` integer
Number of pyramid levels.

`AngleStart` (output_control)	angle.rad `->` real
Smallest rotation of the pattern.

`AngleExtent` (output_control)	angle.rad `->` real
Extent of the rotation angles.
Assertion: `AngleExtent >= 0`

`AngleStep` (output_control)	angle.rad `->` real
Step length of the angles (resolution).
Assertion: `(AngleStep >= 0) && (AngleStep <= (pi / 16))`

`ScaleMin` (output_control)	number `->` real
Minimum scale of the pattern.
Assertion: `ScaleMin > 0`

`ScaleMax` (output_control)	number `->` real
Maximum scale of the pattern.
Assertion: `ScaleMax >= ScaleMin`

`ScaleStep` (output_control)	number `->` real
Scale step length (resolution).
Assertion: `ScaleStep >= 0`

`Metric` (output_control)	string `->` string
Match metric.

`MinContrast` (output_control)	number `->` integer
Minimum contrast of the objects in the search images.

Result

If the handle of the model is valid, the operator get_shape_model_params returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Parallelization Information

get_shape_model_params is processed completely exclusively without parallelization.

Possible Predecessors

create_shape_model, create_scaled_shape_model, read_shape_model

Module

Matching