ektools 0.1.2

Utilities to read and process Simrad RAW files.

Ektools is a small collection of utilities/library functions to work with Simrad EK60 and EK80 echo sounder data. There are several executable programs which take a RAW file as their parameter:

• ekplot - simple plot of the raw data from each channel

• eklist - extracts various information from the RAW file

• ekmeta - display metadata (times and locations, etc)

• eksplit - split a RAW file by configuration

The ektools library provides fast indexing functions, and parsers (mostly taken from the PyEchoLab package) for the various datagrams used by Simrad and the Korona processing package.

# Examples

To list an index of the datagrams in file.raw from the shell:

eklist file.raw

Parse datagrams and print the contents of each (only truncate large arrays):

eklist -l file.raw

Only print detailed information on specific datagrams (in this case, MRU datagrams containing information on ship movement):

eklist -ql -t MRU0 -t MRU1 file.raw

Check contents of the file for consistency (-c), while suppressing other output (-q):

eklist -qc file.raw

Dump normalized (converted to s_v and with corrected angles) RAW data in a binary stream to stdout:

eklist -qr file.raw

The rawdecode.py file demonstrates how to read the stream back in again.

Extract metadata from a RAW file:

ekmeta file.raw

Separate a RAW file into its different configurations:

eksplit file.raw

Convert position data from a GPX file into a sequence of RAW datagrams:

gpx2nmea locations.gpx > locations.raw

Merging it into a RAW file containing echo sounder output:

ekmerge locations.raw D20240526012345.raw > merged.raw