Auto-Measure Vectors

Automatically measures a set of nominal vectors. The instrument is first pointed at the base of the first nominal vector (the “seed” point), and a search is initiated to lock onto a reflector (for non-targetless instruments). A measurement is taken and a vector is created between the measured point and the seed point.

If the Project Point to Vector argument is set to TRUE, the measured point will first be projected to a vector, and the vector will instead be created between the projected point and the seed point. In the case of targetless instruments such as a laser radar, the projected point will be used as the new “seed” point for another measurement, and the pro- cess will be repeated until the measured point is within a specified tolerance of the nominal vector (defined by the measurement profile).

 

Input Arguments

 

0

Collection Instrument ID

Instrument ID

The instrument ID of the instrument to perform the measurement.

1

Collection Object Name

Vector Group Name

The name of the nominal vector group to mea-

sure.

2

Collection Object Name

Actuals Group Name (to be measured)

A group name for the measured points.

3

Boolean

Project Point to Vector

Indicates whether the measured point should first

be projected to the nominal vector before creat- ing the resulting vector.

 

4

 

Double

 

Angle Tolerance

Indicates the maximum acceptable acute angle between the line of sight and the nominal vector.

Angles above this threshold are skipped.

5

Double

High Tolerance

A high tolerance to apply to the resulting vector group (for colorization purposes).

6

Double

Low Tolerance

A low tolerance to apply to the resulting vector

group (for colorization purposes).

 

Return Arguments

None.

 

Returned Status

 

SUCCESS

The measurements were completed successfully.

FAILURE

The instrument or reference vectors were not found, or measurement failed.

 

Remarks

The angle tolerance is primarily for targetless devices such as a laser radar, in which measurements are either not possible or not accurate above some threshold. In those cases, this tolerance saves a signfiicant amount of time on measurement.