tag_tales: Contstruct coherant individual movement paths from tag...

In Myfanwy/tagtales: Functions For Summarizing Acoustic and PIT Telemetry Data

Description

Contstruct coherant individual movement paths from tag detection history dataframe

Usage

tag_tales(
  detdf,
  TagID_col,
  Station_col,
  Datetime_col = "DateTimeUTC",
  Threshold = 60 * 60,
  allow_overlap = TRUE
)

Arguments

detdf	a dataframe of detections
TagID_col	column containing unique fish identification codes
Station_col	column containing unique station codes or names
Datetime_col	column containing date and time of detection, in POSIXct format YYYY-MM-DD HH:MM:SS
Threshold	desired time threshold between station visits, in seconds. See details.
allow_overlap	logical, if TRUE the fish paths are allowed to overlap so long as the threshold has not been exceeded

Details

The time threshold allows you to delineate the period of time that detections can be separated from each other at a receiver and still be considered part of the same "stay" at that receiver. The default is 1 hour "('60*60')". If you set Threshold = "'60*60*2'", that means that after a fish arrives at a receiver, all detections that occur at that receiver within 2 hours of the first arrival are considered part of the same "stay" at that receiver.

Value

dataframe with fishpaths for each tagID

Myfanwy/tagtales documentation built on Nov. 13, 2021, 6:33 a.m.