3D Plane Surface Profile

Operator Function

Calculate geometric tolerance - Plane Surface Profile
As shown in the figure below, calculate the distance from theoretical points to the actual plane, sort from largest to smallest, denoted as 𝑑1, 𝑑2, ..., 𝑑n. The surface profile calculation formula is:
2 × 𝑚𝑎𝑥(𝑑1, 𝑑2, ..., 𝑑n)

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 Plane	Plane	-	A point on the actual plane and its normal vector
Theoretical Plane	json file	-	Theoretical plane file
Fit Point Cloud	true/false	false	When enabled, the point cloud fitting function is used. The theoretical plane fits the selected point cloud as closely as possible
Use Region Parameters	true/false	false	Enable when fitting point cloud. When enabled, point cloud selection is activated; when disabled, the entire IM point cloud is selected
Region	2D Window/2D Circular Window/2D Polygon Window/Box/Cylindrical Box/Rotated Box/Point Set (binding only)	Box	Manually select the point cloud to be fitted
Theoretical Plane Fitting Method	Least Squares/RANSAC	Least Squares	Use the corresponding algorithm to fit the plane
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	1000	Set the maximum number of iterations

Result Display

Parameter	Range	Default Value	Description	Illustration
Actual Plane	true/false	false	The input actual plane. If enabled, displayed on IM
Theoretical Plane	true/false	false	The input theoretical plane. If enabled, displayed on IM
Theoretical Points to Actual Plane Perpendicular Feet and Theoretical Plane Points	true/false	false	Displays two sets of points: the input measurement points and the perpendicular feet from the measurement points to the actual plane, and the input theoretical plane points. If enabled, displayed on IM
Theoretical Points and Actual Plane Perpendicular Foot Connections	true/false	false	The connections from the input theoretical points to their perpendicular feet on the actual plane. If enabled, displayed on IM
Surface Profile	true/false	false	The output surface profile. If enabled, displayed on IM

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
theoretical_plane	plane		Distance from measurement points to the reference plane
profile_of_surface	float		Surface profile
result	string	OK/NG	Whether the surface profile is within range

Tip

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

Exception Troubleshooting

No.	Exception Information	Corresponding Parameter	Solution
1	Input point cloud is empty		Confirm whether the IM contains valid points. If not, load a point cloud or switch to an IM with valid points
2	Input actual plane type is {0}, invalid plane type	Plane Type	Check if the plane type is Plane
3	Input theoretical plane fitting method is {0}, invalid fitting method	Fitting Method	Check if the fitting method is Least Squares/RANSAC
4	Input actual plane normal vector is invalid		Check if the plane normal vector is all zeros
5	Input profile range minimum is greater than maximum, invalid profile range		Set the profile range minimum to be less than or equal to the maximum
6	Parameter {0} cannot be empty	Path	Check if the path is empty
7	File {0} does not exist or cannot be accessed	Path	Check if the path is valid
8	Input theoretical plane point cloud is empty		Check if the theoretical position point json file is empty
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 Square Probe tool to fit the actual plane.

3. Select the 3D Plane Surface Profile 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.