MatchPatternAdvancedOptions

NI Vision for LabWindows/CVI Function

MatchPatternAdvancedOptions

Describes how the algorithm matches the pattern.

Elements

Name

Type

Description

subpixelIterations int Defines the maximum number of incremental improvements used to refine matching using subpixel information. The default is 20.
subpixelTolerance double Defines the maximum amount of change, in pixels, between consecutive incremental improvements in the match position that you want to trigger the end of the refinement process. The default is 0, which specifies using the subpixelIterations value. If you provide values for both subpixelIterations and subpixelTolerance, the algorithm refines the match for at most subpixelIterations but may stop early if subpixelTolerance is satisfied. If you set subpixelTolerance, matches may be invalidated during the subpixel matching process. However, using subpixelIterations alone cannot invalidate a match. This behavior is particularly important when using imaqRefineMatches().
initialMatchListLength int Specifies the maximum size of the match list. The match list contains the regions in the inspection image that have the highest probability of containing a match.
matchListReductionFactor int Specifies the reduction of the match list as matches are refined. The default is 5.
initialStepSize int Specifies the number of pixels to shift the sample across the inspection image during the initial phase of shift-invariant matching. The default is 0, which uses the initialStepSize stored in the template. If the step size is not an odd integer, the algorithm uses the default value.
searchStrategy SearchStrategy Specifies the aggressiveness of the rotation search strategy. The default is IMAQ_BALANCED. This applies only to rotation-invariant matches. Note that IMAQ_VERY_AGGRESSIVE is not currently supported.
intermediateAngularAccuracy int Specifies the accuracy to use during the intermediate phase of rotation-invariant matching. The default is the value of finalAngularAccuracy stored in the template. The algorithm coerces this value to an integer that evenly divides 360 and lies in the range defined by initialAngularAccuracy and finalAngularAccuracy. This option only applies to rotation-invariant matching. For more information about initialAngularAccuracy and finalAngularAccuracy, refer to LearnPatternAdvancedRotationOptions.