Profile Mode
This topic provides descriptions of the parameters in the profile mode.
Brightness Settings
Parameters in this category affect the brightness of the laser lines in the raw image, thus affecting the quality of the profile, intensity image, and depth map.
-
The grayscale values of the pixels at the center of the laser lines should be between 200 and 255.
-
The recommended order of adjusting parameters is: Exposure Time > Analog Gain > Digital Gain or Laser Power
Exposure Mode
Description |
Select the exposure mode for acquiring the raw image based on the color and texture of the target object. |
---|---|
Visibility |
Beginner, Expert, Guru |
Values |
|
Instruction |
After selecting different options, different parameters are displayed in the Brightness Settings category for adjustment:
|
Exposure Time
Description |
Set the exposure time for acquiring the raw image. Exposure time affects the brightness and width of the laser lines in the raw image, as well as the max scan rate of the laser profiler. Longer exposure time results in brighter and wider laser lines and lower max scan rate. Shorter exposure time results in darker and narrower laser lines and higher max scan rate. |
||
---|---|---|---|
Visibility |
Beginner, Expert, Guru |
||
Values |
|
||
Instruction |
|
You can check the current max scan rate of the laser profiler in the upper right of the data display area. |
Raw images obtained with different Exposure Time values (all other conditions identical):
Exposure time: 40 μs |
|
---|---|
Exposure time: 200 μs |
|
Exposure time: 1500 μs |
HDR Exposure Settings
Description |
Set the exposure time for acquiring the raw image. Exposure time affects the brightness and width of the laser lines in the raw image, as well as the max scan rate of the laser profiler. Longer exposure time results in brighter and wider laser lines and lower max scan rate. Shorter exposure time results in darker and narrower laser lines and higher max scan rate. |
||
---|---|---|---|
Visibility |
Beginner, Expert, Guru |
||
Values |
|
||
Instruction |
For detailed instructions, refer to Adjust HDR Exposure Settings below.
|
You can check the current max scan rate of the laser profiler in the upper right of the data display area. |
Adjust HDR Exposure Settings
In the HDR exposure mode, each exposure is divided into three phases to ensure that, in the raw image, laser lines reflected by regions of different textures or colors can all achieve appropriate brightness.
In the HDR exposure mode, the total exposure time is determined by using the timed exposure mode.
Follow these steps to adjust the HDR exposure settings:
-
In the profile mode, find the region with the most complex textures or colors on the target object surface and acquire data.
-
Set Exposure Mode to Timed and adjust Exposure Time, until the brightness of the laser line reflected by the region least likely to overexpose on the target object meets the requirement. The value of Exposure Time when the brightness of this laser line meets the requirement is the value that should be set for Total exposure time in HDR Exposure Settings.
-
Set Exposure Mode to HDR and double-click Edit to the right of HDR Exposure Settings to open the HDR Exposure Settings window.
-
In Total exposure time, enter the exposure time determined in step 2.
-
Select Use built-in settings, and then select a value in the drop-down list.
-
Click Apply to close the current window. In the profile mode, acquire data again and check the brightness of the laser lines in the raw image.
-
If the brightness of the laser lines meets the requirement, the process is completed.
-
If the brightness of the laser lines does not meet the requirement, double-click Edit to the right of HDR Exposure Settings to open the HDR Exposure Settings window. and select another built-in settings value.
If none of the built-in settings meets the requirement, select Customize, and click Apply. Then, go to the next step.
-
-
Set Exposure Mode to Timed and adjust Exposure Time, until the laser line reflected by the region most likely to overexpose on the target object is just visible in the raw image. The current value of Exposure Time is the value that should be set for Exposure time 3 in HDR Exposure Settings.
-
Set Exposure Mode to HDR and double-click Edit to the right of HDR Exposure Settings to open the HDR Exposure Settings window.
-
Adjust Expected proportions until the value of Exposure time 3 roughly matches the exposure time determined in step 2.
The exposure times of the three exposure phases should satisfy: Exposure time 1 > Exposure time 2 > Exposure time 3.
If after step 9, the above relationship is not satisfied, adjust Expected proportions again.
-
Click Apply to close the current window. In the profile mode, acquire data again and check the brightness of the laser lines in the raw image.
-
If the brightness of the laser lines meets the requirement, the process is completed.
-
If the laser lines still have overexposed parts, please try the following solutions:
-
Increase the proportion of Exposure time 1 slightly or decrease the proportion of Exposure time 3 slightly.
-
Decrease First threshold or Second threshold (available in the Administrator account).
-
-
Analog Gain
Description |
Increasing this parameter can enhance the brightness of the raw image. However, noise will also be introduced. |
||
---|---|---|---|
Visibility |
Beginner, Expert, Guru |
||
Values |
|
||
Instruction |
|
Raw images acquired with different Analog Gain values (all other conditions identical):
Analog Gain: 1.0 |
|
---|---|
Analog Gain: 2.8 |
Digital Gain
Description |
Increasing this parameter can enhance the brightness of the raw image. However, a relatively large amount of noise will also be introduced.
|
||
---|---|---|---|
Visibility |
Expert, Guru |
||
Values |
|
||
Instruction |
If Analog Gain has reached its maximum value, but the laser lines are still too dark, you can increase Digital Gain. |
The value of Digital Gain affects the minimum value of Min Grayscale Value:
|
Raw images acquired with different Digital Gain values (all other conditions identical):
Digital Gain: 0 |
|
---|---|
Digital Gain: 5 |
Laser Power
Description |
Set the power of the emitted laser light, which affects the brightness of the laser lines in the raw image. |
||
---|---|---|---|
Visibility |
Expert, Guru |
||
Values |
|
||
Instruction |
If the object is reflective or light-colored, you can decrease this parameter to reduce the brightness of the laser lines. If the object is non-reflective or dark-colored, you can increase this parameter to enhance the brightness of the laser lines.
|
Raw images obtained with different Laser Power values (all other conditions identical):
Laser Power: 50 |
|
---|---|
Laser Power: 100 |
ROI
Set ROI.
Z-Direction ROI
Description |
A Z-direction ROI retains only the middle part of the raw image and trims the top and bottom parts off. Setting a Z-direction ROI can reduce the amount of data to be processed and enhance the max scan rate. |
---|---|
Visibility |
Beginner, Expert, Guru |
Values |
The options are the ratio of the height of the trimmed image to the height of the untrimmed image.
|
Instruction |
The Z-direction ROI reduces the height of the raw image without altering its width. Please adjust this parameter based on the region where the laser lines are, ensuring that the needed laser lines are not trimmed off. |
Raw images obtained with different Z-Direction ROI values (all other conditions identical):
Z-Direction ROI: 1 | Z-Direction ROI: 1/2 | Z-Direction ROI:1/4 |
---|---|---|
Profile Extraction
The parameters in this category affect the extraction of the profile.
Min Grayscale Value
Description |
Set the minimum grayscale value of the valid pixels in the raw image. Pixels with grayscale values smaller than this value will not participate in profile extraction.
|
||
---|---|---|---|
Visibility |
Expert, Guru |
||
Values |
|
||
Instruction |
This parameter determines the number of valid pixels in each pixel column of each laser line and affects the laser line width. |
The minimum value of Min Grayscale Value is affected by the value of Digital Gain:
|
Profile extraction results with different Min Grayscale Value values (all other conditions identical):
Min Grayscale Value: 20 |
|
---|---|
Min Grayscale Value: 50 |
|
Min Grayscale Value: 70 |
Min Laser Line Width
Laser line width is a property of each pixel column in a laser line. It is equal to the number of valid pixels in such a pixel column.
In the figure below, this column of this laser line has 4 valid pixels, so the laser line width of this pixel column is 4.
Description |
Set the minimum width for the laser lines. If the width of a pixel column in a laser line is smaller than this value, this pixel column in this laser line does not participate in profile extraction. |
---|---|
Visibility |
Beginner, Expert, Guru |
Values |
|
Instruction |
Setting appropriate minimum and maximum widths can exclude the laser lines produced by stray light or interreflection, which are usually too wide or too narrow. |
Max Laser Line Width
Laser line width is a property of each pixel column in a laser line. It is equal to the number of valid pixels in such a pixel column.
In the figure below, this column of this laser line has 4 valid pixels, so the laser line width of this pixel column is 4.
Description |
Set the maximum width for the laser lines. If the width of a pixel column in a laser line is greater than this value, this pixel column in this laser line does not participate in profile extraction. |
---|---|
Visibility |
Beginner, Expert, Guru |
Values |
|
Instruction |
Setting appropriate minimum and maximum widths can exclude the laser lines produced by stray light or interreflection, which are usually too wide or too narrow. |
Spot Selection
Description |
If a pixel column contains multiple laser lines, the laser line used for profile extraction is selected according to the value of this parameter. |
---|---|
Visibility |
Beginner, Expert, Guru |
Values |
|
Instruction |
Adjust this parameter based on the actual needs. |
Edge Selection
Description |
Select the location for extracting the profile in each laser line. |
---|---|
Visibility |
Expert, Guru |
Values |
|
Instruction |
Adjust this parameter based on the characteristics of the target object and the similarity between the profile and the actual object.
|
Min Sharpness
Description |
Set the minimum sharpness of the laser lines. Sharpness is the clearness of the edges of a laser line. |
---|---|
Visibility |
Expert, Guru |
Values |
|
Instruction |
Increasing this parameter can exclude the laser lines produced by stray light or interreflection, which are usually too dark and blurry. |
Profile Processing
The parameters in this category process the extracted profile, improving the quality of the profile.
Filter
Description |
Set the type of filters. Filtering the profile can reduce noise and smooth the profile. |
---|---|
Visibility |
Beginner, Expert, Guru |
Values |
|
Instruction |
Adjust based on the actual needs. |
Mean Filter Window Size
Description |
Set the window size of the mean filter. This parameter should be set when Filter is set to Mean. |
---|---|
Visibility |
Beginner, Expert, Guru |
Values |
|
Instruction |
Larger window size results in higher intensity of smoothing but may also distort object features. |
Profile extraction results with different Mean Filter Window Size values (all other conditions identical):
No filter used |
|
---|---|
Mean Filter Window Size: 2 |
|
Mean Filter Window Size: 8 |
|
Mean Filter Window Size: 32 |
Median Filter Window Size
Description |
Set the window size of the median filter. This parameter should be set when Filter is set to Median. |
---|---|
Visibility |
Beginner, Expert, Guru |
Values |
|
Instruction |
Larger window size removes more noise. |
Profile extraction results with different Median Filter Window Size values (all other conditions identical):
No filter used |
|
---|---|
Median Filter Window Size: 5 |
|
Median Filter Window Size: 9 |
Gap Filling
Description |
Set the size of the gaps that can be filled in the profile. When the number of consecutive data points in a gap in the profile is no greater than this value, this gap will be filled. The data used for filling is calculated based on the difference between the two neighboring points (that is, based on linear interpolation). |
||
---|---|---|---|
Visibility |
Beginner, Expert, Guru |
||
Values |
|
||
Instruction |
Adjust based on the size of the gaps to be filled.
|
Raw images obtained with different Gap Filling values (all other conditions identical):
Gap Filling: 0 |
|
---|---|
Gap Filling: 5 |
Gap Filling Edge Preservation
Description |
Set the degree of preservation of object edges when filling gaps. |
---|---|
Visibility |
Beginner, Expert, Guru |
Values |
|
Instruction |
If you need to preserve features with abrupt depth variations, such as object edges, you can increase this parameter, but the amount of gaps being filled will decrease. |
Resampling
Description |
Select the point to be retained during resampling. Multiple points with different Z values may exist at the same location on the X-axis. This parameter is used to select the point to be retained in such a situation. The following figure shows two typical scenarios:
|
---|---|
Visibility |
Expert, Guru |
Values |
|
Instruction |
Adjust this parameter based on the height of the needed features. If the needed feature is at the bottom of the target object (such as the inner bottom of a cylindrical container), you can select Farthest. |
Resampling Edge Preservation
Description |
Set the degree of preservation of object edges during resampling. |
---|---|
Visibility |
Expert, Guru |
Values |
|
Instruction |
If you need to preserve features with abrupt depth variations, such as object edges, you can increase this parameter. |
Mask
Description |
Use masks to exclude unneeded data, such as noise and laser lines produced by interreflection. |
---|---|
Visibility |
Beginner, Expert, Guru |
Values |
Enable Mask:
|
Instruction |
Double-click Edit to open the Mask Tool window. For detailed instructions, refer to Use Mask Tool below. |
Use Mask Tool
Through the mask tool, you can add, edit, and delete masks.
Add Masks
Follow these steps to add masks:
-
Select the appropriate tool in the toolbar on the left:
-
: used to add a rectangle mask.
-
: used to add a polygon mask.
-
-
Determine the location of the unneeded data in the raw image and draw a mask:
-
Rectangle mask: Hold and drag.
-
Polygon mask: Click to add a vertex of the polygon mask. After all needed vertices are added, press the Enter key or right-click to finish drawing the polygon mask.
In a polygon mask, the overlapped regions are not effective:
-
Click Acquire again at the top to acquire the raw image after the masks are added to check the effect of the masks.
-
If the position, shape, or size of the masks are not satisfactory, you can edit the masks or delete the masks.
-
-
-
After all masks are added, click Apply to close the current window.
After Apply is clicked, the value of the Enable Mask parameter is automatically changed to True. If you do not need to apply the masks, change the value of this parameter to False.
Edit Masks
If the position, shape, or size of the masks are not satisfactory, follow these steps to edit the masks:
-
Click in the toolbar on the left.
-
Select the mask that needs to be edited and conduct the needed adjustment:
-
Move a mask: Select the mask and drag.
-
Adjust the size of a rectangle mask: Select a vertex of the rectangle mask and drag.
-
Adjust the shape of a polygon mask:
-
Move an existing vertex: Select a vertex of the polygon mask and drag.
-
Add a new vertex: Left-click on an edge of the polygon mask.
-
Delete an existing vertex: Select a vertex of the polygon mask and right-click.
Click Acquire again at the top to acquire the raw image after the masks are edited to check the effect of the masks.
-
-
-
After all editing is completed, click Apply to close the current window.
After Apply is clicked, the value of the Enable Mask parameter is automatically changed to True. If you do not need to apply the masks, change the value of this parameter to False.
Delete Masks
Follow these steps to delete unsatisfactory masks:
-
In the right panel, select the mask that needs to be deleted in Mask list, and click .
If you need to delete all the masks, click Clear to the right of Mask list. -
In the pop-up window, click Confirm to delete the mask.
Click Acquire again at the top to acquire the raw image after the mask is deleted to check the effect of the remaining masks. -
After all deletion is completed, click Apply to close the current window.
After Apply is clicked, the value of the Enable Mask parameter is automatically changed to True. If you do not need to apply the masks, change the value of this parameter to False.
Correction
The parameters in this category are used to correct the tilt of and height error in the profile.
Tilt Correction
Description |
Correct the tilt of the profile, which is caused by the rotation of the laser profiler around the Y-axis. |
---|---|
Visibility |
Beginner, Expert, Guru |
Values |
Enable Tilt Correction:
Tilt Correction Angle:
|
Instruction |
For detailed instructions, refer to Tilt Correction. |
Height Correction
Description |
Correct the height error in the profile, which is caused by the rotation of the laser profiler around the X-axis. |
---|---|
Visibility |
Beginner, Expert, Guru |
Values |
Enable Height Correction:
Height Correction Ratio:
|
Instruction |
For detailed instructions, refer to Height Correction. |