depth_consistency_index: Depth consistency index between two dives

Description Usage Arguments Details References Examples

View source: R/funs_behavior.r

Description

dri_dive2 * (max_depth_dive2 - max_depth_dive1) / max_depth_dive2

Usage

1
2
depth_consistency_index(x = ind(), depth_col = 2, fmt = c("vector",
  "matrix"), na.pad = TRUE, ...)

Arguments

x

input data, a ses object.

depth_col

Character or numeric giving the column of the TDR table that stores the depth sequence

fmt

Should the function return a vector with pairwise comparison of dive taken in chronologic order or a dissimilarity matrix ?

na.pad

If TRUE and fmt = "vector" then a NA is appended to the beginning of the result so that the output can be directly allocated to the dive statistics table. If TRUE and fmt = "matrix" then the upper triangle of the matrix is filled with NA to save memory.

...

Arguments to be passed to depth_range_index.

Details

Low values indicate high consistency between the vertical areas vistited in the bottom of the two dives (depth range and maximum depth). Low values can incitate benthic dives.

References

Halsey, L.G., Bost, C.-A., Handrich, Y. (2007) A thorough and quantified method for classifying seabird diving behaviour. Polar Biology, 30, 991-1004.

Examples

1
2
3
4
5
6
7
data(exses)
exses$stat$dci <- depth_consistency_index(exses)
hist(exses$stat$dci)
plot(dci ~ time, exses$stat)

Mdci <- depth_consistency_index(exses, fmt = "matrix", na.pad = FALSE)
image(log(Mdci + 0.001)) # Red for values close to 0

SESman/rbl documentation built on June 24, 2017, 8:48 a.m.