voyant_bin_to_csv

Convert binary logged point clouds to CSV format with headers for each field. Useful for data analysis in Python (until native Python bindings are available), Excel, or other tools.

Use voyant_bin_to_csv --help to see all available options.

Usage

Basic Conversion

voyant_bin_to_csv --input my_recording.bin --output data.csv

Include Invalid Points

voyant_bin_to_csv --input my_recording.bin --output data_full.csv --keep-invalid-points

You can download sample datasets from the Playback Tools section to test conversion.

Output Format

The CSV file contains point cloud data with column headers for each field, making it readable in spreadsheet applications or analyzable with Python pandas, R, or other data analysis tools.

Options

  • --input <FILE> - Path to the binary recording file
  • --output <FILE> - Path for the output CSV file
  • --keep-invalid-points - Include invalid points in the conversion

Troubleshooting

If conversion fails:

  • Verify the input file is a valid Voyant .bin recording
  • Check that you have write permissions for the output directory
  • Ensure sufficient disk space for the CSV file (can be significantly larger than binary)

Copyright © Voyant Photonics, Inc.