calibrateSpeed {diveMove}R Documentation

Calibrate and build a "TDRcalibrate" object

Description

These functions create a TDRcalibrate object which is necessary to obtain dive summary statistics.

Usage

calibrateSpeed(x, tau=0.1, contour.level=0.1, z=0, bad=c(0, 0),
               main=slot(getTDR(x), "file"), coefs, plot=TRUE,
               postscript=FALSE, ...)

Arguments

x An object of class TDR for calibrateDepth or an object of class TDRcalibrate for calibrateSpeed.
tau Quantile on which to regress speed on rate of depth change; passed to rq.
contour.level The mesh obtained from the bivariate kernel density estimation corresponding to this contour will be used for the quantile regression to define the calibration line.
z Only changes in depth larger than this value will be used for calibration.
bad Length 2 numeric vector indicating that only rates of depth change and speed greater than the given value should be used for calibration, respectively.
coefs Known speed calibration coefficients from quantile regression as a vector of length 2 (intercept, slope). If provided, these coefficients are used for calibrating speed, ignoring all other arguments, except x.
main, ... Arguments passed to rqPlot.
plot Logical indicating whether to plot the results.
postscript Logical indicating whether to produce postscript file output.

Details

This calibrates speed readings following the procedure outlined in Blackwell et al. (1999).

Value

An object of class TDRcalibrate.

Author(s)

Sebastian P. Luque spluque@gmail.com

References

Blackwell S, Haverl C, Le Boeuf B, Costa D (1999). A method for calibrating swim-speed recorders. Marine Mammal Science 15(3):894-905.

See Also

TDRcalibrate

Examples

data(divesTDRcalibrate)
divesTDRcalibrate

## Calibrate speed using only changes in depth > 2 m
vcalib <- calibrateSpeed(divesTDRcalibrate, z=2)
vcalib

[Package diveMove version 0.9.5 Index]