AngleMaxIncrement Property

Applies To
Vision Objects: Correlation

Description
The AngleMaxIncrement property specifies the maximum angle increment amount for teaching a correlation model for searching with angle. When teaching a model, the system selects the angle increment amount automatically. By setting the AngleMaxIncrement property, the system compares the automatically-selected angle increment amount and the setting value. Then, the smaller amount will be used.

Usage

VGet  Sequence.Object.AngleMaxIncrement, var
VSet  Sequence.Object.AngleMaxIncrement, value

Sequence

Name of a sequence or string variable containing a sequence name.

Object

Name of an object or string variable containing an object name. The object must exist in the specified sequence.

var

Real variable that will contain the value of the property.

value

Real number or expression for the new value of the property.

Value
Real number in degrees from 1 to 10°

Default: 5

Remarks

The Correlation Model must be taught after the AngleEnable property is set to "True". You must also have the proper settings for the AngleMaxIncrement and AngleRange Properties prior to teaching the new Model as well.

If you try to find the Correlation objects by changing the AngleMaxIncrement property to a new value after teaching a Correlation Model, it will not search with the new angle increment. You must re-teach the Correlation Model when you change the AngleMaxIncrement property.

If you wish to measure angle precisely, you should provide a maximum angle increment corresponding to the degree of precision you desire. You should keep in mind, however, that the smaller the angle increment, the more storage will be required for the model and the slower the search time will be.

It should be noted that while correlation with angle is normally able to find rotated parts, the correlation search time usually increase significantly. This is why correlation with angle is most useful for finding parts which rotate slightly. On the other hand, Geometric search is suitable for a pattern search which includes large rotation detection. If it is predictable that the parts have a large rotation angle, consider to use Geometric search.

Also, the Polar object is normally very fast and can be used in conjunction with a Correlation object for a powerful and fast combination. (See the sections on Correlation or Polar Searching for more information.)

See Also
Angle Result, AngleEnable Property, AngleRange Property, Correlation Object, Geometric Object