The Data Analysis edit control provides a graphical user interface to the CogDataAnalysis tool, which allows you to set tolerance ranges and perform statistical analysis on the results of other vision tools. The edit control allows you to set the various test ranges, view the tolerance results for individual values or aggregate values, and view a statistical analysis of previous test results. The following figure shows a Data Analysis edit control:

The edit control offers the following features:

• A row of control buttons at the top left
• A tab to set tolerance ranges
• A tab to view the status of tolerance tests and the statistics compiled from recent tests

You can experiment with the edit control by using QuickBuild to create a CogDataAnalysis tool. A new CogDataAnalysis tool appears with one data channel ready to accept a single result value, as shown in the following figure:

To include the edit control in your custom vision application, you must first add it to your Visual Studio.NET development environment. See the topic Adding Edit Controls to Visual Studio for more information.

See the topic How To Link Data Properties to a Data Analysis Tool for details on how to link the data property of a vision tool to a data channel.

The following table describes the function of each button:

Table 1. Control buttons

Button	Description	Function
	Run	Apply the current set of tolerance ranges to all input values.
	Open	Open a VisionPro persistence (.vpp) file that contains a set of saved properties for this vision tool object type. VisionPro reports an error if you try to open a .vpp file for another object type.
	Save	Save the current properties of the vision tool to a VisionPro persistence (.vpp) file.
	Save As	Save the current properties of the vision tool to a new VisionPro persistence (.vpp) file.
	Reset	Reset the vision tool to its default state. This tool gives you a choice between resetting to the default-constructed state, which is appropriate when you are using it in a Visual Studio.NET application, and its template-initialized state, which is appropriate for QuickBuild applications.
	Show Floating Channels	Open a floating channels configuration window, which gives you the same access to channel configuration available from the Settings tab. Any changes you make on this grid will be reflected in the grid on the Settings tab.
	Show Floating Results	Open a separate results window with the same contents as seen in the Results tab.
	Show ToolTips	Enable or disables the display of tooltips for individual items in the edit control.
	Help	Open this VisionPro online help file.

This section contains the following subsections.

• Channels
• Statistics

Use the Settings tab to determine the number of data channels the Data Analysis tool will use, set the tolerance ranges for each channel, and control buffered statistics. The following figure shows the Settings tab:

By default, the Settings tab has one data channel, but you can add more channels and test the data properties of multiple vision tools simultaneously.

This section contains the following subsections.

• Entering Tolerance Values
• Status Bar
• Rejecting Old Data and Viewing Individual Results

Use the Channels area of the Settings tab to determine the number of data channels this Data Analysis edit control will use, verify that each channel receives the current input value, and set a range of tolerance values for each input value. See the topic Link Data Properties to a Data Analysis Tool for details on how to link the data property of a vision tool to a data channel.

Use the following function buttons to manage the data channels:

Table 2. Function Buttons

Button	Description
	AddNew a new channel to the end of the list.
	Remove the currently highlighted channel from the list.
	Move the currently highlighted channel up in the list, and update the index of the function within the collection.
	Move the currently highlighted channel down in the list, and update the index of the function within the collection.

Configure each data channel with the following information:

Entering Tolerance Values

To enter a tolerance value for a data channel, first select the checkbox underneath the desired tolerance check. Then enter a tolerance value directly or use the spin control to select the desired value. For example, the following figure shows the tolerance check for Warn Low enabled with a value of 100:

Status Bar

In addition to the status bar symbols used for all tools (green circle for pass, and red rectangle for fail), the Data Analysis tool uses the following unique symbols:

Table 4. Status Bar Icons

Icon	Description
	The tool ran successfully, but at least one value was between the warning tolerance and the reject tolerance.
	The tool ran successfully, but at least one value was at or above the reject tolerance.

Rejecting Old Data and Viewing Individual Results

Use the Statistics area of the Settings tab for configuring statistical analysis settings for both running statistics and buffered statistics. Running statistics factor in the last valid input value to update a set of statistical calculations. Buffered statistics are statistical values produced for a finite number of recent input values.

The Statistics area supports the following features:

This section contains the following subsections.

• Aggregate Tolerances
• Channels

Use the Results tab to view all the results from the tool. The following figure shows the Results tab:

Use the Aggregate Tolerances area of the Results tab to view the tolerance status of the most recent test. The individual test fields indicate the number of data channels that fall into each category when the tool was last run.

The Aggregate Tolerances area supports the following indicators:

Use the Channels grid of the Results tab to view running and buffered statistics. The Channels grid supports the following fields:

If the Show [Buffered] Statistics checkbox at the bottom of the Results tab is enabled, the Channels grid also contains the following fields: