UniquenessRatio¶

Filters the pixels depending on the uniqueness of the found correspondence. The value indicates the percentage, by which the cost of the next best correspondence must be larger (compared to the best correspondence), such that the pixel is accepted.

Format

 Number An integer specifying the uniqueness margin in percent.

Note

Setting this parameter to 0 disables the uniqueness filter.

Default

 N35/X36/XR36 1 see also defaults for matching Method others 10

Example

Let $$r$$ be the uniqueness ratio, and $$C_{1st}$$ and $$C_{2nd}$$ be the cost of the best and second best correspondence for a pixel. The depth value of this pixel is only accepted if

$$C_{1st} < \frac{(100-r)}{100} \cdot C_{2nd}$$

If a pixel doesn’t fulfill the uniqueness threshold, it is discarded and set invalid. If UniquenessRatio is 10 percent: $$C_1st$$ must be $$< 0.9 \cdot C_{2nd}$$ for each pixel, otherwise the pixel’s depth value will be discarded.