Table Of Contents

Get Set OCR Property (Get Set OCR Property (I32)) (G Dataflow)

Last Modified: June 25, 2019

Gets and sets the value of the property. This node works only with I32 properties.

connector_pane_image
datatype_icon

OCR session in

OCR session on which this node operates. To create a session, use the Create OCR Session node.

datatype_icon

property

Property that this node gets or sets.

The following values are valid:

Name Value Description
Acceptance Level 0

The minimum acceptance level at which an object is considered a trained character. The range of valid values for this property is 0 to 1000. The default value is 700.

Min Char Size 1

The minimum object size, in pixels, at which an object is a potential identifiable character. The minimum value allowed for this property is 1. The value of this property must not exceed Max Char Size. The default is 20 pixels.

Max Char Size 2

The maximum object size, in pixels, at which an object is a potential identifiable character. Set this value to 65536, which is also the default value, to specify that all values greater than Min Char Size are acceptable. The value of this property must not be less than Min Char Size.

Min Char Spacing 3

The minimum amount of space, in pixels, that can be between characters. This value must not be less than the Max Horiz Element Spacing. The default value is 1.

Max Horiz Element Spacing 4

The maximum horizontal spacing, in pixels, between the elements that are combined to form a single character. For stroke characters, set this value to 1 or 2. For segment characters or pin stamp characters, set this value to 5 or higher. This value cannot exceed the actual character spacing value specified by the Min Char Spacing property. The horizontal spacing value is required to ensure that OCR correctly trains and reads characters that consist of several elements. The minimum value allowed for this property is 0. The default value is 1.

Max Vert Element Spacing 5

The maximum vertical spacing, in pixels, between the elements that are combined to form a single character. The default value is 0, which specifies that any object in the ROI should be considered part of a valid object.

Min Bounding Rect Width 6

The minimum width, in pixels, of a character bounding rectangle. The value of this property cannot exceed Max Bounding Rect Width. The minimum value allowed for this property, which is also the default value, is 1.

Max Bounding Rect Width 7

The maximum width, in pixels, of a character bounding rectangle. Set this value to 65536, which is also the default value, to specify that all values greater than Min Bounding Rect Width are acceptable. The value of this property must not be less than Min Bounding Rect Width.

Min Bounding Rect Height 8

The minimum height, in pixels, of a character bounding rectangle. The value of this property cannot exceed Max Bounding Rect Height. The minimum value allowed for this property, which is also the default value, is 1.

Max Bounding Rect Height 9

The maximum height, in pixels, of a character bounding rectangle. Set this value to 65536, which is also the default value, to specify that all values greater than Min Bounding Rect Height are acceptable. The value of this property must not be less than Min Bounding Rect Height.

Read Strategy 10

The read strategy determines how closely OCR analyzes images in the reading process to match objects with trained characters. The following list includes valid values:

  • Aggressive—Use few criteria to determine character match.
  • Conservative—Use extensive criteria to determine character match.

The default value is Aggressive.

Aspect Ratio 11

The maximum aspect ratio variation percentage that the Read Text node allows when it identifies characters. The minimum value for this property is 100, which specifies that the identified object must match the trained character exactly in size and height/width ratio. The default aspect ratio is 400.

Number Of Erosions 12

The number of erosions to perform to remove small objects. After performing the specified number of erosions, OCR restores remaining objects to their original uneroded size. The default value is 0.

Read Resolution 13

The level of character criteria that OCR uses to determine if an object matches a trained character. The default is low resolution.

Size of Char Set 14

The number of characters in the trained character set. This property is read-only.

15

The character that the Read Text node substitutes for objects it cannot match with any of the trained characters. The default value is a question mark (?).

Remove Particles Touching ROI 16

Set this property to TRUE for OCR to remove objects that are touching the ROI you specified. The removed objects are not considered for training or reading. When you set this property to FALSE, OCR retains objects that are touching the ROI. The default value is FALSE.

Auto Split 17

Set this property to TRUE to automatically adjust the location of the character bounding rectangle when characters overlap vertically. This property is useful when you are working with an image that contains slanted characters. If the characters are not slanted and/or do not overlap vertically, set this property to FALSE. The default value is FALSE.

datatype_icon

value in

New value of the property if get/set? is set to True. Otherwise, value in is ignored.

datatype_icon

get/set?

Boolean that specifies whether the node gets or sets the property value.

True Sets the property value.
False Gets the property value.
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

OCR session out

OCR session on which this node operates.

datatype_icon

value out

Value of the property specified by property.

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