HRprocess: Preprocess activity space function

In RossDwyer/VTrack: A Collection of Tools for the Analysis of Passive Acoustic Telemetry Data

Preprocess activity space function

Description

Internal function to run HRSummary.

Usage

HRprocess(
  cenac,
  utm,
  ll,
  type = "MCP",
  h = 200,
  ext = 2,
  grid = 200,
  sub = "%Y-%m",
  cont = c(50, 95),
  cumulative = FALSE,
  storepoly = FALSE,
  div = 4
)

Arguments

cenac	center of activity positions generated from COA, and used here to pre-process before feeding back to HRSummary
utm	a projected coordinate reference system in meters used to accurately estimate area (see CRS)
ll	a geographic coordinate reference system in meters used to accurately estimate area (see CRS)
type	type of activity space metric to calculate. Currently "MCP" for minimum convex polygons, "fKUD" for fixed KUD and "BBKUD" for Brownian bridge KUD. Defaults to "MCP" when no value provided.
h	smoothing factor (in m) associated with error associated with reciever range of passive telemetry system. Defaults to 200 m if none provided.
ext	spatial extent used to calculate probability density metrics of activity space ('fKUD', 'BBKUD')
grid	grid size used to calculate probability density metrics of activity space ('fKUD', 'BBKUD')
sub	temporal subset used to calculate subsetted activity space metrics. Currently supports monthly ('%Y-%m') or weekly ('%Y-%W'). Defaults to monthly.
cont	contours of activity space models to estimate areas. Defaults to 50% and 95% contours
cumulative	TRUE/FALSE, should the operation calculate cumulative activity space areas. Caution this may take a long time depending on size of dataset.
storepoly	TRUE/FALSE, should activity space metrics be saved as spatial objects (polygons or rasters)
div	sig1 divisor used to correct BBKUD estimates.

Value

Produces a list of 2 tibbles containing Overall (full tag life) and Subsetted (user-defined temporal subsets) metrics of activity space. If storepoly=TRUE additional object within list containing spatial objects (MCP polygons or KUD rasters). Temporal subsets are currently restricted to monthly ('%Y-%m') or weekly ('%Y-%W'). Cumulative measures across temporal subsets included if cumulative=TRUE.

See Also

Input data needs to be setup using setupData, and COAs calculated using COA.

RossDwyer/VTrack documentation built on Feb. 23, 2024, 10:40 p.m.