diveMove (version 1.1)

calibrateSpeed: 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

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.

Value

• An object of class TDRcalibrate.

Details

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

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