3D Multi-Height

Operator Function

Uses selected filtering methods to calculate the height of input regions. Available height output options include minimum, maximum, mean, median, and percentile.

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
Number of Regions		2	Set the number of regions for height measurement
Outlier Removal	Percentile Filter	Percentile Filter	Calculate high and low percentiles based on input percentage, retaining only point clouds that meet conditions between these two values
Low Removal Percentage		10.000	Calculate low threshold in Z direction based on input percentage, removing all points below this threshold
High Removal Percentage		10.000	Calculate high threshold in Z direction based on input percentage, removing all points above this threshold
Height Mode	Minimum/Maximum/Median/Mean/Percentile	Mean	Minimum: Output minimum height value of all points in the region Maximum: Output maximum height value of all points in the region Mean: Output mean height value of all points in the region Median: Output median height value of all points in the region Percentile: Output height value at the a-th percentile, where a is the input percentage
Region n	2D Window/Box	Box	Manually select appropriate ROI region Can bind to select existing ROI region

Result Display

Parameter	Range	Default Value	Description	Illustration
Height Measurement Points	true/false	false	Height position points. If enabled, display in the image
Point Set	true/false	false	Region point set. If enabled, display in the image
Height	true/false	false	Height information. 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
region_height	float[]		Region height array

Exception Troubleshooting

No.	Exception Information	Corresponding Parameter	Solution
1	Input point cloud is empty		Check if input point cloud is empty
2	Input value is {0}, invalid height mode		Only Minimum, Maximum, Mean, Median, Percentile supported
3	High and low percentages cannot both be 50%		Adjust high and low percentages, cannot both be 50
4	Failure count: {0}.	Failure count	Check if all ROIs select point clouds

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 Region Operation tool to set regions for the next step of plane fitting.

3. Select the 3D Plane Fitting tool, bind the regions set in the previous step, and fit a plane as the zero plane.

4. Select the 3D Multi-Height 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. Set the number of regions, select the region type as Box, move the box to the position to be measured, enclosing the point cloud to be tested.

Usage 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.