AngleRange Property
AngleRange Property
Applies To
Vision Objects: Correlation, Geometric
Description
Specifies the range within which to train a series of rotated models.
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 Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.
Values
Integer number in degrees from 0 - 180
Default: 180
Remarks
Before reading anything else about the AngleRange property it should be noted that the Correlation Model
must be taught after a new value for the AngleRange property is set in order for those settings to take affect.
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. You must re-teach the Correlation
Model with the AngleEnable property set to True, and with the new value for the AngleRange property in
order for Correlation search with angle to use the new AngleRange property value. You must also have the
proper settings for the AngleMaxIncrement property prior to teaching the new Model as well.
)
NOTE
The AngleRange property is 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 only. The
Polar object however, is normally very fast and can be used in conjunction with the 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,
Object Tab
12 Vision Guide 5.0 Reference (Ver.5.3) Rev.1