Searches one or more source point groups and copies points matching a search criteria into a specified group.
Input Arguments
0 |
Collection Object Name Ref List |
Groups to Select From |
A list of the source point groups. |
1 |
Point Name |
WildCard Selection Names |
A point name containing the point selection criteria. |
2 |
Collection Object Name |
Group for New Points |
The group to contain the new points. |
3 |
Boolean |
Include prior complete name |
Specify whether to include each point’s source point group in the name of the point. |
Return Arguments
None.
Returned Status
SUCCESS |
All source point groups were found, and the points were created successfully. |
PARTIAL SUCCESS |
At least one source point group (but not all) was found. |
FAILURE |
No source point groups were found. |
Remarks
The newly shifted points are essentially copies of the original points. As such, any points which are measured targets are converted to constructed points, but their offsets are preserved.
If the resulting points already exist, they will automatically be sequenced to prevent duplicate point names. If no points match the search criteria, an empty point group will be created.
If “Include prior complete name” is set to TRUE, the new point name will be prefixed with “A_” and appended with an underscore and the original point name.
Enter wildcard values for the collection, point group, and point name using the same conventions as elsewhere in SA. Asterisks (*) are wildcards for one or more characters, while question marks (?) are placeholders for single charac- ters. Specific characters can also be found using brackets[]. To find all points from all collections in point groups that start with “s” and whose point names have two digits starting with “1”, the point name defining the selection criteria would be *::s*::1?.