Learn R Programming

ctmm (version 0.3.0)

as.telemetry: Import, coerce, and summarize MoveBank data

Description

Functions to import MoveBank csv files, data.frame, and Move objects, coerce them into telemetry objects, and summarize them.

Usage

as.telemetry(CSV,timezone="GMT",projection=NULL,...)

## S3 method for class 'character':
as.telemetry(CSV,timezone="GMT",projection=NULL,...)

## S3 method for class 'data.frame':
as.telemetry(CSV,timezone="GMT",projection=NULL,...)

## S3 method for class 'Move':
as.telemetry(CSV,timezone="GMT",projection=NULL,...)

## S3 method for class 'telemetry':
summary(object,...)

Arguments

CSV
The file name of the MoveBank csv file, data.frame object from a MoveBank data CSV, or Move object.
timezone
Timezone argument for as.POSIXct.
projection
Optional PROJ.4 projection argument to be fed to project.
...
Optional arguments to be fed to read.csv.
object
telemetry object to summarize.

Value

  • as.telemetry returns a single telemetry object or list of telemetry objects if multiple animals are identified.

encoding

UTF-8

Details

If no projection argument is specified, a two-point equidistant projection is calculated that should be good for most range resident and migratory species. Global migrations that are not relatively geodesic (locally straight) will probably suffer distortion. The necessary MoveBank columns are individual.local.identifier, timestamp, location.long, location.lat, and the optional Movebank columns are eobs.horizontal.accuracy.estimate. In the future, we will be supporting more GPS and ARGOS columns, including speed, heading, error classification, etc.

See Also

plot.telemetry, SpatialPoints.telemetry.