Skip to content

Commit

Permalink
Updating Depth-Quality readme and relocating large images from git re…
Browse files Browse the repository at this point in the history
…pository
  • Loading branch information
dorodnic committed Oct 30, 2017
1 parent 3f123ae commit d2b3894
Show file tree
Hide file tree
Showing 15 changed files with 15 additions and 13 deletions.
Binary file removed examples/align/expected_output.gif
Binary file not shown.
2 changes: 1 addition & 1 deletion examples/align/readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ The example display a GUI for controlling the max distance to show from the orig

The application should open a window and display a video stream from the camera.

<p align="center"><img src="expected_output.gif" alt="screenshot gif"/></p>
<p align="center"><img src="https://raw.githubusercontent.com/wiki/IntelRealSense/librealsense/res/align-expected.gif" alt="screenshot gif"/></p>

The window should have the following elements:
- On the left side of the window is a vertical silder for controlling the depth clipping distance.
Expand Down
Binary file removed examples/capture/expected_output.png
Binary file not shown.
2 changes: 1 addition & 1 deletion examples/capture/readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ We use OpenGL for cross-platform rendering and GLFW for window management.
If you are using OpenCV, `imshow` is a good alternative.

## Expected Output
![expected output](expected_output.png)
![expected output](https://raw.githubusercontent.com/wiki/IntelRealSense/librealsense/res/capture-expected.png)

## Code Overview

Expand Down
Binary file removed examples/multicam/example_screenshot.gif
Binary file not shown.
2 changes: 1 addition & 1 deletion examples/multicam/readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Each part of the split window should display a single stream from a different ca

In the following example we've used two Intel® RealSense™ Depth Cameras pointing at different locations.

<p align="center"><img src="example_screenshot.gif" alt="screenshot gif"/></p>
<p align="center"><img src="https://raw.githubusercontent.com/wiki/IntelRealSense/librealsense/res/multi-cam-expected.gif" alt="screenshot gif"/></p>

> Note: The above animation was cropped to display only the depth streams.
Expand Down
Binary file removed examples/pointcloud/expected_output.png
Binary file not shown.
2 changes: 1 addition & 1 deletion examples/pointcloud/readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ This sample demonstrates how to generate and visualize textured 3D pointcloud.

## Expected Output
The application should open a window with a pointcloud. Using your mouse, you should be able to interact with the pointcloud, rotating, zooming, and panning.
![expected output](expected_output.png)
![expected output](https://raw.githubusercontent.com/wiki/IntelRealSense/librealsense/res/point-cloud-expected.png)

## Code Overview

Expand Down
Binary file removed examples/save-to-disk/expected_output.PNG
Binary file not shown.
2 changes: 1 addition & 1 deletion examples/save-to-disk/readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ This sample demonstrates how to configure the camera for streaming in a textual

## Expected Output
The application should run for about a second and exit after saving PNG and CSV file to disk:
![expected output](expected_output.PNG)
![expected output](https://raw.githubusercontent.com/wiki/IntelRealSense/librealsense/res/save-to-disk-expected.PNG)

## Code Overview

Expand Down
16 changes: 9 additions & 7 deletions tools/depth-quality/readme.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
# Depth Quality Tool

<p align="center"><img src="res/depth_quality_glimpse.gif" /></p>
<p align="center"><img src="https://raw.githubusercontent.com/wiki/IntelRealSense/librealsense/res/depth-quality-glimpse.gif" /></p>

## Overview

This application allows you to test the camera’s depth quality, including: average distance to plane accuracy, standard deviation from plane, Z (distance) accuracy and fill rate.
This application allows you to test the camera’s depth quality, including: average distance to plane accuracy, Z (distance) accuracy and fill rate.
You should be able to easily get and interpret several of the depth quality metrics and record and save the data for offline analysis.

## Quick Start
* Position the depth camera within a range of 0.5 -3 meter from a flat non-reflective surface.
* Position the depth camera within a range of 0.3 - 2 meter from a flat non-reflective surface.
* Aim the camera to the target and hold it steady for several seconds till the tool is able to recognize the surface (the yellow grid in 3D view).
* Adjust the camera using the "Angle" metric to minimize the skew and make it as perpendicular to the surface as possible.
* Inspect the calculated depth quality metrics, expand the metric properties to get more in-depth info.
Expand All @@ -18,8 +18,8 @@ You should be able to easily get and interpret several of the depth quality metr
* Plane Fitting - using reconstructed surface
* User-defined Region of Interest
* Depth Quality metrics:
* Z-Accuracy
* Depth Error Average
* Depth Error Standard Deviation
* Fill-Rate
* Subpixel RMS
* Distance to target
Expand All @@ -29,10 +29,12 @@ You should be able to easily get and interpret several of the depth quality metr
## Metrics elaborated
![](./res/Zi_ZPi.png)

### Depth Error Average & STD
### Depth Error Average
_Dist<sub>i</sub>_ - Distance from pixel coordinates to the Plane Fit (mm)
![](./res/avg.gif)
![](./res/std.gif)
![](./res/avg.gif)
### Z Accuracy
_GT_ - Ground truth distance to the wall (mm)
![](./res/accuracy.gif)
### Subpixel RMS Metric
_Z<sub>i</sub>_ - Depth value of i-th pixel in the ROI (mm)
_ZP<sub>i</sub>_ - Depth value of the i-th pixel projected onto the plane fit (mm)
Expand Down
Binary file added tools/depth-quality/res/accuracy.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed tools/depth-quality/res/depth_quality_glimpse.gif
Binary file not shown.
2 changes: 1 addition & 1 deletion tools/realsense-viewer/readme.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Intel® RealSense™ Viewer

<p align="center"><img src="res/realsense-viewer-backup.gif" /></p>
<p align="center"><img src="https://raw.githubusercontent.com/wiki/IntelRealSense/librealsense/res/realsense-viewer-backup.gif" /></p>

## Overview

Expand Down
Binary file not shown.

0 comments on commit d2b3894

Please sign in to comment.