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:
Default: Oriented Bounding Box (OBB) |
Center Point Type
Description |
Select how the output "Bounding Box Center" is calculated. |
Tuning Instructions |
|
Parameter Range |
Default: Bounding Box Center |
Parameter Range |
Values/Range:
Default: Bounding Box Center |
Normal Z Direction
Description |
Specifies whether the normal faces the positive or negative Z-axis direction. |
Parameter Range |
Values/Range:
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:
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 |