# Train and Test the ViDi Tools

After you have acquired images and created training and testing image sets, you are ready to begin adding ViDi tools to your job. There are three individual ViDi functions, ViDiCheck, ViDiDetect and ViDiRead, and the ViDi function provides access to the full suite of ViDi tools.

Note:

- If your subject will undergo movement during the application, you will want to consider how best to fixture your images. If you are using the individual ViDi functions, you will want to pass in fixture data from an In-Sight Vision Tool, such as a PatMax Redline pattern. If you are using the full ViDi function, you can use a Blue Locate tool, for example, to provide rotation and translation information for downstream tools (referred to as a tool chain)
- For the training phase of job development, Cognex recommends creating a new job, and developing and storing your job file on the PC. The PC should have a GPU to train the Cognex ViDi tools. In addition, there should be enough storage (preferably on an Solid State Drive), as the training workspace for the ViDi tool or tools can be several GBs of data, depending on the tool and number of training images.
- ViDi function access is governed by your Cognex Security License. Please contact your Cognex sales representative to gain access to additional ViDi functions.

- When you perform the training of your ViDi tools within your ViDi functions, only perform the training while connected to one device (either an emulator or an In-Sight D900 series vision system) at a time. You may encounter errors with your training if you are connected to more than one device while training.

  After training has completed, disconnect from the device, which will deallocate the GPU and allow it to be used on the next device. Once the disconnection is complete, you can then open another, new connection to an emulator or vision system and begin training on that device.

  For example, if you had connected to an emulator from In-Sight Vision Suite, and then connected to a vision system, so that you had two tabs open, one for the emulator and one for the vision system, with ViDi functions in both jobs, and you attempted to train ViDi tools in one of the open tabs, you will encounter an error and be unable to train the ViDi tools. Instead, you should connect to the emulator, train the ViDi tools, then close the emulator tab before connecting to the vision system and training the ViDi tools in that job.

- If you disconnect from a device (emulator, In-Sight D900 series vision system or In-Sight ViDi PC) with an unsaved job that contains ViDi cells (they can be in either a trained or untrained state), on reconnecting to the device the same job will be loaded, but all the ViDi cells will turn into runtime-only cells (which means the cells no longer have access to the ViDi Editor). Since the job was not saved, all the training data associated with the ViDi cells will have been lost, because the cells were converted into runtime only cells. Always ensure that you save your job file prior to disconnecting from a device.