Point Cloud Sorting
Description
This operator is used to sort a list of input point clouds. It reorders the point clouds in the list according to a specified order based on a user-selected sorting method (such as point count, bounding box center, bounding box dimensions, etc.). The operator can output the complete sorted list or retain only a custom number of results after sorting.
Overview
Orders a point-cloud list by a selected geometric or statistical attribute and can retain only leading results.
Scenarios
-
Filter specific targets: Filter targets from multiple detection results based on dimensions or point counts. For example, find the largest one in a pile of scattered workpieces.
-
Sort by spatial position: When multiple objects are arranged along a certain direction, they can be sorted based on their positions. For example, process multiple objects on a conveyor belt one by one in order from left to right (sorted along the X-axis).
-
Select the most suitable point cloud: Select the target that best meets the requirements from multiple input items based on dimensional information such as height and width.
Inputs and Outputs
Inputs |
Point Cloud: A list containing multiple point clouds. |
Outputs |
Sorted point cloud: The list of point clouds processed according to the sorting rules. |
Parameters
Sorting Attribute
Description |
Computes each cloud’s valid-point count, coordinate mean/median, or AABB/OBB center or size for sorting or filtering. |
Tuning Instructions |
Choose the attribute that best separates targets; center options also use Component Axis, while size options use Size Type. |
Parameter Range |
Options: Point Cloud Count, Point Cloud Mean, Point Cloud Median, Oriented Bounding Box Center, Axis-Aligned Bounding Box Center, Oriented Bounding Box Size, Axis-Aligned Bounding Box Size, Default: Point Cloud Count |
Parameter Range |
Values/Range:
Default: Point Cloud Count |
Attribute Component Axis
Description |
Selects the X, Y, or Z component used by mean, median, or bounding-box center. |
Tuning Instructions |
Changing the axis uses another coordinate component; it does not affect point-count or box-size attributes. |
Parameter Range |
Options: X-axis, Y-axis, Z-axis, Default: Z-axis |
Parameter Range |
Values/Range:
Default: Z Axis |
Sort Order
Description |
Orders clouds by the computed value from low to high or high to low. |
Tuning Instructions |
Choose “Low to High” for the smallest value first, or “High to Low” for the largest first. |
Parameter Range |
Options: Low to High, High to Low, Default: Low to High |
Parameter Range |
Values/Range:
Default: Low to High |
Keep All Results
Description |
When enabled, keeps every result; when disabled, keeps only the leading number set by Results to Keep. |
Tuning Instructions |
Enable for complete output; disable and set a count when only leading results are needed. |
Parameter Range |
Values/Range:
Default: True |
Number of Results to Keep
Description |
Number retained when Keep All Results is disabled. Sorting keeps the first N; clustering keeps the N largest clusters from each input cloud. |
Tuning Instructions |
Increase to retain more candidates; decrease to keep only earlier or larger results. |
Parameter Range |
[1, 100], Default: 1 |
Parameter Range |
Values/Range: [1, 100] Default: 1 |
Enable Node
Description |
When enabled, runs the node processing; when disabled, passes input clouds through unchanged. |
Tuning Instructions |
Disable to bypass the step during debugging; enable when its processed output is required. |
Parameter Range |
Default: True |
Sort Size Type
Description |
Defines the scalar derived from box size: an axis size, XY area, larger or smaller X/Y size, Z height, or aspect ratio. |
Tuning Instructions |
Used only with AABB or OBB Size; select the measure matching the target geometry. |
Parameter Range |
Options: X-axis size, Y-axis size, Z-axis size, X-axis size × Y-axis size, Length (larger of X/Y), Width (smaller of X/Y), Height (Z), Aspect ratio, Default: Z-axis size |
Parameter Range |
Values/Range:
Default: Z-axis size |