Point Cloud ROI
Description
This operator is used to crop and filter input point clouds based on one or more 3D Regions of Interest (ROI). The operator retains points falling inside these ROIs and removes points outside. It also provides options to control the structure of the output point cloud (whether to maintain the original organized structure) and how to handle the interaction results between multiple ROIs and a single point cloud.
Scenarios
-
Spatial Filtering: Retain point clouds only within specific areas of the scene, such as point clouds on a workbench, filtering out the surrounding environment.
-
Remove Interference: Define an ROI to frame the background or known distractors, and then use the "Enable Invert" function to remove them.
-
Local Processing: Extract point clouds from a specific area of an object for detailed analysis or processing.
-
Partitioned Processing: Use multiple ROIs to split the point cloud into different parts for separate subsequent processing.
Inputs and Outputs
Inputs |
Point Cloud: The input point cloud or list of point clouds to be cropped. 3D ROI: A list of dictionaries for one or more ROIs, usually rotation vectors + translation, defining the pose of the ROI. |
Outputs |
Cropped point cloud: The list of point clouds after ROI cropping. |
Parameters
Keep Organized
Description |
Controls whether the output point cloud retains the original structure of the input. |
Tuning Instructions |
|
Parameter Range |
Default: False |
Keep Original Size
Description |
Only takes effect when "Keep Organized" is enabled and the input point cloud has an ordered structure. Controls whether, while keeping the ordered structure, rows and columns consisting entirely of invalid points are cropped out. |
Tuning Instructions |
|
Parameter Range |
Default: True |
Enable Invert
Description |
Inverts the filtering logic. |
Tuning Instructions |
Disabled (Default): Keeps the point cloud inside the ROI and removes the point cloud outside the ROI. Enabled: Keeps the point cloud outside the ROI and removes the point cloud inside the ROI. Useful for removing interference from a specific region. |
Parameter Range |
Values/Range:
Default: False |
Split Multi-ROI Results
Description |
Only effective when "Enable Invert" is disabled. Controls how to handle the filtering results of the same input point cloud when multiple ROIs are input. |
Tuning Instructions |
|
Parameter Range |
Default: False |