diveStats {diveMove}R Documentation

Per-dive statistics

Description

Calculate dive statistics in TDR records.

Usage

diveStats(x)
oneDiveStats(x, interval, speed=FALSE)
stampDive(x, ignoreZ=TRUE)

Arguments

x A TDRcalibrate-class object for diveStats and stampDive, and a data frame containing a single dive's data (a factor identifying the dive phases, a POSIXct object with the time for each reading, a numeric depth vector, and a numeric speed vector) for oneDiveStats.
interval Sampling interval for interpreting x.
speed Logical; should speed statistics be calculated?
ignoreZ Logical indicating whether trips should be numbered considering all aquatic activities (“W” and “Z”) or ignoring “Z” activities.

Details

diveStats calculates various dive statistics based on time and depth for an entire TDR record. oneDiveStats obtains these statistics from a single dive, and stampDive stamps each dive with associated trip information.

Value

A data.frame with one row per dive detected (durations are in s, and linear variables in m):

begdesc A POSIXct object, specifying the start time of each dive.
enddesc A POSIXct object, as begdesc indicating descent's end time.
begasc A POSIXct object, as begdesc indicating the time ascent began.
desctim Descent duration of each dive.
botttim Bottom duration of each dive.
asctim Ascent duration of each dive.
descdist Numeric vector with descent depth.
bottdist Numeric vector with the sum of absolute depth differences while at the bottom of each dive; measure of amount of “wiggling” while at bottom.
ascdist Numeric vector with ascent depth.
desc.tdist Numeric vector with descent total distance, estimated from speed.
desc.mean.speed Numeric vector with descent mean speed.
desc.angle Numeric vector with descent angle, from the surface plane.
bott.tdist Numeric vector with bottom total distance, estimated from speed.
bott.mean.speed Numeric vector with bottom mean speed.
asc.tdist Numeric vector with ascent total distance, estimated from speed.
asc.mean.speed Numeric vector with ascent mean speed.
asc.angle Numeric vector with ascent angle, from the bottom plane.
divetim Dive duration.
maxdep Numeric vector with maximum depth.
postdive.dur Postdive duration.
postdive.tdist Numeric vector with postdive total distance, estimated from speed.
postdive.mean.speed Numeric vector with postdive mean speed.


The number of columns depends on the value of speed.
stampDive returns a data.frame with trip number, trip type, and start and end times for each dive.

Author(s)

Sebastian P. Luque spluque@gmail.com

See Also

.detPhase, zoc, TDRcalibrate-class

Examples


data(divesTDRcalibrate)
divesTDRcalibrate

tdrX <- diveStats(divesTDRcalibrate)
stamps <- stampDive(divesTDRcalibrate, ignoreZ=TRUE)
tdrX.tab <- data.frame(stamps, tdrX)
summary(tdrX.tab)


[Package diveMove version 0.9.5 Index]