read.EK60_raw: Read raw files from Simrad EK60 scientific echosounders

In hvillalo/echogram: Echogram Visualisation and Analysis

Read raw files from Simrad EK60 scientific echosounders

Description

This function imports all data in EK60 raw files.

Usage

read.EK60_raw(file, parseNMEA = FALSE, angles = TRUE)

Arguments

file	EK60 raw file name.
parseNMEA	logical. When false (the default) all the nmea sentences found in the raw file are returned as text strings. If TRUE, the parse.nmea function tries to parse the most appropriate nmea sentence(s) type(s).
angles	logical. If TRUE and angle data is present, a four dimensions array [depth samples, pings, transceivers, anlges] containing alongship and atwarthship electrical angles is also returned.

Details

This function imports the file as raw bytes with read.EK_raw. Then, the configuration information is obtained from datagram CON0 with get_CON0, nmea sentences (NME0) with get_NME0, and finally acoustic data in RAW0 datagrams with get_RAW0.

Value

A three elements list: (1) configuration, with Header and Transceiver(s) information; (2) nmea sentences (full or parsed); and (3) pings data, which includes at least a sample data table, and received power in a three dimensions array [depth samples, pings, transceivers]. When angles = TRUE, alongship and athwartship electrical angles are also returned as an array with an extra dimension.

Author(s)

Héctor Villalobos.

See Also

read.EK_raw, get_CON0, get_NME0, and get_RAW0

Examples

if(interactive()){
ekraw <- read.EK60_raw("D20130504-T083828.raw", parseNMEA = TRUE, angles = TRUE)

# Header
ekraw$config$Header

# Transceivers
ekraw$config$Transceiver

# GPS data
head(ekraw$nmea)
}

hvillalo/echogram documentation built on Oct. 2, 2023, 7:28 a.m.