detDive-internal: Detect dives from depth readings

In spluque/diveMove: Dive Analysis and Calibration

Detect dives from depth readings

Description

Identify dives in TDR records based on a dive threshold.

Usage

.detDive(zdepth, act, dive.thr)

Arguments

zdepth	numeric vector of zero-offset corrected depths.
act	factor as long as depth coding activity, with levels specified as in .detPhase.
dive.thr	numeric scalar: threshold depth below which an underwater phase should be considered a dive.

Value

A data.frame with the following elements for .detDive

dive.id	Numeric vector numbering each dive in the record.
dive.activity	Factor with levels “L”, “W”, “U”, “D”, and “Z”, see .detPhase. All levels may be represented.
postdive.id	Numeric vector numbering each postdive interval with the same value as the preceding dive.

Author(s)

Sebastian P. Luque [e-mail]

See Also

.detPhase, .zoc

Examples

## 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

tdr <- getTDR(dcalib)

## Extract the gross activity from an already calibrated TDR object
gross.act <- getGAct(dcalib)
detd <- diveMove:::.detDive(getDepth(tdr), gross.act[[2]], 3)

spluque/diveMove documentation built on Oct. 19, 2024, 2:47 p.m.