Construct Points WildCard Selection    

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?.