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:

  • 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

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:

  • X Axis

  • Y Axis

  • Z Axis

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:

  • Low to High

  • High to Low

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:

  • True

  • False

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:

  • 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