echosounder-class {oce} | R Documentation |
Class to store echosounder data.
The data
slot is a list containing
An infrequently updated record of the intrument position, in
timeSlow
, longitudeSlow
and latitudeSlow
. These are
used in plotting maps with plot,echosounder-method
.
An interpolated record of the instrument position, in time
,
longitude
, and latitude
. Linear interpolation is used to
infer the longitude and latitude 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 the soundSpeed
argument
to read.echosounder
, so altering the value of the latter will
alter the echosounder plots provided by plot,echosounder-method
.
The echosounder signal amplitude a
, a matrix whose number of
rows matches the length of time
, etc., and number of columns equal to
the length of depth
. Thus, for example, a[100,]
represents
the depth-dependent amplitude at the time of the 100th ping.
A matrix named b
exists for dual-beam and split-beam cases.
For dual-beam data, this is the wide-beam data, whereas a
is the
narrow-beam data. For split-beam data, this is the x-angle data.
A matrix named c
exists for split-beam data, containing the
y-angle data.
In addition to these matrices, ad-hoc calculated matrices named
Sv
and TS
may be accessed as explained in the next section.
Accessing values. Data may be accessed as e.g.
echosounder[["time"]]
, echosounder[["depth"]]
,
echosounder[["a"]]
, etc. Items in metadata
must be specifield
by full name, but those in data
may be abbreviated, so long as the
abbreviation is unique. In addition to the actual data, some derived fields
are also available: echosounder[["distance"]]
calls
geodDist
to compute calculate distance along the ship track,
echosounder[["Sv"]]
returns a matrix of backscatter strength in DB,
and echosounder[["TS"]]
returns a matrix of target strength in dB.
Assigning values. Everything that may be accessed may also be
assigned, e.g. echosounder[["time"]] <- 3600 + echosounder[["time"]]
adds an hour to time.
Dan Kelley
Statistical summaries are provided by summary,echosounder-method
,
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-method
.
The contents of echosounder
objects may be altered with
subset,echosounder-method
, or with 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.
Other classes provided by oce
: adp-class
,
adv-class
, argo-class
,
bremen-class
, cm-class
,
coastline-class
, ctd-class
,
lisst-class
, lobo-class
,
met-class
, oce-class
,
odf-class
, rsk-class
,
sealevel-class
,
section-class
, topo-class
,
windrose-class
Other things related to echosounder
data: [[,echosounder-method
,
[[<-,echosounder-method
,
as.echosounder
, echosounder
,
findBottom
,
plot,echosounder-method
,
read.echosounder
,
subset,echosounder-method
,
summary,echosounder-method