Skip to content

Commit b747e5c

Browse files
authored
Merge pull request #264 from luxonis/docs_depth_modes
Explanation of depth modes in stereoDepth node docs
2 parents 13dcbf4 + 67bb887 commit b747e5c

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

docs/source/components/nodes/stereo_depth.rst

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,42 @@ If one or more of the additional depth modes (:code:`lrcheck`, :code:`extended`,
7474

7575
Otherwise, :code:`depth` output is **U16** (in millimeters) and median is functional.
7676

77+
Depth Modes
78+
###########
79+
80+
Left-Right Check
81+
****************
82+
83+
Left-Right Check or LR-Check is used to remove incorrectly calculated disparity pixels due to occlusions at object borders (Left and Right camera views
84+
are slightly different).
85+
86+
#. Computes disparity by matching in R->L direction
87+
#. Computes disparity by matching in L->R direction
88+
#. Combines results from 1 and 2, running on Shave: each pixel d = disparity_LR(x,y) is compared with disparity_RL(x-d,y). If the difference is above a threshold, the pixel at (x,y) in the final disparity map is invalidated.
89+
90+
Extended Disparity
91+
******************
92+
93+
The :code:`extended disparity` allows detecting closer distance objects for the given baseline. This increases the maximum disparity search from 96 to 191.
94+
So this cuts the minimum perceivable distance in half, given that the minimum distance is now :code:`focal_length * base_line_dist / 190` instead
95+
of :code:`focal_length * base_line_dist / 95`.
96+
97+
#. Computes disparity on the original size images (e.g. 1280x720)
98+
#. Computes disparity on 2x downscaled images (e.g. 640x360)
99+
#. Combines the two level disparities on Shave, effectively covering a total disparity range of 191 pixels (in relation to the original resolution).
100+
101+
Subpixel Disparity
102+
******************
103+
104+
Subpixel improves the precision and is especially useful for long range measurements. It also helps for better estimating surface normals
105+
106+
Besides the integer disparity output, the Stereo engine is programmed to dump to memory the cost volume, that is 96 levels (disparities) per pixel,
107+
then software interpolation is done on Shave, resulting a final disparity with 5 fractional bits, resulting in significantly more granular depth
108+
steps (32 additional steps between the integer-pixel depth steps), and also theoretically, longer-distance depth viewing - as the maximum depth
109+
is no longer limited by a feature being a full integer pixel-step apart, but rather 1/32 of a pixel.
110+
111+
For comparison of normal disparity vs. subpixel disparity images, click `here <https://github.com/luxonis/depthai/issues/184>`__.
112+
77113
Usage
78114
#####
79115

0 commit comments

Comments
 (0)