Skip to content
Branch: master
Find file History
alowenst01 DQT: fix plane and metric annotations when stream is paused
RS5-3386

- Indication plane and metric info continued to work when stream was paused.
Latest commit d40592b Aug 4, 2019
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
res Auto-resolving PR-check errors Feb 20, 2019
CMakeLists.txt Fixing depth quality tool compilation Jun 26, 2019
depth-metrics.h UX Rebase Jan 20, 2019
depth-quality-model.cpp DQT: fix plane and metric annotations when stream is paused Aug 4, 2019
depth-quality-model.h Viewer UI for firmware update Jun 24, 2019
readme.md DQT - distance description documentation Jul 10, 2018
rs-depth-quality.cpp

readme.md

Depth Quality Tool

Overview

This application allows you to test the camera’s depth quality, including: Z-Accuracy, Sub-Pixel and Z RMS errors (spatial noise) and Fill Rate. You should be able to easily get and interpret several of the depth quality metrics, or record and save the data for offline analysis.
Please refer to RealSense DepthQualityTesting White Paper for further information.

Quick Start

  • 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.
  • In order to get Z-Accuracy, enable the "Ground Truth" field in UI and modify it with the value obtained/measured with external tools
  • Click on "Start_record" to collect both the metrics and the raw data for offline analysis.

Features

  • 2D/3D Depth View
  • Plane Fitting - using reconstructed surface
  • User-defined Region of Interest
  • Depth Quality metrics:
    • Z-Accuracy
    • Spatial Noise:
      • Plane Fit RMS Error
      • Sub-Pixel RMS Error
    • Fill-Rate
    • Distance to target
  • Export metrics and device configuration
  • Depth Sensor controls

Depth Metrics elaborated

Fill Rate

the percentage of valid (non-zero) pixels within the user-defined Region of Interest (ROI) area.

Distance To Target

estimated distance to an average within the ROI of the target (wall) in mm.
N - Normal of the fitted plane
P - Center of ROI(centroid)

Plane Fit RMS Error

the metrics represents depth pixels deviation from the calculated Plane Fit. Disti - Distance from depth pixel coordinates to the Plane Fit (mm).

Sub-Pixel RMS Error

Zi - Depth value of i-th pixel in the ROI (mm)
ZPi - Depth value of the i-th pixel projected onto the plane fit (mm)
BL - Stereoscopic Baseline (mm)
FL -Focal Length as a multiple of pixel width (pixels)
Di - Disparity value of i-th pixel in the ROI (pixel)
DPi - Disparity value of i-th plane-projected pixel (pixel)


Z Accuracy


RotationPivotx,y,z - Intersection point between the center of the depth censor's ROI and the Fitted Plane
PlanesOffsetmm - Distance (signed) from the Fitted to the Ground Truth planes (mm)
Di - Distance (signed) from a depth vertex to the Fitted Plane (mm)
D'i - Z-error: Distance (signed) from the rotated Di coordinate to the Ground Truth Plane (mm)
GT - Ground Truth distance to the wall (mm)

You can’t perform that action at this time.