__header__

Description

This tool is useful if the parts being inspected come in at different angles or in a different location in relation to the camera.  The Locate tool will define a calibration (angle and location) for part that is being viewed.

The Locate Tool.     The Locate Tool.

Inputs

Viewer

Optional: the viewer to which to attach the calibration

CalibrationCollection

Optional: the calibration collecion in the Running Object table. This acts as a global store for the calibration, so accessable from other tools/seqeunces

Origon

The input geoemetry (usually a point) that acts as the 0,0,0 points

InputRoll

A point: defines the roll to the orgin point
A line: the angel of the line defines the part angle
Numeric: the angle defines in radians

Parameters

Name

The name of the calibation as placed in the calibration colection

ResetViewerCalibration

If set assigns this calibration to the input viewer

TranslationX
TranslationY
Roll

Ouput: returns the current tranlation and roll (in degrees)

RenderStylePoint

defines how the origin is displayed

Calibration

Output: the calibration matrix defined.

RefreshViewer

Example: Setting the angle using two known points

One way to use the locate tool is to find the angle of the part using two known points on that part.  For this example we will use the correlation tool to find the points.(There are several tools that can be used to gain these points.)  
  1. Grab the image.


  2. Use two Correlation tools to locate two different points on the part. 


  3. On the Locate Tool's inputs page if any tools are already listed right-click and clear them, i.e. if a correlation tool exists in the inputs page clear it before adding anything to the page.


  4. On the Locate Tool's inputs page drag the first Correlation tool onto the Origin , set it to "Points" and set the Index to 1.  Drag the second Correlation tool onto the Geometry, set it to "Points" and set the Index to 1.




__Footer__