oce (version 0.9-3)

echosounder-class: Class to store echosounder data

Description

Class to store echosounder data, with standard slots metadata, data and processingLog. The data slot is a list containing

• An infrequently updated record of the intrument position, intimeSlow,latitudeSlowandlongitudeSlow. These are used in plotting maps withplot.echosounder.
• An interpolated record of the instrument position, intime,latitude, andlongitude. Linear interpolation is used to infer the latitude and longitude from the variables listed above.
• depth, vector of depths of echo samples (measured positive downwards in the water column). This is calculated from the inter-sample time interval and the sound speed provided as thesoundSpeedargument toread.echosounder, so altering the value of the latter will alter the echosounder plots provided byplot.echosounder.
• The echosounder signal amplitudea, a matrix with number of rows equal to the length oftime, etc., and number of columns equal to the length ofdepth. Thus, for example,a[100,]represents the depth-dependent amplitude at the time of the 100th ping.

Methods

Accessing values. Data may be accessed as e.g. echosounder[["time"]], where the string could also be e.g. FIXME (add more). The names of the columns are displayed with show(). The name of the source file is found with "filename".

Derived data are also available: "distance" calls geodDist to compute locations, and calculates distance along the ship track.

Assigning values. Everything that may be accessed may also be assigned, e.g. echosounder[["time"]] <- 3600 + echosounder[["time"]] adds an hour to time.

Overview of contents. The show method (e.g. show(echosounder)) displays information about the object.

See Also

A file containing echosounder data may be read with read.echosounder, and a echosounder object can also be created with as.echosounder. Statistical summaries are provided by summary.echosounder, while show displays an overview. The findBottom function infers the ocean bottom from tracing the strongest reflector from ping to ping. Echosounder objects may be plotted with plot.echosounder.

The contents of echosounder objects may be altered with subset.oce, or with the the [[]] scheme discussed in the previous section; skilled users may also manipulate the contents directly, but this is not recommended because it is brittle to changes in the data structure.