TDRcalibrate-class {diveMove} | R Documentation |
This class holds information produced at various stages of dive analysis. Methods are provided for extracting data from each slot.
This is perhaps the most important class in diveMove, as it holds all the information necessary for calculating requested summaries for a TDR.
The tdr
slot contains the time, zero-offset corrected depth,
and possibly calibrated or uncalibrated velocity. See
readTDR
and the accessor function tdr
for
this slot. Convenient access to each vector in this slot is available
through tdrTime
, depth, and velocity.
The slot gross.activity holds, as a list, a vector (named
phase.id
) numbering each major activity phase found in the
record, a factor (named trip.act
) labelling each row as being
on-land, at-sea, or leisure at-sea activity. These two elements are
as long as there are rows in tdr
. This slot also contains two
more vectors: one with the beginning time of each phase, and another
with the ending time; both represented as chron
objects. See
detPhase
.
The slot dive.activity
contains a data.frame, again with as
many rows as those in tdr
, consisting of three vectors named:
dive.id
, which is an integer vector, sequentially numbering
each dive (rows that are not part of a dive are labelled 0),
dive.activity is a factor which completes that in trip.act
above, further identifying rows in the record belonging to a dive.
The third vector in dive.activity
is an integer vector
sequentially numbering each postdive interval (all rows that belong to
a dive are labelled 0). See detDive
, and
diveAct
to access all or any one of these vectors.
dive.phases
is a slot corresponding to a factor that labels
each row in the record as belonging to a particular phase of a dive.
See labDivePhase
, and dPhaseLab
to access
this slot.
land.threshold
, sea.threshold
, dive.threshold
,
and vel.calib.coefs
are each a single number representing
parameters used for detecting phases, and calibrating the TDR. Except
for the latter, these are mostly for internal use, and hence do not
have an accessor function. See velCoef
for accessing
vel.calib.coefs
.
Objects can be created by calls of the form new("TDRcalibrate", ...)
.
The objects of this class contain information necessary to divide the
record into sections (e.g. land/water), dive/surface, and different
sections within dives. They also contain the parameters used to
calibrate velocity and criteria to divide the record into phases.
tdr
:"TDR"
, with concurrent time,
depth, and possibly velocity (if "TDRvel"
). See
Details
.gross.activity
:"list"
, must be
the same as value returned by detPhase
.dive.activity
:"data.frame"
,
must be the same as value returned by detDive
.dive.phases
:"factor"
, must be
the same as value returned by labDivePhase
.land.threshold
:"numeric"
the
temporal criteria used for detecting periods on land that should
be considered as at-sea.sea.threshold
:"numeric"
the
temporal criteria used for detecting periods at-sea that should
not be considered as foraging time.dive.threshold
:"numeric"
the
criteria used for defining a dive.vel.calib.coefs
:"numeric"
the
intercept and slope derived from the velocity calibration
procedure.
Sebastian P. Luque spluque@gmail.com
TDR-class
for links to other classes in the
package