Point Cloud Bounding Box

Description

This operator calculates a 3D bounding box for each input point cloud and outputs the geometric information of the bounding box.

Two types of bounding boxes are available:

  • Axis-Aligned Bounding Box (AABB): The faces of the bounding box are parallel to the X, Y, and Z axes of the coordinate system. The calculation is simple and fast, suitable for cases where the object orientation is roughly aligned with the coordinate axes.

  • Oriented Bounding Box (OBB): The direction of the bounding box is determined by the principal direction of the point cloud itself, allowing for a tighter enclosure of objects with arbitrary orientations.

Overview

Calculates and outputs either an axis-aligned bounding box or an oriented minimum bounding box for input point clouds.

Scenarios

  • Object Size and Position Estimation: Obtaining the 3D dimensions and center position of the object represented by the point cloud.

  • Rough Pose Estimation: OBB can provide object orientation information.

  • Spatial Occupancy Analysis: Determining the approximate range occupied by the object in space.

  • ROI Generation: Quickly generating regions enclosing point clouds for subsequent finer processing.

  • Collision Detection: Using simple AABB or tighter OBB for preliminary collision judgment.

Inputs and Outputs

Inputs

Point Cloud: The input point cloud or list of point clouds. If it is a list, the bounding box is calculated independently for each point cloud in the list. The operator internally attempts to remove NaN values from the point cloud before calculation.

Outputs

Bounding Box Normal: A list of calculated OBB normals in N×3 format (N bounding boxes, each normal has three xyz components).

Bounding Box Center: A list of center points of each bounding box in N×3 format (N bounding boxes, each center has xyz coordinates). The calculation method is determined by the 'Center Type' parameter.

Bounding Box: A list of detailed information for each bounding box, including center coordinates, size, and 3×3 rotation matrix, in the format [{center: [cx, cy, cz], size: [sx, sy, sz], transform: [[3×3 matrix]]}].

Bounding Box Size: A list of X, Y, Z dimensions of each bounding box along its principal axes, in N×3 format (N bounding boxes).

3D ROI: A list of 3D ROIs generated from the bounding boxes, possibly adjusted by scaling, in the format [{min: [min_x, min_y, min_z], max: [max_x, max_y, max_z], transform: cam2ROIFrame}].

Bounding Box Corner Points: A list of 8 corner point coordinates for each bounding box, in N×8×3 format (N bounding boxes, 8 corner points per box, each corner has three xyz coordinates).

Parameters

Calculation Method

Description

Point cloud bounding box calculation method.

Parameter Range

Values/Range:

  • Oriented Bounding Box (OBB)

  • Axis-Aligned Bounding Box (AABB)

Default: Oriented Bounding Box (OBB)

Center Point Type

Description

Select how the output "Bounding Box Center" is calculated.

Tuning Instructions

  • Bounding Box Center (Default): Directly uses the geometric center of the calculated AABB or OBB.

  • Point Cloud Mean: Uses the mean XYZ coordinates of the original point cloud forming the bounding box.

  • Point Cloud Median: Uses the median XYZ coordinates of the original point cloud forming the bounding box, which is more robust to outliers.

Parameter Range

Default: Bounding Box Center

Parameter Range

Values/Range:

  • Point Cloud Mean

  • Point Cloud Median

  • Bounding Box Center

Default: Bounding Box Center

Normal Z Direction

Description

Specifies whether the normal faces the positive or negative Z-axis direction.

Parameter Range

Values/Range:

  • Positive Z

  • Negative Z

Default: Positive Z

Padding Method

Description

If set to "fixed value", subtracts the padding range from the ROI/bounding box minimum and adds it to the maximum to expand or shrink the range. If set to "ratio", scales each axis (X, Y, Z) proportionally.

Parameter Range

Values/Range:

  • Specified Value

  • Specified Ratio

  • No Scaling Allowed

Default: No Scaling Allowed

X Padding Range

Description

X-axis padding range. Subtracts this value from the X minimum and adds it to the X maximum of the ROI and bounding box to expand or shrink the range.

Parameter Range

Values/Range: [-5000, 10000]

Default: 0.0

Unit: mm

Y Padding Range

Description

Y-axis padding range. Subtracts this value from the Y minimum and adds it to the Y maximum of the ROI and bounding box to expand or shrink the range.

Parameter Range

Values/Range: [-5000, 10000]

Default: 0.0

Unit: mm

Z Padding Range

Description

Z-axis padding range. Subtracts this value from the Z minimum and adds it to the Z maximum of the ROI and bounding box to expand or shrink the range.

Parameter Range

Values/Range: [-5000, 10000]

Default: 0.0

Unit: mm

X Padding Ratio

Description

X-axis scale ratio. Scales the X dimension of the ROI and bounding box proportionally.

Parameter Range

Values/Range: [0, 5]

Default: 1

Unit: mm

Y Padding Ratio

Description

Y-axis scale ratio. Scales the Y dimension of the ROI and bounding box proportionally.

Parameter Range

Values/Range: [0, 5]

Default: 1

Unit: mm

Z Padding Ratio

Description

Z-axis scale ratio. Scales the Z dimension of the ROI and bounding box proportionally.

Parameter Range

Values/Range: [0, 5]

Default: 1

Unit: mm