Configure and Measure

Sets an instrument’s target name and measurement mode, then initiates measurement. The interface will check to see if the instrument is busy before the command executes, and if so, waits 5 seconds before checking again. If still busy, the command fails without any action having been taken.

 

Input Arguments

 

0

Collection Instrument ID

Instrument’s ID

The instrument ID of the instrument in question.

1

Point Name

Target Name

The name of the target to measure.

2

String

Measurement Mode

The name of the measurement mode to use.

3

Boolean

Measure Immediately

Indicate whether measurement should be performed immediately, or whether the user should initiate measurement.

4

Boolean

Wait for Completion

Indicate whether the MP should pause until the measurement is complete, or whether it can continue executing while the measurement is occurring.

5

Double

Timeout in Seconds

If Measure Immediately is set to FALSE and Wait for Completion is set to TRUE, the step will fail if a measurement is not received from the instrument within this time period (laser trackers only).

 

Return Arguments

None.

 

Returned Status

 

SUCCESS

The measurement was successful.

FAILURE

The measurement was not successful, the measurement mode was not found, the timeout was exceeded, the instrument was not responding, or the instrument was not found.

 

Remarks

If “Measure Immediately” is set to TRUE, the command will for a valid distance for trackers before attempting measurement, and fail if a valid lock is not obtained. For some instruments (listed below), you can pass special strings to obtain additional behavior:

 

Laser Trackers

Enter the name of the Measurement Profile to use

Any Measurement Profile can be triggered by this command.

 

Portable CMM Arms

Discrete

Single Discrete Point measurement mode.

Stream

Scan points per user option setting (spatial or temporal measurement).

Patch

Measure patch, or projected point.

 

Portable CMM Arms

Pin

Measure pin, or outside circle with projection plane.

Hole

Measure hole, or inside circle with projection plane.

Slot

Measure slot, or two inside circles with projection plane.

Line

Measure line per user option setting (two point, averaged, or edge).

Circle

Measure circle, inside, outside, or on face, with no planar offset.

Plane

Measure Plane

Sphere

Measure Sphere.

Section

Measure Cross Sections (multiple if cross value not equal to zero).

Frame

Measure frames (origin at probe center, using probe orientation).

Batch

Perform Guided Measurement (invoked from SA with Batch of pts).

Scanner

If available, use installed line scanner to measure cloud points.

Average

Single averaged point.

Geom Trigger

Measure across array of planar geometry triggers.

 

Nikon Laser Radar

Enter the name of the Target Profile to use

Any Target Profile can be triggered by name such as [Tooling Ball ], when entered as the Measurement Mode in Argument 2.

 

Theodolite Manager

Record

Triggers a discrete measurement (set the Fast, Standard or Precise if desired using an Instrument Operational Check)

 

Surphaser

[Saved Parameter Set]

The “Point Name” argument will set the Collection and Cloud names, as well as the group name for found targets, and the voxel cloud name (if set to send). The “Measurement Mode” argument specifies the Saved Parameter Set (measurement profile). If the profile is not found, the command will fail if the User Interaction Mode is set to Silent. Otherwise, you’ll be asked if you want to use the current settings. If “Measure Immediately” is false, the command will simply set the profile selected if it is found. The “Timeout in Seconds” is ignored, since scan time can vary quite a lot, depending on scan parameters.