Renames a set of points in a point group based on their proximity to a set of reference points in another point group.
Input Arguments
0 |
Collection Object Name |
Reference Group Name |
The group containing the reference points to consider. |
1 |
Collection Object Name |
Group To Rename Points |
The group containing the points to rename. |
2 |
Double |
Proximity Threshold |
A point must be within this distance from a refer- ence point to be considered for renaming. |
3 |
Boolean |
Verify Results? |
Indicates whether a dialog should be displayed showing the results of the renaming operation. |
4 |
Boolean |
Rename All Proximate Points? |
True will rename all points within the specified proximity threshold. |
Return Arguments
None.
Returned Status
SUCCESS |
The specified group was renamed successfully. |
FAILURE |
The reference group or group to rename was not found, or no points were renamed. |
Remarks
A proximity threshold of zero indicates that the points to rename must lie exactly on top of the reference points. If more than one point lies within the proximity threshold to a reference point, then only the closest point will be re- named by default. That can be changed using the Rename All Proximate Points option.