diveMove (version 1.2.1)

diveStats: Per-dive statistics

Description

Calculate dive statistics in TDR records.

Usage

diveStats(x, depth.deriv=TRUE)
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 ob

depth.deriv

logical: should depth derivative statistics be calculated?

interval

numeric scalar: sampling interval for interpreting x.

speed

logical: should speed statistics be calculated?

ignoreZ

logical: whether trips should be numbered considering all aquatic activities (W and Z) or ignoring Z activities.

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.
• divetim
  Dive duration.
• descdist
  Numeric vector with last 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 first ascent depth.
• bottdep.mean
  Mean bottom depth.
• bottdep.median
  Median bottom depth.
• bottdep.sd
  Standard deviation of bottom depths.
• maxdep
  Numeric vector with maximum 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.
• postdive.dur
  Postdive duration.
• postdive.tdist
  Numeric vector with postdive total distance, estimated from speed.
• postdive.mean.speed
  Numeric vector with postdive mean speed.
• If depth.deriv=TRUE, 21 additional columns with the minimum, first quartile, median, mean, third quartile, maximum, and standard deviation of the depth derivative for each phase of the dive. The number of columns also depends on the value of speed.

  stampDive returns a data.frame with trip number, trip type, and start and end times for each dive.

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.

See Also

calibrateDepth, .detPhase, TDRcalibrate-class

Examples

## Continuing the Example from '?calibrateDepth':
utils::example("calibrateDepth", package="diveMove",
               ask=FALSE, echo=FALSE)
dcalib		# the 'TDRcalibrate' that was created

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