Initiates an instrument scan inside of a specified perimeter.
0 |
Collection Instrument ID |
Instrument to scan |
The instrument ID of the instrument in question. |
1 |
Collection Object Name Ref List |
Scan perimeter list |
The names of the perimeters to use. |
2 |
String |
Parameter set name |
The named parameter set to use for the scan (from the instrument’s interface). |
3 |
Collection Object Name |
Group name |
The name of the Point Cloud or group to scan into. |
4 |
Boolean |
Wait for Completion |
Indicates whether the MP should pause until this step is complete, or whether it should continue executing while scanning is occurring. |
None.
SUCCESS |
The scan was completed successfully. |
FAILURE |
The instrument, scan perimeter, or supplied parameter set name was not found. |
There are a number of instrument specific variations for this command:
In 2023.1 this command was expanded to include a list of perimeters, each of which will be scanned with the specified settings if supported by the selected instrument. If multiple perimeters are selected and the instru- ment does not support this, a notification will be show when silent mode is disabled.
There are a number of instrument specific variations on how the Parameter Set Name [Argument 2] can be used.
Laser Radar:
When using the laser radar the Parameter Set Name should be used to set the desired target definition. Select from the available targets defined for use with a perimeter such as Open or Closed Metrology or Vision Scans.
Laser Trackers:
Leica ATS600
When using the Leica ATS600 the scan resolution can be set using a string in the Parameter Set Name field. Use the Dialog entry method in [A2] for more clarity or specify a string directly as follows:
Area Scan Specifications:
“inPxx” or “mmPxx” to set point to point spacing only
“inPxxGSWxx” or “mmPxxGSWxx” to set point to point distance (P) and Grow/Shrink Width (GSW) For example “mmP10” would deliver a scan with 10mm spacing within the specified perimeter.
Use “C” or “P” at the end of any string to specify Point Cloud (C) or Point Group (P) return.
Line Scan Specification (used with both open and closed perimeters):
“uuPxxLWxx” - line scan using the specified Point to Point distance (Pxx) and Line Width (LWxx)
“uuPxxLWxxLtoLxx” - cross line scan using the specified Point to Point distance (Pxx), Line Width (LWxx), and Line to Line distance (LtoLxx)
Room Scanners:
Surphaser
Region scans can be accomplished with both Configure and Measure and Scan within Perimeter. The saved Parameter Set specifies naming and resolution for a scan as well as target extraction. But in Configure and Measure the saved region definition is used to define the scan extents, where as Scan within Perimeter ignores the saved region in preference for the specified perimeter defined in the command. *See notes on zeroing azimuth in the Quickstart Guide.