Group Math & Logic Tool - Enable Expression Tab
The Enable Expression tab is used to construct a mathematical formula that determines the execution of the tool; by default, the Expression is set to 1, which means that the tool will always execute on an acquisition trigger. In order to activate this control, the Tool Enabled control in the General tab must be set to Expression.
In-Sight 2000-130/130C Vision Sensors
Expression
The Expression text box is used to construct a logical formula of tool pass and fail results. Use the Job and Tool Data Symbol Tree to assemble the formula. You can enter items by either double-clicking them, or highlighting them and pressing the Insert button.
Job and Tool Data Symbol Tree
The Job and Tool Data Symbol Tree contains the tool pass and fail results output by Location and/or Inspection Tools. The job and tool data are symbolic references to the values contained within them. Symbols can be added to the Expression by one of two methods:
- Expand the tree, select the desired symbolic reference and then press the Insert button.
- Expand the tree, and double-click the desired symbolic reference.
Open Parenthesis, Comma, Close Parenthesis, AND, OR and NOT Buttons
The Open Parenthesis, Comma, Close Parenthesis, AND, OR and NOT buttons are used to construct formulas. Press the appropriate button to add them to your formula.
Delete Button
The Delete button is used to delete highlighted words or symbols from the Expression. Highlight the desired word or symbol and press Delete.
In-Sight Vision Systems (All Models) and In-Sight 2000 Series 23X Vision Sensors (23M, 230)
Expression
The Expression text box is used to construct a mathematical formula that processes tool results and data. Enter data by either using the keyboard and typing in the name of the mathematical function or job/tool data, or utilize the Vision Tools Tree, Mathematics Tree, Text Tree and/or Vision Data Access Tree on the left-hand side, and the Job and Tool Data Symbol Tree on the right-hand side, to assemble the formula. You can enter items by either double-clicking the items, or highlighting them and pressing the Insert button.
- If the Expression references a tool that has been deleted, the reference will automatically be replaced by "Job.MissingArg" in the formula. The tool will return a Fail until the reference is corrected.
- When constructing formulas, EasyBuilder does not correctly parse tool names that begin with a cell address (e.g. A3_MyTool or P10_SortTool). If expressions need to be created for those tools, rename the tool before creating the formula.
Vision Tools
The Vision Tools Tree contains additional edge functions that can be used to construct your Expression. Functions can be added to the Expression by one of three methods:
- Expand the Edge tree, select the desired function and then press the Insert button.
- Expand the Edge tree, and double-click the desired function.
- Using a keyboard, type the name of the desired function directly in the text box of the Expression.
Mathematics Function Tree
The Mathematics Function Tree contains mathematical functions that can be used to construct your Expression. Functions can be added to the Expression by one of three methods:
- Expand the Mathematics tree, select the desired function and then press the Insert button.
- Expand the Mathematics tree, and double-click the desired function.
- Using a keyboard, type the name of the desired function directly in the text box of the Expression.
Text Function Tree
The Text Function Tree contains functions to format alphanumeric data for display and communications, and can be used to construct your Expression. Functions can be added to the Expression by one of three methods:
- Expand the Text tree, select the desired function and then press the Insert button.
- Expand the Text tree, and double-click the desired function.
- Using a keyboard, type the name of the desired function directly in the text box of the Expression.
Vision Data Access
The Vision Data Access Tree contains additional data that is not available by default that can be used to construct your Expression. Functions can be added to the Expression by one of three methods:
- Expand the Vision Data Access tree, select the desired function and then press the Insert button.
- Expand the Vision Data Access tree, and double-click the desired function.
- Using a keyboard, type the name of the desired function directly in the text box of the Expression.
- The list of functions available is contingent upon the cursor's placement in the Expression. If the cursor is located within the Expression in a location that prohibits a mathematical function from being added, those functions are unavailable until the cursor is in a location where they can be added.
- EasyBuilder only supports Blobs, Edges and Patterns Vision Data Access functions.
Job and Tool Data Symbol Tree
The Job and Tool Data Symbol Tree contains the data output by Location and/or Inspection Tools, as well as Input lines and job data, such as image acquisition parameters. The job and tool data are symbolic references to the values contained within them. Symbols can be added to the Expression by one of three methods:
- Expand the tree, select the desired symbolic reference and then press the Insert button.
- Expand the tree, and double-click the desired symbolic reference.
- Using a keyboard, type the name of the desired symbolic reference directly in the text box of the Expression.
Insert Button
The Insert button is used to place mathematical functions and symbols into the Expression. Select the desired mathematical function or symbol and then press the Insert button to add the function or symbol to the Expression.
Open Parenthesis, Comma, Close Parenthesis Buttons
The Open Parenthesis, Comma and Close Parenthesis buttons are used to construct mathematical formulas. Press the appropriate button to add them to your formula.