Measure Existing Single Point and Compare

Points an instrument at a point, locks onto a target, then measures a point. The deviation between the nominal point and the measured point is calculated automatically as return arguments.

 

Input Arguments

 

0

Collection Instrument ID

Instrument ID

The instrument ID of the instrument in question.

1

Point Name

Existing Target ID

The name of the existing point to measure.

2

Collection Object Name

Group name for new point

The group into which to place the new point.

 

3

 

Boolean

 

Measure Immediately

Indicate whether the point should be measured immediately, or the user should have control to initiate measurement.

4

File Path or Embedded File

HTML Prompt File (optional)

An optional HTML file that can be displayed to the

user as a prompt.

5

Double

Tolerance (0.0 for none)

A tolerance on the distance between the existing and measured points.

 

Return Arguments

 

6

Vector

Vector Representation

The vector between the measured and existing points.

7

Double

X Value

The x deviation between the measured and exist-

ing points.

8

Double

Y Value

The y deviation between the measured and exist- ing points.

9

Double

Z Value

The z deviation between the measured and exist-

ing points.

10

Double

Magnitude

The magnitude between the measured and exist- ing points.

11

Point Name

Resulting Point Name

The name of the measured point.

 

Returned Status

 

SUCCESS

The point was successfully measured and was in tolerance (if applicable).

FAILURE

The existing point could not be found, the measurement was not successful, or the tolerance was exceeded.

 

Remarks

The instrument must be located in the active collection.

The measured point will inherit the target name of the nominal point (but with a different group name).