cu_bout_det: Movement bout detection

View source: R/cu_bout_det.R

cu_bout_detR Documentation

Movement bout detection

Description

Creates a data table that indicates the times of different bouts of movement. This method uses changes in the overall dispersion rate of the animal from the 'base' time to detect changes in overall movement from small scale local movement to large scale migration.

Usage

cu_bout_det(
  data,
  min_disp,
  migr_disp_cut = 1,
  min_bout_len = 3,
  grid_res = "day",
  base = "first",
  max_k = 100
)

Arguments

data

An sf data set of locations with times noted by the 'datetime' column

min_disp

The minimum dispersion rate to be considered a migration interval, e.g. 10 for a 10km dispersion minimum.

migr_disp_cut

The minimum per day dispersal rate to categorize a movement bout as "migratory" Defaults to 1.

min_bout_len

The mimimum length of time that a migration or non-migration event will take, e.g., 7 implies a minimum of 7 time intervals for a bout.

grid_res

The temporal resolution at which migrations are detected. e.g., "day" (default) implies migration start and end is detected on a daily resolution.

base

The location at which dispersion is measured. Can be one of "first" (first location), "last" (final location), or some other sf::sfc point location.

max_k

The maximum degrees of freedom used by mgcv::gam to model dispersion and estimate the derivative of the dispersion function.

Author(s)

Devin S. Johnson


dsjohnson/crawlUtils documentation built on Sept. 13, 2024, 1:34 p.m.