3D Point Position

Operator Function

Calculate geometric tolerance - Point Position
As shown in the figure below, the point position is the distance from the actual circle center to the theoretical circle center

Parameter Introduction

Input Parameters

Parameter	Range	Default Value	Description	Illustration
Input Image	0-31	0	The IM number for image input
3D Reference			You can select a reference via binding
X			X-coordinate value of the 3D reference parameter; can be set via binding to X
Y			Y-coordinate value of the 3D reference parameter; can be set via binding to Y
Z			Z-coordinate value of the 3D reference parameter; can be set via binding to Z
X-Axis Angle	-10000000000.000-10000000000.000		X-axis angle value of the 3D reference parameter; can be set via binding for X-Axis Angle
Y-axis angle	-10000000000.000-10000000000.000		3D reference parameter Y-axis angle value; can be set via binding Y-axis angle
Z-axis angle	-10000000000.000-10000000000.000		3D reference parameter Z-axis angle value; can be set via the Z-axis angle binding

Calculation Parameters

Parameter	Range	Default Value	Description	Illustration
Actual Position	3D Circle	-	Actual fitted 3D circle
Theoretical Position	json file	-	Measurement point file on the plane being tested
Fit Point Cloud	true/false	false	Translate the theoretical position points to the region that best fits the selected point cloud, minimizing the measurement value. See Fit Settings
Use Region Parameters	true/false	false	If enabled, use Region as input; if disabled, use Input Image as input
Region	2D Window/2D Circular Window/2D Polygon Window/Box/Cylindrical Box/Rotated Box/Point Set	Box	Manually select an appropriate ROI region You can select an existing ROI region via binding
Fitting Method	Least Squares/RANSAC	Least Squares	Select the circle fitting method
Distance Threshold	0.0-50.0	0.02	Select an appropriate distance threshold. When there are many noise points, increase this parameter; when there are few noise points, decrease it
Max Iterations	100-10000	500	Set the maximum number of iterations

Fit Settings

Parameter	Range	Default Value	Description	Illustration
Iterations	1-2000	500	Maximum number of calculations during iteration
Expected Error	0.00001-1000000	0.00001	Sum of distance errors from points to the circle. When the expected error value is reached, iteration stops
Step Size	0.00001-1000000	0.00001	The length of each point movement during iteration

Result Display

Parameter	Range	Default Value	Description	Illustration
Actual Plane	true/false	false	The input actual plane. If enabled, displayed on IM
Reference Line	true/false	false	The input reference line. If enabled, displayed on IM
Intersection	true/false	false	Displays two sets of points: the input measurement points and the perpendicular feet from the measurement points to the actual plane. If enabled, displayed on IM
Measurement Points and Fitted Reference Plane Intersection Connections	true/false	false	The connections from the input measurement points to their perpendicular feet on the actual plane. If enabled, displayed on IM
Parallelism	true/false	false	The output parallelism. If enabled, displayed on IM
result	string	OK/NG	Whether the parallelism is within range

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
positional_degree	float		Position degree

Tip

For more detailed parameter type descriptions, please refer to Type Definition

Exception Troubleshooting

No.	Exception Information	Corresponding Parameter	Solution
1	Input point cloud has fewer than 3 points		Confirm whether the IM contains at least three valid points. If fewer than 3 valid points, load a point cloud or switch to an IM with at least 3 valid points
2	Input actual position circle type is {0}, invalid type	Actual Position Type	Check if the plane type is 3D Circle
3	Parameter {0} cannot be empty	Path	Check if the path is empty
4	File {0} does not exist or cannot be accessed	Path	Check if the path is valid
5	Input theoretical position point cloud is empty		Check if the theoretical position point json file is empty
6	Input perpendicularity range minimum is greater than maximum, invalid perpendicularity range		Set the perpendicularity range minimum to be less than or equal to the maximum
7	Input fitting method is {0}, invalid fitting method	Fitting Method	Input fitting method should be Least Squares/RANSAC
8	RANSAC circle fitting failed		Adjust RANSAC parameters: distance threshold
9	Input region type is {0}, invalid region type	Region Type	Check if the region type is one of 2D Window/2D Circular Window/2D Polygon Window/Box/Cylindrical Box/Rotated Box/Point Set
10	Input polygon has fewer than 3 vertices, cannot form a polygon		Add 2D polygon window vertices to make the number of vertices at least 3
11	Input region point cloud is empty		1. Check if the selection is empty 2. Check if the point set is empty

Example Introduction

Engineering Design

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

2. Select the 3D Circle tool to fit a 3D circle.

3. Select the 3D Point Position tool.

Tool Usage

1. Select the input image to be operated on. The image number must match the IM number of the image in the project.

2. Do not enable region parameters, or enable region and select the region type as Box. Move the box to the position to be tested, surrounding the point cloud to be tested.

Usage Tips

1. Drag or scale the box through the ROI controller on the image window;
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 desired display content 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 to view the running results in the corresponding IM.