From Depth Map to Point Cloud

Function

This Step generates a point cloud from a depth map and a corresponding color image.

../../../../../_images/functional_description9.png

Usage Scenario

This Step is usually connected after the Step Capture Images from Camera and can generate point clouds from depth maps. You can set an ROI in the depth map in this Step to improve the processing speed.

Input and Output

../../../../../_images/input_output_10.png

Parameter Description

Depth Roi File Name
Description: Select an ROI on the depth map.
Example: Select different ROIs.
../../../../../_images/turn_depth_into_point_clouds1.png

The image on the left shows ROI in an depth map, and the image on the right shows the output point cloud.

Instructions:

  1. Click the Set 2D ROI on the right of the parameter Depth Roi File Name to open the Set ROI window.

  2. Select an ROI in the window.

  3. Click OK to save the setting. A depth_image_roi.json will be saved to the root directory of the project.

Background Removal Settings

Remove Background by Depth Image
Default setting: Unselect
Description: The following parameters will only be displayed only Remove Background by Depth Image is selected.
Depth Background Filename
Instructions: Please follow the instructions as follows to set a depth map of the background.

Click Set 2D Background button on the right of the Depth Background Filename to open the Set Background window.

../../../../../_images/turn_depth_into_point_clouds2.png

Click … and then select an image of the background that you have already prepared. Once the message Load background successfully message appears in the Log Messages panel, click OK.

../../../../../_images/turn_depth_into_point_clouds3.png

Hint

You can also connect to the real camera and capture an image of the background on site.

Variation of Background Depth
Default setting: 10.000 mm
Description: The input depth map will be compared with the depth map of the background, and points with a depth difference from the background lower than this value will be eliminated.
Example: In the figure below, the background of image 1 has not been removed; backgrounds of images 2, 3, and 4 have been removed and the Variation of Background Depth are set to 1mm, 10mm, and 30mm respectively.
../../../../../_images/turn_depth_into_point_clouds4.png

If the value of background depth fluctuation is too small, the background cannot be removed completely. If the value of background depth fluctuation is too large, the point cloud of the object may be removed as well. Therefore, the Variation of Background Depth should be set to a proper value according to actual requirements on site, and 10mm is recommended to use.

Note

Capture Images from Camera can also output point cloud and color point cloud. However, to accelerate project running, please use this Step to obtain point cloud and color point cloud. Also, setting an ROI in this Step will avoid generating unnecessary point cloud parts and therefore improve the processing speed as well.