Description Usage Arguments References Examples
According to Halsey et al. 2007 (see references): Wiggles are a particular pattern in the dive profile over time during a dive where an increase in depth over time changes to a decrease in depth and then back to an increase in depth. This creates a short period in the dive profile that is concave in shape. Wiggles are defined as elements of the dive profile during which at three points the vertical speed passes below 0 m/s. (NB: If useful, certain wiggles could be ignored, e.g. using a threshold based on their depth range or duration.). This function implements this definition of the wiggle and is primarily intended to be used on dive profile but it can be useful to extract the inversions in any kind of 2D data having a monotonous x variable.
1 2 3 |
x |
The x data. A monotonous variable such as the time sequence of a TDR
dataset. Can also be a list of |
y |
The y data. |
thres.y |
minimum y difference within a wiggle for it to be taken into
account. The default values are usually appropriate if Y is a depth variable
from a southern elephant seal dataset. If one value is provided wiggles are kept
if the y differences are greater than this threshold. If two values are
provided wiggles are kept when the y differences lie between these thresholds.
This threshold is used by |
thres.x |
minimum x difference within a wiggle for it to be taken into
account. The default value is usually appropriate if X is a time variable
from a southern elephant seal dataset. If one value is provided wiggles are
kept when the x differences are greater than this threshold. If two values are
provided wiggles are kept if the x differences lie between these thresholds.
|
step |
A vertical speed threshold defining "steps" (0.35 m/s for king
penguin). If |
step.thres.y |
similar to |
step.thres.x |
similar to |
output |
Should the function return the number of wiggles ("wig-count"), the number of steps ("stp-count") or a data frame with width, height and height/width ratio for each transit/step/wiggle identified ("table"). |
plt |
Should graphics about processing be plotted ? |
bsm |
To speed up the process you can provide a brokenstick model to use directly instead of computing a new one from x and y data. |
Halsey, L.G., Bost, C.-A., Handrich, Y. (2007) A thorough and quantified method for classifying seabird diving behaviour. Polar Biology, 30, 991-1004.
1 2 3 4 5 6 7 8 9 | data(exses)
# Number of wiggles can be used as a proxy of the foraging activity
sunflowerplot(tdrply(wiggles, ty = '_', obj = exses), exses$stat$pca)
sunflowerplot(tdrply(wiggles, ty = '_', obj = exses, step = 0.35), exses$stat$pca)
# Identifying steps as well
tdrply(wiggles, c("time", "depth"), ty = '_', no = 65, obj = exses,
step = 0.35, output = "table", plt = TRUE)
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.