as.telemetry | R Documentation |
Functions to import MoveBank csv files, data.frame
, and Move
objects, coerce them into telemetry
objects, summarize them, and combine data from multiple tracking devices.
as.telemetry(object,timeformat="auto",timezone="UTC",projection=NULL,datum="WGS84",
dt.hot=NA,timeout=Inf,na.rm="row",mark.rm=FALSE,keep=FALSE,drop=TRUE,...)
## S3 method for class 'character'
as.telemetry(object,timeformat="auto",timezone="UTC",projection=NULL,datum="WGS84",
dt.hot=NA,timeout=Inf,na.rm="row",mark.rm=FALSE,keep=FALSE,drop=TRUE,...)
## S3 method for class 'data.frame'
as.telemetry(object,timeformat="auto",timezone="UTC",projection=NULL,datum="WGS84",
dt.hot=NA,timeout=Inf,na.rm="row",mark.rm=FALSE,keep=FALSE,drop=TRUE,...)
## S3 method for class 'Move'
as.telemetry(object,timeformat="auto",timezone="UTC",projection=NULL,datum="WGS84",
dt.hot=NA,timeout=Inf,na.rm="row",mark.rm=FALSE,keep=FALSE,drop=TRUE,...)
## S3 method for class 'telemetry'
summary(object,...)
head(x,...)
## S3 method for class 'telemetry'
head(x,n=6L,...)
tail(x,...)
## S3 method for class 'telemetry'
tail(x,n=6L,...)
tbind(...)
object |
A MoveBank CSV filename, MoveBank |
timeformat |
Format argument for |
timezone |
Timezone argument for |
projection |
Optional PROJ projection argument for the output telemetry object. |
datum |
Optional argument to specify the input longitude-latitude or UTM datum. The default is WGS84. |
dt.hot |
Time-interval threshold at which GPS location fixes can be considered as “hot” and location estimate precisions may be smaller (regardless of DOP value) for assigning |
timeout |
GPS location fix timeout value (seconds) for assigning a |
na.rm |
If some values are |
mark.rm |
Delete Movebank manually marked outliers. Also see |
keep |
Retain additonal columns after coercion. |
drop |
Only return a |
... |
|
x |
|
n |
Number of rows to return, if positive, or number of rows to omit, if negative. |
For data that have not been corralled throuh Movebank, timestamps either need to be provided in a POSIX format (see the output of Sys.time()
) or supplied with a timeformat
argument for interpretation (see strptime
). Alternatively, you can try your luck with timeformat="auto"
, and parse_date
will attempt to infer the format.
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 along one geodesic (locally straight line) will probably suffer distortion.
as.telemetry()
assumes Movebank naming conventions.
Sufficient MoveBank columns include individual.local.identifier
(or tag.local.identifier
), timestamp
, location.long
and location.lat
, while the optional Movebank columns include (e-obs) eobs.horizontal.accuracy.estimate
, (Telonics) GPS.Horizontal.Error
, GPS.HDOP
, (Argos) Argos.orientation
, Argos.semi.minor
and Argos.semi.major
or Argos.location.class
, etc..
To have all columns detected and not overwrite eachother's information, it is best to have only one tracking device model per file imported.
Multiple deployments on a single individual can be merged afterwards, using tbind()
.
as.telemetry
returns a single telemetry
object or list of telemetry
objects if multiple animals are identified.
as.telemetry
will always report the smallest sampling interval, as a message, and the number repeating timestamps, as a warning. Tiny sampling intervals (and repeating timestamps) can sometimes result from misformated timestamps or an incorrect timeformat
argument. However, even if geniune, they can necessitate data cleaning (outlie) or location-error modeling (vignette('error')
).
Prior to v1.1.1, datum
was required to be a full PROJ string, but starting with v1.1.1 datum
is just taken to be the PROJ datum argument.
C. H. Fleming, X. Dong, B. Kranstauber, G. Péron, and K. Safi.
plot.telemetry
, SpatialPoints.telemetry
, uere
.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.