# Label in Blue Locate

The Blue Locate tool locates and identifies features in an image. The Blue Locate tool labeling Labeling is the process of annotating an image with "ground truth". Depending on the tool that you are using, labeling can take different forms. You label an image set for two reasons: to provide the information needed to train the tool and to allow you to measure and validate the performance of the trained tool against the ground truth. process involves identifying the locations and names of features in an image. Within the image, you label features by identifying the center of the feature A feature is a visually distinguishable area in an image. Features typically represent something of interest for the application (a defect, an object, a particular component of an object)., and placing a feature label graphic over the feature. If orientation and/or scaling is enabled, then you can also specify an orientation or scale. You specify the name of a feature using up to 140 characters.

Note: This illustration shows the rectangular feature graphic. You can also use circular feature graphics. This can be changed by selecting the desired feature graphic geometry from the Tool > Display menu.
Graphic | Description
1 | Indicates the orientation of the feature graphic. The Oriented checkbox must be enabled to be able to change the orientation of the feature graphic. When the display is switched to a circular feature graphic, the orientation is indicated in the middle of the circular graphic.
2 | The bounds of the feature.
3 | The center of the feature.
4 | Along with the color, indicates the state of the feature graphic.
5 | The 140 character name of the feature graphic.

Once you have applied labels to the features in your images, and you have trained the tool, the tool will apply Markings to the areas of the image that it thinks match the feature. The difference between labels and markings is their appearance.

Note: The label graphics are for illustrative purposes only, and they do not affect or influence the training Training is the process that your tool, which is a neural network, is learning about the features (pixels) based on the labels you made. For example, a tool will learn the defect/normal pixels in each image based on the defect/normal labels you drew. The goal of the tool Training is learning enough to give the correct inspection results of whether an unseen image is defective or not. The key to training is to ensure that you include all possible variations within your training set, and that your images are accurately labeled. Training times vary by the application, tool setup and the GPU in the PC being used to train the network. of the network model A specific spatial arrangement of a set of features (Blue Locate and Blue Read tools only.) During a post-processing step, the Blue Locate and Blue Read tools can fit all of the features detected in an image to the models defined for the tool. The overall pose and identity of the model is then returned..

The three key components of labeling features for the Blue Locate tool are accurately placing, sizing the label graphics, and assigning useful names to the features.

### Placing the Labels

You perform Labeling with the Blue Locate tool by using your mouse and clicking on the features you want to identify, which places a feature label graphic as an overlay on the feature in the image. Deep Learning will perform the best when the center point of the feature label graphic is placed on an interesting feature where there is a lot of information on it. A good example is to place the feature label graphic on an intersection of some edges, rather than a random point on a single edge.

### Sizing the Labels

The label sizing is determined by the Feature Size parameter, and whether or not the Scaled parameter is enabled. See the Sizing the Labels: Feature Size (Sampling Parameter) and Scaled (Feature Parameter) topics for more information.

### Naming the Labels

Once you have clicked on the feature, the feature label graphic will be displayed, and you will need to assign a name to the feature. The name can be up to 140 Unicode characters.

There are two ways to assign a name to a feature label graphic:

1. Click on the feature, and when the editing cursor appears, you can either type in the name, or paste in a name, up to 140 characters long.
2. In the Database Overview, select the text for the feature and press the pencil icon to either type or paste in the name.

After adding a name, press the Enter key.

### Labeling Multiple Features

To speed up the labeling process, the Deep Learning software will remember the last created label. This provides you with a couple of different options, depending on the features that you are labeling.

- If you have a minimal number of features to label in your images, after placing the label in the first image, go through the rest of your images and place that label in all of the subsequent images before creating a new feature label graphic. Then repeat this process for all of the features you need to label in your images.

- If you have a lot of small features to label in your images, label one feature, and then label each instance of that feature, repeating this process for each feature.

### Labeling Multiple Features with "Copy + Paste"

After you have applied labels to features in an image, you can also hold down the Shift key and drag your mouse to select multiple features (or hold down the Shift key and select the desired features). Once you have selected the features, you can copy them using the standard Copy + Paste keyboard shortcuts (Ctrl + C and Ctrl + V) or right-click menu options.

Note: After you paste the labels into a new image, all of the labels will move as a group. To select and move individual labels, first click any area of the GUI outside of the image, and then select and move the desired feature.

## Circle or Rectangle Feature Labels

For Blue Locate, you can display feature label graphics as either a rectangle or a circular shape. When your application contains square or rectangular features, the rectangular feature graphic should be used. If your application contains circular or elliptical features, then the circular feature graphic should be used.

Tip: Circular feature graphics are also helpful when the features are densely packed (for example, in counting applications).

To change the display of the feature label graphics, go to the Tool menu and open the Display sub-menu.

Note: The label graphics are for illustrative purposes only, and they do not affect or influence the training of the network model.
Note: The use of the feature graphics is exclusive; if you choose rectangular feature graphics you can only use rectangular feature graphics.

Rectangular Feature Graphic

Circular Feature Graphic

## Feature Label Graphics

This topic provides an overview of the feature label graphic, the states of the labels used by the Blue Locate tool.

Labeled Feature

| Unselected | Selected
--- | --- | ---
Label feature graphic |  |

## Sizing the Labels: Feature Size (Sampling Parameter) and Scaled (Feature Parameter)

The configuration of the Blue Locate tool's Feature Size is dependent on the Features Tool Parameters settings.

- If your application revolves around a single feature or multiple features that are all of the same size and aspect-ratio, then you may configure the size and aspect ratio of the feature independently to match the size of the feature(s) in the images, by either using the interactive control or the Feature Size field. All of your feature labels will be exactly the size and shape of the feature size The subjective size of the image features that you feel are most important for analyzing image content. The feature size determines the size of the image region used for sampling. Only used with Blue Locate, Blue Read, and Legacy type tools. that you specify.

  The tool's interactive Feature Size indicator graphic is displayed in the bottom left corner of the image (shown below).

  The indicator graphic can be dragged within the image, allowing you to size it based on the feature(s) in the image. In addition, the indicator can be re-sized by dragging the re-size handle (which is displayed when hovering over the indicator). Changing the size of the indicator will also change the Feature Size parameter.

- If your application involves features that are of differing sizes and/or aspect-ratios, you will want to enable the Scaled parameter.

  - Set the Scaled parameter to Uniform when the sizes of individual feature labels can be set differently, but all of the aspect ratios are the same.
  - Set the Scaled parameter to Non-uniform when each feature has a unique aspect ratio.

Note: When either uniform or non-uniform scale is enabled, the tool's feature size and aspect ratio has no impact on the operation of the tool. Instead, the range of feature sizes and aspect ratios that you label are used by the tool to perform both training and run-time sampling. However, the tool still allows you to configure the feature size.