Table Of Contents

Advanced Setup Learn Geometric Pattern 1 (G Dataflow)

Last Modified: June 25, 2019

Optimizes and fine-tunes advanced parameters used during the learning phase of feature-based geometric pattern matching.

Run this node before the Learn Geometric Pattern 1 node. If you use this node with the Setup Learn Geometric Pattern 1 node, execute this node after the Setup Learn Geometric Pattern 1 node.

connector_pane_image
datatype_icon

learn geometric pattern 1 setup data in

String that contains information from the Setup Learn Geometric Pattern 1 node. If this input is not connected, the node uses default parameters for all unconfigured options.

datatype_icon

advanced geometric learn options 1

Array of options to use during the learning phase.

datatype_icon

Setup Data Item

Option you want to use during the learning phase.

The following values are possible:

Name Value Description
Curve Extraction Mode 0

Specifies how the node identifies curves in the image. Set this option to normal if you want the node to make no assumptions about the uniformity of objects in the image or the image background. Set this option to uniform regions if you want the node to assume that either the objects in the image or the image background consist of uniform pixel values. This allows the node to more accurately calculate the external curves of the objects.

Curve Edge Threshold 1

Specifies the minimum contrast an edge pixel must have for it to be considered part of a curve. Valid values range from 1 to 255.

Curve Edge Filter Size 2

Specifies the width of the edge filter that the node uses to identify curves in the image. Set this option to 0 to specify a fine filter width, or set the option to 1 to specify the normal filter width.

Min Curve Length 3

Specifies the length, in pixels, of the smallest curve that you want the node to identify. The node ignores any curves that have a length less than this value.

Curve Row Search Step Size 4

Specifies the distance, in the y direction, between the image rows that the algorithm inspects for curve seed points. Valid values range from 1 to 255. The default value is 15.

Curve Col Search Step Size 5

Specifies the distance, in the x direction, between the image columns that the algorithm inspects for curve seed points. Valid values range from 1 to 255. The default value is 15.

Curve Max Endpoint Gap 6

Specifies the maximum gap, in pixels, between the endpoints of a curve that the node identifies as a closed curve. If the gap is larger than this value, the node identifies the curve as an open curve. The default value is 10.

Extract Closed Curves 7

Specifies whether to identify only closed curves in the image. The default value is FALSE, which specifies that the node should identify both open and closed curves.

Enable Subpixel Curve Extraction 8

The node ignores this value.

Min Rectangular Dimension 9

Specifies the minimum length for each side of a rectangular feature. The algorithm ignores rectangular features with a side shorter than this value. The default value is 10.

Min Feature Aspect Ratio 10

Specifies the minimum aspect ratio of a rectangular feature. The algorithm ignores rectangular features with aspect ratios less than this value. Valid values for this element range from .01 to 1.0. The default value is 0.1.

Min Feature Radius 11

Specifies the minimum radius, in pixels, for a circular feature. The algorithm ignores circular features with radii less than this value. The default value is 5.

Min Feature Length 12

Specifies the minimum length, in pixels, for a linear feature. The algorithm ignores linear features with lengths shorter than this value. The default value is 15.

Min Feature Strength 13

Specifies the minimum strength for a feature. The algorithm ignores features with a strength less than this value. Valid values for this element range from 0 to 1. The default value is 0.5.

Max Number of Features 14

Specifies the maximum number of features the algorithm uses when learning. The default value is 25.

Pixel Tolerance For Lines 15

Specifies the maximum number of pixels between an edge pixel and a linear feature for the algorithm to consider that edge pixel as part of the linear feature. The default value is 2.

datatype_icon

Item Value

Value of the option you want to use during the learning phase.

datatype_icon

error in

Error conditions that occur before this node runs.

The node responds to this input according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error error in contains an error
If no error occurred before the node runs, the node begins execution normally.

If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

Default: No error

datatype_icon

learn geometric pattern 1 setup data out

String that contains information about the setup parameters selected for the learning phase.

Connect this output to the Learn Geometric Pattern 1 node.

datatype_icon

error out

Error information.

The node produces this output according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error error in contains an error
If no error occurred before the node runs, the node begins execution normally.

If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

Where This Node Can Run:

Desktop OS: Windows

FPGA: Not supported

Web Server: Not supported in VIs that run in a web application


Recently Viewed Topics