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.
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). |
None.
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. |
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. |