A ctmm::as.telemetry() telemetry list hold mutiple animal data in separate list items, each item have the animal location data in a data frame, and other information in various slots. This structure supports flexible S3 methods for telemetry object. However to plot multiple animals location together with ggplot2 we need to collect all location data as a single data.frame with an animal id column.

collect(tele_obj_list)

Arguments

tele_obj_list

ctmm::as.telemetry() telemetry list. Use drop = FALSE in ctmm::as.telemetry() to ensure a proper list.

Value

list of - data_dt: all animals collected in one data.table - info: animal information table

Details

This function convert any input telemetry List into a list of 1. data.table of location data, and 2. animal information data.table. data.table is chosen over data.frame for much better performance. This data structure is also used in a lot of places in app, which works on any selected subset of full data in almost all steps.