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 getTDR
for this slot. Convenient access to each vector in this slot is
available through getTime
, getDepth, and
getVeloc.
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
getDAct
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 getDPhaseLab
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 getVelCoef
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.
signature(obj = "TDRcalibrate", ignoreZ =
"logical")
: generates an attendance table for the TDR record;
the duration of each dry and wet phase.signature(x = "TDRcalibrate", y = "missing")
:
extracts vectors identifying all readings to a particular dive or
postdive number, or a factor identifying all readings to a
particular activity.signature(x = "TDRcalibrate", y =
"character")
: as the method for missing y
, but selects a
particular vector to extract.signature(x = "TDRcalibrate", diveNo =
"missing")
: extracts a factor identifying all readings to a
particular dive phase.signature(x = "TDRcalibrate", diveNo =
"numeric")
: as the method for missing y
, but selects
data from a particular dive number to extract.signature(obj = "TDRcalibrate", diveNo =
"numeric", id = "missing")
: extract particular dives.signature(x = "TDRcalibrate", y = "missing")
:
extracts elements that divide the data into major wet and dry
activities.signature(x = "TDRcalibrate", y =
"character")
: as the method for missing y
, but extracts
particular elements.signature(object = "TDRcalibrate")
: prints
informative summary of the data.signature(x = "TDRcalibrate")
: extracts the
TDR
object.signature(x = "TDRcalibrate")
: extracts the
velocity calibration coefficients.
Sebastian P. Luque spluque@gmail.com
TDR-class
for links to other classes in the
package