Basic Parameters for Depth Map and Point Cloud¶
The following table summarizes which categories of parameters are adjusted for the depth map and point cloud:
Depth map
Point Cloud
Note
Before proceeding, make sure you are familiar with the components and functions of the parameter panel.
The Beginner level parameters are basic parameters and are covered in this topic. The additional parameters in Expert and Guru levels are advanced parameters and are covered in the next topic.
3D Parameters¶
The parameters in this category affect the images used for calculating depth data, thus affecting the quality of the depth map and point cloud.
The Beginner level parameters in this category include Exposure Multiplier and Exposure Time.
Exposure Multiplier¶
This parameter sets the number of exposure times. If the value of Exposure Multiplier is greater than 1, multiple Exposure Time parameters must be set. You can set at most three exposure times.
All images captured with different exposure times are used for calculating depth.
Using multiple exposure times can improve the completeness of depth data but also increases processing time.
Exposure Time¶
This parameter sets the exposure time for capturing the images used for calculating depth data.
Usually, long exposure time is used for dark objects, and short exposure time is used for light objects.
Exposure time too long or too short both may cause loss of depth information in the depth map and point cloud.
Point clouds generated from images captured with different Exposure Time values (all other conditions identical):
Note
The exposure time of a laser camera must be a multiple of 4. The entered value is automatically adjusted.
The minimum value that can be set is 4 ms for the Laser series and 8 ms for other laser cameras.
Hint
Long exposure time(s) increases the capture time and thus may negatively affect the project cycle time. You can try using a larger value of Gain in combination with relatively short exposure time(s).
You can use Exposure Assistant to obtain the recommended values for 3D parameters. To open this tool, double click Auto Set next to 3D Parameters in the parameter panel or click .
UHP¶
Hint
This parameter category is only available for the UHP series.
Capture Mode¶
Set which 2D camera(s) is used for image capturing. A UHP camera contains two 2D cameras, the numbering below corresponds to that displayed in View 2D Camera and Set Parameters.
Option
Description
Camera1
Use Camera 1 to capture images.
Camera2
Use Camera 2 to capture images.
Merge
Use both 2D cameras to capture images. The depth map and point cloud are generated by merging the images. 2D images are captured by Camera 1.
Note
Only Camera1 mode supports setting an ROI.
Point Cloud Processing¶
The parameters in this category are used to process the generated point cloud. Please perform image capturing again after adjusting the parameters to see the result.
The Beginner level parameters in this category include Point Cloud Smoothing, Outlier Removal and Stripe Contrast Threshold.
Point Cloud Smoothing¶
This function reduces the depth fluctuation in the point cloud and improves its resemblance to the actual object surface.
The intensity levels of point cloud smoothing include Weak, Normal and Strong. Select Off to disable point cloud smoothing.
Note
Point cloud smoothing causes loss of object surface details. The more intense the smoothing, the more details are lost.
Point clouds generated with different smoothing intensities (all other conditions identical):
Off
Weak
Normal
Strong
Outlier Removal¶
This function reduces the amount of noise in the point cloud, thus reducing the impact on the precision and accuracy of subsequent calculation.
The intensity levels of outlier removal include Weak and Normal. Select Off to disable outlier removal.
Note
Outlier removal might remove some of the object point cloud. The more intense the outlier removal, the more object point cloud might be removed.
If this function removes the point cloud needed, please reduce the intensity. However, more noise will be retained.
Point clouds generated with different outlier removal intensities (all other conditions identical):
Off
Weak
Normal
Stripe Contrast Threshold¶
Increasing the value of this parameter can remove noise in the depth map and point cloud. However, the points of dark objects might be lost.
Note
It is recommended to adjust Point Cloud Smoothing and Outlier Removal first. If the level of noise is still high, please increase the value of this parameter.
The “stripe” in the parameter name refers to stripes in the structured light pattern captured in the images.
Point clouds generated with different Stripe Contrast Threshold values (all other conditions identical):
3
15
30
Depth Range¶
This parameter sets the depth range in the camera reference frame. Points outside this range are removed from the depth map and point cloud.
Hint
Adjusting this parameter simultaneously changes the max and min depth values in the depth map and point cloud display.
To set the depth range:
Double-click Edit next to Depth Range.
In the pop-up window, adjust the view of the point cloud and the depth range.
Adjust the view of the point cloud: Use the actions listed here to adjust the view. A good view allows you to see the two gray squares representing the lower and upper limits of the depth range and the obtained point cloud. All points between the two squares will be preserved.
Adjust the depth range: Drag the handles on the slider or enter the values in the text boxes. An appropriate range would sandwich all the desired points between the two gray squares while excluding unwanted points as much as possible.
Note
Click Recommended Range to automatically adjust the depth range to the recommended working distance of the camera model.
Click Reset to restore the last saved depth range.
Click Save to save the changes.
The same point cloud with different Depth Range values:
Note
If the depth range is too large, more noise are preserved. If the depth range is too small, points that are needed may be cut off.
Hint
You can use Depth Analyzer to check the depth map quality.
ROI¶
Set the ROI in the XY-plane for the depth map and point cloud. Points outside the selected region are removed.
To set an ROI:
Double-click Edit next to ROI.
Drag the cursor on the image to select an ROI. Adjust the size and position of the selection box if needed.
Note
For the LSR series, if the image displayed here is too bright/dark, please adjust the Monochrome Camera Exposure Mode parameter.
Click Apply to finish setting the ROI.
Hint
Click Clear to delete the set ROI.
Click or to perform image capturing. The obtained depth map and point cloud is now trimmed by the set ROI.
Hint
If the quality of the depth map and point cloud is still unsatisfactory after adjusting the parameters, you can save the camera raw data in the File menu and send it to Technical Support.
Continue reading for descriptions of the advanced parameters for the depth map and point cloud.