Confidence Threshold#
Using the Feature#
How It Works#
The camera calculates an internal confidence value between 0 and 255 for every pixel. The more light is collected for a pixel, the higher the confidence value. With the ConfidenceThreshold
parameter you can specify that only pixels above a certain confidence value are included in the camera output. If the internal confidence value of a pixel doesn't pass the confidence threshold, the corresponding pixel position is represented in the various image components like outlined in the following table:
Image Component | Representation of Pixels Below the Confidence Threshold |
---|---|
Range Map | Set to the value specified by the Scan3dInvalidDataValue parameter |
Confidence Map | Set to zero |
Point Cloud | All 3 coordinates set to the value specified by the Scan3dInvalidDataValue parameter |
Setting a Confidence Threshold#
You can specify a confidence threshold value between 0 and 255. As conditions can vary a lot in different applications, there is no general guideline for choosing a value. Try experimenting with this parameter to see which setting delivers the best results, i.e., at which setting undesired parts of the image are removed.