3D Hole

Operator Function

Starting from the center point of the ROI, search for edge points from the inside out; fit a 3D circle based on the found edge points.

Parameter Introduction

Input Parameters

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

Calculation Parameters

Parameter	Range	Default Value	Description	Illustration
Region	2D Window/Box	Box	Manually select appropriate ROI region Can bind to select existing ROI region
Output Geometry	3D Point/Circle	3D Point	3D Point: Output circle center point information Circle: Output circle information
Standard Deviation Multiple		4.000	Used to calculate the threshold coefficient for removing outliers. The smaller the standard deviation multiple value, the smaller the calculated distance threshold, and the more outliers will be removed. Recommended adjustment range is 1.0-2.0. Values less than 1.0 should be adjusted with caution as this may remove many valid points.

Result Display

Parameter	Range	Default Value	Description	Illustration
Edge Points	true/false	false	Target point set. If enabled, display in the image
Center Point	true/false	false	Circle center point. If enabled, display in the image
3D Circle	true/false	false	3D circle. If enabled, display in the image
ROI Point Set	true/false	false	Region point set selected by ROI box. If enabled, display 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 a warning false indicates no warning
Message	string		Output success, error, or warning messages. Empty if no error or warning.
Time	float		Operator execution time, unit: ms
hole_edge_points	pointset[]		Found hole edge point set
center_point	point3d[]		Found circle center point
circle	circle3d		Found circle

Exception Troubleshooting

No.	Exception Information	Corresponding Parameter	Solution
1	Input information is {0}, invalid region type	Region Type	Only window2d, box, pointset supported
2	Region is empty		1. Check if input points are empty 2. Check if ROI region selects point cloud 3. Check if specified pointset is empty
3	No hole detected		Check if standard deviation multiple in advanced parameters is too small, try increasing this value

Example Introduction

Engineering Design

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

2. Select the 3D Hole tool.

Tool Usage

1. Select the input image for the 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 area to be measured.

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

3. Set the 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. Run the operator in the run list, and then view the running results in the corresponding IM.