Skip to contents

Read AnimalTA data

Source: R/read_animalta.R
read_animalta.Rd

Read a data frame from AnimalTA. AnimalTA exports tracking data in image (top-left) coordinates; the reader reflects y so the returned aniframe is in the conventional bottom_left origin.

Usage

read_animalta(path, detailed = FALSE, video_height = NULL)

Arguments

path

An AnimalTA data frame

detailed

Animal export either raw (default) or detailed data files. We only have limited support for detailed data.

video_height

Optional numeric height of the source video frame in pixels. AnimalTA does not record this in the export, so when not supplied the maximum observed y is used as a fallback.

Value

a movement dataframe

References

  • Chiara, V., & Kim, S.-Y. (2023). AnimalTA: A highly flexible and easy-to-use program for tracking and analysing animal movement in different environments. Methods in Ecology and Evolution, 14, 1699–1707. doi:0.1111/2041-210X.14115 .