diveMove (version 1.5.4)

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 object with the time for each reading, a numeric depth vector, and a numeric speed vector) for oneDiveStats.

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 phases 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 argument speed.

stampDive returns a data.frame with phase number, activity, 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 phase information.

See Also

calibrateDepth, .detPhase, TDRcalibrate-class

Examples

# NOT RUN {
# }
# NOT RUN {
## Too long for checks
## Continuing the Example from '?calibrateDepth':
utils::example("calibrateDepth", package="diveMove",
               ask=FALSE, echo=FALSE, run.donttest=TRUE)
dcalib		# the 'TDRcalibrate' that was created

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

# }
# NOT RUN {
# }