__header__ This tool allows a user to manually train several colors and then match/compare colors to the trained colors.

A Color Pattern.
 

Using the Color Identify Tool

Once the Color Identify Tool is placed on the screen its ROI will appear on the Viewer Window.  Right-click the tool and choose "Edit" then navigate to the "Identify" page.

On the Identify page the "+" button will train whatever color is currently within the ROI.  Move the ROI to a color and click the + button.  A square representing that color will appear on the Identify page.  Move the ROI and click the "Train" button to retrain the color.

Several colors can be trained in this tool.  Use the "Add" button to add a new color.  As new colors are trained they can be navigated by using the right and left arrow keys.  On the parameter page the NumberColorsTrained will show how many colors have been trained.

When the tool is run it will compare the color it finds in its ROI to the trained colors.   On the Parameter page the IdentifiedColorIndex shows the value of the trained number most similar to the color found in the ROI when the tool was run.  If it is the first trained color then the IdentifiedColorIndex will show "0" but when used (in a maths step)will read "0" ..

The Distance shows how far the average color found in the ROI is from the trained color identified in the IdentifiedColorIndex.
__footer__