Skip to content

Log Convert

Brian Miles edited this page Oct 17, 2024 · 1 revision

Log File Conversion Utility

Introduction

Although the code here is primarily intended to support the Wireless Inexpensive Bathymetry Logger (WIBL) implementation, other data loggers are often used to collect Volunteer Bathymetric Information. In order to take advantage of the Cloud Processing code available through this project, however, these formats have to be converted into WIBL Binary Format in order to be processed for timestamp, etc. The logconvert code can be used for this purpose.

Formats Supported

The logconvert code is designed to allow multiple different input formats to be translated into WIBL format. Currently, this includes Yacht Devices YDVR-4 NMEA2000 data logger format, and TeamSurv ASCII data. The latter is a simple ASCII file of NMEA0183 messages, and therefore could be used for any other logger that provides the same or similar information.

Compilation

The code requires the NMEA2000 library used for the remainder of the project, which compiles down to a simpler library without hardware dependencies when used with the CMake build system. Otherwise, the code is self-contained, requiring only a C++11 (at least) compiler; a CMake build description is provided.

Command Line Controls

Since WIBL data files maintain metadata on the source of the observations, and other loggers generally don't, some auxiliary data is required for configuration of the files being produced. Command line interface options are available to do this:

  • name: Specify the logger name string for the system.
  • id: Specify the unique ID string for the system.
  • format: Specify the input format (currently ydvr or teamsurv).
  • stats: Generate detailled input packet statistics (which packets are found, and how many)
  • ignore: Ignore one or more NMEA2000 data sources (i.e., silence given talkers).
  • prodinfo: Provide product information on all NMEA2000 data sources, if available.