3D Contour Distance

Operator Function

Measure the distance between two points in the contour.

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
Region	1D Window	1D Window	Type: Only enabled in manual mode; set manually selected type: 1D Window Start Point: Only enabled in manual mode; input X, Z coordinates of start point End Point: Only enabled in manual mode; input X, Z coordinates of end point
Point Feature	Min X, Max X, Min Z, Max Z, Mean, Median, Inflection Point, Edge Point	Mean	Min X: Point with smallest X value among all points in region Max X: Point with largest X value among all points in region Min Z: Point with smallest Z value among all points in region Max Z: Point with largest Z value among all points in region Mean: Point formed by calculating X, Z average of all points in region Median: When point count in region is odd, take median point after sorting by X ascending; when even, take average of two median points Inflection Point: Where slope changes significantly on contour Edge Point: Feature points extracted based on adjacent point rise/fall and position after sorting contour left to right
Inflection Point Search Type	-X/+X/-Z/+Z	+Z	-X: Search for leftmost inflection point +X: Search for rightmost inflection point -Z: Search for bottommost inflection point +Z: Search for topmost inflection point
Noise Removal		0.000	Only enabled when feature point is Inflection Point Enable: If enabled, filter out inflection points with small jumps Threshold: Minimum difference to filter out interference points in Z direction
Edge Point Direction	Rising Edge/Falling Edge/Rising or Falling Edge	Rising or Falling Edge	Only enabled when feature point is Edge Point Rising Edge: Search in rising direction from left to right along contour Falling Edge: Search in falling direction from left to right along contour Rising or Falling Edge: Search in rising or falling direction from left to right
Edge Point Position	First/Last/Best	Best	Only enabled when feature point is Edge Point First: First edge point meeting requirements from left to right on contour Last: Last edge point meeting requirements from left to right on contour Best: Edge point with largest height difference among those meeting requirements from left to right

Result Display

Parameter	Range	Default Value	Description	Illustration
Point 1	true/false	false	If enabled, display Point 1 in the image
Point 2	true/false	false	If enabled, display Point 2 in the image
Connection Segment	true/false	false	If enabled, display connection segment in the image
X-direction Segment	true/false	false	If enabled, display X-direction segment in the image
Z-direction Segment	true/false	false	If enabled, display Z-direction segment in the image
Connection Measurement	true/false	false	Connection measurement value; if enabled, displayed in the image
X-direction Measurement	true/false	false	X-direction measurement value; if enabled, displayed in the image
Z-direction Measurement	true/false	false	Z-direction measurement value; 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
lines_distance	float		Output connection distance
distance_in_x_direction	float		Output X-direction distance
distance_in_z_direction	float		Output Z-direction distance

Tip

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

Exception Troubleshooting

No.	Exception Information	Corresponding Parameter	Solution
1	Failed to get feature points in crop region		Adjust start and end parameters of point acquisition region to ensure valid points exist in selected area
2	Input region type is {0}, invalid region type	Region Type	Input region type must be 1D Window
3	Error getting region for Point 1		Adjust start and end parameters of Point 1 acquisition region to ensure valid points exist in selected area
4	Error getting region for Point 2		Adjust start and end parameters of Point 2 acquisition region to ensure valid points exist in selected area
5	Point 1 parameters invalid		Adjust feature point type or related parameters
6	No inflection point found		Adjust inflection point related parameters
7	No edge point found		Adjust edge point related parameters
8	Input reference point feature type is {0}, invalid feature point type	Geometry Type	Select feature type as Point
9	Point 2 parameters invalid		Adjust feature point type or related parameters

Example Introduction

Engineering Design

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

2. Select the 3D Contour Extraction tool to extract contours into IM1, IM2, IM3 respectively.

3. Select the 3D Contour Distance tool to measure contour distances with different point features.

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. Move the window to the position to be measured, enclosing the area where points need to be acquired.

Usage Tips

1. Use the ROI controller on the image window to drag or scale the window;
2. Directly modify the start or end coordinates of the window in the calculation parameters to adjust the window 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