Table Of Contents

Learn Multiple Geometric Patterns (G Dataflow)

Last Modified: June 25, 2019

Combines the descriptions of the patterns to search for during the matching phase into a multiple geometric template.

Use the multiple geometric template to search for these template images in the target image.

connector_pane_image
datatype_icon

template images

Array of template images to search for in the target image.

datatype_icon

template labels

Array of labels that identify the template images specified in template images.

Each label in the array identifies the template at the corresponding index in the template images array.

datatype_icon

default match options

Match options used to search for the template images in the target image during the match phase.

Options are associated with the templates in the following manner:

  • If you pass an empty array, the algorithm uses an empty string for match setup data, 1 for number of matches, and 800 for the minimum match score.
  • If you pass an array of one element, the algorithm uses the value of this element to match all the templates.
  • If you pass as many elements in this array as there are geometric templates, the algorithm makes a one to one correspondence between the elements of the array and the geometric templates.
  • Passing any other number of elements in the array results in an error.

You can override the match options specified in this node during the match phase by passing new values to the override match options control on the Match Multiple Geometric Patterns node.

datatype_icon

match setup data

String that contains information from the Setup Match Geometric Pattern node or the Advanced Setup Match Geometric Pattern node.

Set this value to an empty string if you want to use default parameters for all options.

datatype_icon

number of matches

Number of valid matches expected.

datatype_icon

minimum match score

Smallest score a match can have to be considered valid.

The data range for a match is between 0 and 1000.

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

multiple template session out

Reference to the new multiple geometric template.

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.

Configure the Template Image

Use one of the following methods to configure the template image for use with this node.

  • Use the node to load a template image that was created previously.
  • Use the Learn Geometric Pattern node to learn the template image.

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