setupData: Setup data prior to use with Animal Tracking Toolbox...

View source: R/setupData.R

setupDataR Documentation

Setup data prior to use with Animal Tracking Toolbox functions

Description

Sets up and stores all relevant information required for spatio-temporal analyses of passive telemetry data from IMOS and VEMCO databases. This function produces an 'ATT' object which standardises field names (currently handles IMOS ATF export data structure).

Usage

setupData(
  Tag.Detections,
  Tag.Metadata,
  Station.Information,
  source = NULL,
  tzone = "UTC",
  crs = NULL
)

Arguments

Tag.Detections

data frame with tag detection data including coordinates. Currently only handles IMOS ATF data structure.

Tag.Metadata

data frame with metadata for all tags represented in Tag.Detections. Currently only handles IMOS ATF metadata structure.

Station.Information

data frame with information on receiver station including coordinates. Currently only handles IMOS ATF station information structure.

source

character indicating source of Tag.Detection data. "IMOS" for data downloaded from IMOS data repository and "VEMCO" for data exported from the VEMCO VUE database

tzone

time zone of date time information in Tag.Detections, Tag.Metadata and Station.Information. If none provided defaults to "UTC"

crs

geographic coordinate system for all Tag.Detections, Tag.Metadata and Station.Information (latitude/longitude). If none provided defaults to WGS84.

Value

Produces an 'ATT' object that is a list of tibbles containing Tag.Detections, Tag.Metadata and Station.Information. The 'ATT' object will have a geographic coordinate system associated with it for smoother functioning of subsequent functions.

See Also

setup data can be used to estimate detection detectionSummary, dispersal dispersalSummary and Short-term center of activity COA.

Examples

## Import example datasets
data(IMOSdata)
data(taginfo)
data(statinfo)

## Setup data
ATTdata<- setupData(Tag.Detections = IMOSdata, 
                    Tag.Metadata = taginfo, 
                    Station.Information = statinfo, 
                    source = "IMOS")

ATTdata



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