Filters one or more clouds to a surface by proximity and outputs a new point group. Cloud points within the proxim- ity are kept, while cloud points outside of the proximity are removed.
Input Arguments
0 |
Collection Object Name Ref List |
Cloud Names |
One or more point clouds to filter. |
1 |
Collection Object Name |
Filter Surface’s Name |
The name of the surface to filter to. |
2 |
Collection Object Name |
Output Group Name |
The name for the resulting point group. |
3 |
Double |
Low Proximity |
The minimum proximity value. Points above this value (and below the high proximity) will be kept. |
4 |
Double |
High Proximity |
The maximum proximity value. Points below this value (and above the low proximity) will be kept. |
5 |
Integer |
Skip Factor |
A subsampling value to use. For example, if set to 5, only every 5th point will be considered. |
6 |
Output Type |
Output Type |
Specify whether point clouds or point groups should be created. |
Return Arguments
None.
Returned Status
SUCCESS |
The cloud(s) were filtered successfully. |
PARTIAL SUCCESS |
One or more clouds (but not all) could not be found. |
FAILURE |
The clouds or filter group could not be found. |
Remarks
Filter Clouds to Surfaces offers the ability to use an asymmetric distance such as +.1 to +.5 but it ignores edges entirely. This means points beyond an edge are also picked up as long as they are within the specified proximity.
Auto Filter Points/Groups/Clouds to Surface Faces is an alternative that take longer to process, only offsets single proximity value above, below or in both directions but respects edges. This command should be used when edges are of concern.