diveMove (version 0.7-8)

diveStats: 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 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.

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.
• 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.
• 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.

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

.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)