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.

Overview

Crops point clouds using ROI, supporting multiple ROI inputs.

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

  • Disabled (Default): Does not keep the structure ordered. The output contains only the points inside the ROI (or outside, if Reverse is enabled), discarding invalid points, resulting in an unordered point list. This suits most point cloud processing scenarios, especially when downstream steps only need valid point coordinates and not the original structure — the output data volume is typically much smaller than when keeping the original structure (which includes many invalid points), making downstream processing faster.

  • Enabled: Keeps the structure ordered. The output point cloud has the same shape as the input; points outside the ROI are marked as invalid but still occupy their original positions, preserving the original adjacency relationships between points. This suits scenarios where downstream steps need to use the spatial adjacency of the point cloud for image-like processing.

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

  • Enabled (Default): Keeps the original size, even if some regions become entirely invalid points due to ROI filtering.

  • Disabled: While keeping the 2D structure, removes rows and columns that became entirely invalid due to ROI filtering, yielding a possibly smaller but still ordered point cloud.

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:

  • True

  • False

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

  • Disabled (Default): Merge results. If an input point cloud intersects with multiple ROIs, all points falling inside these ROIs are merged into one output point cloud.

  • Enabled: Split results. If an input point cloud intersects with multiple ROIs, each ROI generates a separate output point cloud. That is, one input point cloud may output multiple point clouds depending on the number of intersecting ROIs.

Parameter Range

Default: False

Enable Node

Description

Controls whether this operator executes its computation.

Tuning Instructions

Enabled (Default): Runs the operator function normally.

Disabled: The operator performs no operation and directly outputs the input data.

Parameter Range

Default: True