TDRcalibrate-class {diveMove}R Documentation

Class "TDRcalibrate" for dive analysis

Description

This class holds information produced at various stages of dive analysis. Methods are provided for extracting data from each slot.

Details

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 from the Class

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.

Slots

tdr:
Object of class "TDR", with concurrent time, depth, and possibly velocity (if "TDRvel"). See Details.
gross.activity:
Object of class "list", must be the same as value returned by detPhase.
dive.activity:
Object of class "data.frame", must be the same as value returned by detDive.
dive.phases:
Object of class "factor", must be the same as value returned by labDivePhase.
land.threshold:
Object of class "numeric" the temporal criteria used for detecting periods on land that should be considered as at-sea.
sea.threshold:
Object of class "numeric" the temporal criteria used for detecting periods at-sea that should not be considered as foraging time.
dive.threshold:
Object of class "numeric" the criteria used for defining a dive.
vel.calib.coefs:
Object of class "numeric" the intercept and slope derived from the velocity calibration procedure.

Methods

attendance
signature(obj = "TDRcalibrate", ignoreZ = "logical"): generates an attendance table for the TDR record; the duration of each dry and wet phase.
getDAct
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.
getDAct
signature(x = "TDRcalibrate", y = "character"): as the method for missing y, but selects a particular vector to extract.
getDPhaseLab
signature(x = "TDRcalibrate", diveNo = "missing"): extracts a factor identifying all readings to a particular dive phase.
getDPhaseLab
signature(x = "TDRcalibrate", diveNo = "numeric"): as the method for missing y, but selects data from a particular dive number to extract.
extractDive
signature(obj = "TDRcalibrate", diveNo = "numeric", id = "missing"): extract particular dives.
getGAct
signature(x = "TDRcalibrate", y = "missing"): extracts elements that divide the data into major wet and dry activities.
getGAct
signature(x = "TDRcalibrate", y = "character"): as the method for missing y, but extracts particular elements.
show
signature(object = "TDRcalibrate"): prints informative summary of the data.
getTDR
signature(x = "TDRcalibrate"): extracts the TDR object.
getVelCoef
signature(x = "TDRcalibrate"): extracts the velocity calibration coefficients.

Author(s)

Sebastian P. Luque spluque@gmail.com

See Also

TDR-class for links to other classes in the package


[Package diveMove version 0.5-0 Index]