Learn R Programming

ctmm (version 0.5.5)

summary.UD: Summarize a range distribution

Description

This function returns a list of biologically interesting parameters in human readable format, as derived from an autocorrelated kernel density estimate.

Usage

# S3 method for UD
summary(object,level=0.95,level.UD=0.95,units=TRUE,...)

Arguments

object

An akde autocorrelated kernel-density estimate from the output of akde.

level

Confidence level for the above area estimate. E.g., the 95% confidence interval of the 50% core area.

level.UD

Coverage level for the home-range area. E.g., the 50% core area.

units

Convert result to natural units.

...

Unused options.

Value

A matrix with low, maximum likelihood, and high estimates for the following parameters:

area

The home-range area with fraction of inclusion level.UD. E.g., the 50% core home range is estimated with level.UD=0.50, and 95% confidence intervals are placed on that area estimate with level=0.95.

This kernel density estimate differs from the Gaussian estimate of summary.ctmm. The Gaussian estimate has more statistical efficiency, but is less related to space use for non-Gaussian processes.

References

C. H. Fleming, J. M. Calabrese. A new kernel-density estimator for accurate home-range and species-range area estimation. Methods in Ecology and Evolution, 8:5, 571-579 (2016).

See Also

akde.

Examples

Run this code
# NOT RUN {
# Load package and data
library(ctmm)
data(buffalo)

# Extract movement data for a single animal
Cilla <- buffalo$Cilla

# Fit a movement model
GUESS <- ctmm.guess(Cilla,interactive=FALSE)
FIT <- ctmm.fit(Cilla,GUESS)

# Estimate and summarize the AKDE
UD <- akde(Cilla,FIT)
summary(UD)
# }

Run the code above in your browser using DataLab