3D Point Cloud Crop

Operator Function

Output the cropped point cloud based on the input crop mode, crop range, and crop options.

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
Mode	X-Range Crop/Y-Range Crop/Z-Range Crop/Region/Copy Entire Point Cloud	X-Range Crop	Set crop mode
X-Range Crop			Crop based on point cloud's X coordinates
Y-Range Crop			Crop based on point cloud's Y coordinates
Z-Range Crop			Crop based on point cloud's Z coordinates
Region			Crop based on point cloud's X, Y or X, Y, Z coordinates
Copy Entire Point Cloud			Simply make a copy of the input image, can copy input image to another image register.
Invert Crop	true/false	false	If checked, keep point cloud outside ROI.
Remove Invalid Values in Organized Point Cloud	true/false	true	If checked, remove invalid points in point cloud.
Output Image	0-8	0	The IM number for image output

Result Display

Parameter	Range	Default Value	Description	Illustration
ROI Point Set	true/false	false	Point set of ROI selected region; 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

Exception Troubleshooting

No.	Exception Information	Corresponding Parameter	Solution
1	The input value is {0}, invalid region type	Region Type	Only supports window2d, box, pointset
2	The input value is {0}, invalid crop mode	Crop Mode	Only supports X-Range, Y-Range, Z-Range, Region
3	Region crop failed		1. Check if input points are empty 2. Check if ROI region encloses any points 3. Check if bound pointset is empty
4	Output point cloud is empty! Please modify parameters		1. Check if input points are empty 2. Check if ROI position encloses any points 3. Check if point cloud contains invalid values

Example Introduction

Engineering Design

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

2. Select the 3D Point Cloud Crop tool.

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. Set crop mode (set X/Y/Z range crop, region crop, copy entire point cloud respectively)

3. Set parameters

4. Click Test to check if the image window and parameters meet expectations

5. If there are no issues, click Save, then run the operator in the run list to view the results in the corresponding IM