uere: Estimate UERE from calibration data

Description Usage Arguments Details Value Note Author(s) See Also Examples

View source: R/uere.R

Description

Functions for estimating and assigning the User Equivalent Range Error (UERE) of a GPS device from calibration data.

Usage

1
2
3
4
5
6
7
8
uere(data)

uere(data) <- value

uere.fit(data,precision=1/2)

## S3 method for class 'UERE'
summary(object,level=0.95,...)

Arguments

data

telemetry object or list of telemetry objects, preferably with DOP columns.

value

UERE value(s) to assign to telemetry data (see details).

precision

Fraction of maximum possible digits of precision to target in categorical error fitting. precision=1/2 results in about 7 decimal digits of precision.

object

UERE object to summarize.

level

Confidence level for UERE estimate confidence intervals.

...

Further arguments are ignored.

Details

Often times GPS animal tracking devices return HDOP values but do not specifiy the device's UERE necessary to transform the HDOP values into absolute errors. uere.fit() allows users to estimate the UERE from calibration data, where the device was left fixed over a period of time. The calibration UERE can then be applied to tracking data with the uere()<- assignment method. Otherwise, when error=TRUE in ctmm, ctmm.fit will estimate the UERE simultaneously with the movement model, which is less reliable than using calibration data.

summary() applied to single UERE object will return UERE parameter estimates and confidence intervals, while summary() applied to a list of UERE objects will return a model-selection table, with AICc and reduced Z squared (goodness of fit) values.

Value

The UERE estimate.

Note

The GPS device should be fixed during calibraiton.

Author(s)

C. H. Fleming

See Also

as.telemetry, residuals.telemetry.

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# Load package and data
library(ctmm)
data(turtle)

# the first two datasets are calibration data
names(turtle)

# estimate UERE from calibration data
UERE <- uere.fit(turtle[1:2])
# inspect UERE estimate
summary(UERE)

# assign UERE to entire dataset
uere(turtle) <- UERE

# calculate residuals of calibration data
RES <- lapply(turtle[1:2],residuals)

# scatter plot of residuals with 50% and 95% quantiles
plot(RES,col.DF=NA,level.UD=c(0.50,0.95))

# check calibration data for autocorrelation using fast=FALSE because samples are small
ACFS <- lapply(RES,function(R){correlogram(R,fast=FALSE,dt=10 %#% 'min')})

# pooling ACFs
ACF <- mean(ACFS)

plot(ACF)

ctmm-initiative/ctmm documentation built on Oct. 12, 2018, 2:55 a.m.