3D Blob

Operator Function

Find 3D point clusters in the input point cloud region; these clusters are called blobs, and output the center points of all selected blobs and the point sets within the blobs.

Input point cloud:

Output point cloud:

Parameter Introduction

Input Parameters

Parameter	Range	Default Value	Description	Illustration
Input Image	0-8	0	The IM number for image input

Calculation Parameters

Parameter	Range	Default Value	Description	Illustration
Use Region Parameters	true/false	false	If enabled, use Region as input; if not enabled, use Input Image as input
Region	2D Window/Box	Box	Manually select an appropriate ROI region Can bind to select existing ROI regions
Algorithm	Euclidean Clustering	Euclidean Clustering	Euclidean Clustering
Maximum Distance Threshold		0.500	The distance threshold to distinguish between two different blobs. If the distance between adjacent blobs is small, try reducing this value.
Minimum Points per Blob		1.000	The minimum number of points that each blob must contain; can be used to filter blobs.
Maximum Points per Blob		100000000.000	The maximum number of points that each blob can contain; can be used to filter blobs.
Sorting Method	No Sorting/Point Count/X/Y/Z	No Sorting	Point Count: Sort blobs based on the number of points in each blob. X: Sort blobs based on the centroid X coordinate of each blob. Y: Sort blobs based on the centroid Y coordinate of each blob. Z: Sort blobs based on the centroid Z coordinate of each blob.
Sorting Direction	Descending/Ascending	Ascending
Maximum Output Blob Count		5	Limit the maximum number of output blobs
Output Image	0-8	0	The IM number for image output

Result Display

Parameter	Range	Default Value	Description	Illustration
Point Set	true/false	false	Target point set; if enabled, displayed in the image
Center Point	true/false	false	Blob center; if enabled, displayed in the image
Sequence Number	true/false	false	Blob sequence number; if enabled, displayed in the image
ROI Point Set	true/false	false	Only effective when Use Region Parameters is selected; the point set of the ROI selected region; if enabled, displayed in the image

Output Parameters

Name	Type	Range	Description
Result	bool	true/false	true for success false for failure
Warning	bool	true/false	true indicates there is a warning false indicates there is none
Message	string		Outputs success, error, or warning information; if there is no error or warning, it is empty
Time	float		Operator execution time, unit: ms
blob_num	float		Number of blobs found
blobs	pointset[]		Point sets of the found blobs. Can be used for region binding in other operators
blob_center_points	point3d[]		Center coordinates of the found blobs

Tip

For more detailed explanations of parameter types, please refer to Type Definitions

Exception Troubleshooting

No.	Exception Information	Corresponding Parameter	Solution
1	The input value is {0}, invalid region type	Region Type	Only supports window2d, box, pointset
2	The input value is {0}, invalid maximum blob output...	Current blob count (equal to 0...)	Input blob count >= 0
3	The input value is {0}, invalid sorting method	Sorting Method	Only supports no sorting, point count, X, Y, Z sorting methods
4	The input value is {0}, invalid sorting direction	Sorting Direction	Only supports descending, ascending
5	Euclidean clustering failed		Check blob parameters for any values less than 0
6	Blob detection failed		Check the distance threshold parameter in blob parameters; if set too small
7	The input value is {0}, invalid blob search algorithm	Blob Search Algorithm	Only supports Euclidean cluster

Example Introduction

Engineering Design

1. Select the Load 3D Point Cloud tool to load the 3D point cloud image to be processed into IM0.

2. Select the 3D Blob tool.

Tool Usage

1. Select the input image for operation; the image number must match the IM number where the image is located in the project.

2. Select the region type as Box, move the box to the position to be measured, enclosing the point cloud to be measured.

Usage Tips

1. Use the ROI controller on the image window to drag or scale the box;
2. Directly modify the start or end coordinates of the box in the calculation parameters to adjust the box position and size;

3. Set parameters

4. Check the content you want to display in the result display section

5. Click Test to check if the image window and parameters meet expectations

6. If there are no issues, click Save, then run the operator in the run list to view the results in the corresponding IM