AngleRange Property

Applies To
Vision Objects: Correlation, Geometric

Description
Specifies the rotation detection range.

Usage

VGet  Sequence.Object.AngleRange, var
VSet  Sequence.Object.AngleRange, 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

• Correlation:
  • Real number in degrees from 0 to 180 for PC Vision cameras
  • Real number in degrees from 0 to 45 for Compact Vision cameras
  • Default: 10
• Geometric:
  • Real number in degrees from 0 to 180 for all cameras.
  • Default: 180

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 property prior to teaching the new Model as well. If you teach a Correlation Model, then later set the AngleRange property to a new value, and then try to run that Correlation object, it will not search with the new angle range.

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

The AngleRange property must be set before teaching the model. This value specifies the range within which to train a series of rotated models. For example, if the AngleRange property is set to 5, then when the model is trained, a set of models is actually trained within +/- 5 degrees of the current model position. These models are then used when a correlation search with angle is specified.

It should be noted that using correlation with angle will generally cause the correlation time to increase significantly. This is why correlation with angle is normally used for small angle increments 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 in the Vision Guide Manual for more information.)

Specify a small value for the setting. If the value is large, the detection time gets longer and may result in false detection.

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