diveMove-package {diveMove}R Documentation

Time depth recorder analysis

Description

This package is a collection of functions for visualizing, and analyzing depth and speed data from time-depth recorders TDRs. These can be used to zero-offset correct depth, calibrate speed, and divide the record into different phases, or time budget. Functions are provided for calculating summary dive statistics for the whole record, or at smaller scales within dives.

Author(s)

Sebastian P. Luque spluque@gmail.com

See Also

A vignette with a guide to this package is available by doing 'vignette("diveMove")'. TDR-class, calibrateDepth, calibrateSpeed, timeBudget, stampDive.

Examples

## read in data and create a TDR object
(sealX <- readTDR(system.file(file.path("data", "dives.csv"),
                              package="diveMove"), speed=TRUE))
## Not run: 
plotTDR(sealX)  # pan and zoom through the record
## End(Not run)

## detect periods of activity, and calibrate depth, creating
## a 'TDRcalibrate' object
## Not run: dcalib <- calibrateDepth(sealX) # interactively
(dcalib <- calibrateDepth(sealX, offset=3)) # zero-offset correct at 3 m

## Not run: 
## plot all readings and label them with the phase of the record
## they belong to, excluding surface readings
plotTDR(dcalib, labels="phase.id", surface=FALSE)
## plot the first 300 dives, showing dive phases and surface readings
plotTDR(dcalib, diveNo=seq(300), labels="dive.phase", surface=TRUE)
## End(Not run)

## calibrate speed (using changes in depth > 1 m and default remaining arguments)
(vcalib <- calibrateSpeed(dcalib, z=1))

## Obtain dive statistics for all dives detected
dives <- diveStats(vcalib)
head(dives)

## Attendance table
att <- timeBudget(vcalib, FALSE) # taking trivial aquatic activities into account
att <- timeBudget(vcalib, TRUE)  # ignoring them
## Add trip stamps to each dive
stamps <- stampDive(vcalib)
sumtab <- data.frame(stamps, dives)
head(sumtab)

[Package diveMove version 0.7-8 Index]