# ViDiELClassify

The ViDiELClassify function automatically classifies images into the defined classes based on an initial training image set. To use this function, you must define the classes, load an initial set of images into the tool, and then individually label a subset of the training images to ensure that the tool recognizes the features on the images and classifies them correctly.

To use the ViDiELClassify function:

1. Drag and drop the ViDELClassify tool into the Spreadsheet.

   The property sheet pops up:

2. In the General tab of the property sheet, set up the Region of Interest using one of the following methods:

   - Double-click the Region parameter and adjust the ROI box on the acquisition display.

   - Expand the Region parameter and define the box parameters manually.

3. In the Train tab of the property sheet, add the classes you want the function to use.

4. Click OK to close the property sheet.
5. In the Spreadsheet, check the checkbox in the Collect Samples cell of the function. This allows the tool to load images for training.
6. Load images into the function either by double-clicking the desired images in the Filmstrip, or by clicking the Play button in the Filmstrip controls to load all of the images in the Filmstrip.
7. Once you have loaded the training images, uncheck the checkbox in the Collect Samples cell of the function.
8. Double-click the ViDiELClassify cell in the Spreadsheet to re-open the property sheet.

9. In the Train tab, label the training images one-by-one according to the desired class. Alternatively, you can label multiple images at the same time in the Images tab by dragging and dropping them into the Labeled Images column of the desired class. Press Ctrl and click to select multiple images in the Images tab.

10. As your training images are labeled, the Model Health percentage in the Images tab starts to rise. Keep labeling images until the Model Health is sufficiently high.
11. Click OK to finalize the function settings.

Inputs

Setting | Description
PointCloud | Reference to a cell containing a point cloud. The default value is $A$0.
Fixture | Fixture origin (X, Y, Theta). Offsets from the image origin.
Region | Region of Interest (X, Y, Width, Height, Angle).
Collect Samples | Enables or disables sample collection for training.
Show | Select the type of graphic to overlay on the image.

Outputs

Output | Description
Health | The Model Health of the function.
Num Class | The number of defined classes.
Index | The index of the defined classes.
Label | The name of the defined classes.
Num Images | The number of classified images in the defined classes.
Score | The overall confidence score for the defined classes.