Data Converter

The Data Converter viewer generates depth maps, point clouds, and depth colormaps from a previously recorded dataset. It runs as an offline batch over a folder on disk — Hammerhead does not need to be connected, and the Viewer Mode (Connection, Playback, or Multi Playback) does not need to be selected.

Running a conversion

  1. Open Viewers → Data Converter.
  2. Set Input dataset to the recorded dataset folder, either by typing the path or using Browse.
  3. Optionally set Output to a destination folder. Leave it empty to write subfolders into the input dataset.
  4. Check the outputs you want to generate (Point Cloud, Depth, Depth Colormap). Outputs whose required inputs are missing cannot be enabled.
  5. Click Start. Progress is shown as a frame counter and progress bar, with per-output counts (including how many frames were already on disk) and elapsed time underneath.
  6. Click Cancel at any time to stop the run. Frames already written are kept on disk.

The Log panel at the bottom shows messages emitted during the run, including any per-frame failures.

Note

The input and output paths and the selected outputs are saved with the viewer layout on close and restored the next time the viewer is opened.

Inputs

The converter reads the following subfolders from the input dataset:

Folder Required for
disparity/ Point Cloud, Depth, Depth Colormap
details/ Point Cloud, Depth
left-rect/ Point Cloud, Depth Colormap

Each conversion is enabled only when its required inputs are present. The Detected: section of the viewer reports which folders were found and how many frames each contains. Use Refresh to re-scan after changing the input folder on disk.

Outputs

Viewer Field Output Folder Format
Point Cloud point_clouds/ PLY files, one per frame.
Depth depth/ 32-bit floating-point TIFF, one per frame. Values are in meters.
Depth Colormap depth-colormap/ Rectified image overlaid with color-coded depth, as TIFF.

By default the output folders are written into the input dataset. To write them somewhere else, set Output to a different directory; the same subfolder names are used there.

Frames whose output file already exists on disk are skipped. To regenerate a frame, delete its output file first.