adehabitatHR (version 0.4.14)

getverticeshr: Extract the home-range contour of one or several animals

Description

These functions allow the extraction of the home-range contours computed using various methods (kernel home range, cluster home range, etc.)

Usage

getverticeshr(x, percent = 95, …)
# S3 method for estUD
getverticeshr(x, percent = 95, ida = NULL, unin = c("m", "km"),
                              unout = c("ha", "km2", "m2"),
                              standardize = FALSE, …)
# S3 method for estUDm
getverticeshr(x, percent = 95, whi = names(x),
                               unin = c("m", "km"),
                               unout = c("ha", "km2", "m2"),
                               standardize = FALSE, …)
# S3 method for MCHu
getverticeshr(x, percent = 95, whi = names(x), …)
# S3 method for default
getverticeshr(x, percent = 95, …)

Arguments

x

For getverticeshr.estUD, an object of class estUD. For getverticeshr.estUDm, an object of class estUDm. For getverticeshr.MCHu, an object of class MCHu.

percent

a single value giving the percentage level for home-range estimation

ida

a character string indicating the id of the polygons corresponding to the home range in the resulting SpatialPolygonsDataFrame (see the help page of SpatialPolygonsDataFrame). By default it is set to "homerange"

unin

the units of the relocations coordinates. Either "m" for meters (default) or "km" for kilometers

unout

the units of the output areas. Either "m2" for square meters, "km2" for square kilometers or "ha" for hectares (default)

whi

a vector of character strings indicating which animals should be returned.

standardize

a logical value indicating whether the UD should be standardized over the area of interest, so that the volume under the UD and *over the area* is equal to 1..

…

Additional arguments to be passed to and from other methods

Value

An object of class SpatialPolygonsDataFrame containing the selected home range contours of the animals.

See Also

kernelUD, kernelbb or kernelkc for methods generating objects of classes estUD and estUDm, clusthr, LoCoH.a and CharHull for methods generating objects of class MCHu.

Examples

# NOT RUN {
### Example with a kernel home range
data(puechabonsp)
loc <- puechabonsp$relocs
     
## have a look at the data
head(as.data.frame(loc))
## the first column of this data frame is the ID
     
## Estimation of UD for the four animals
(ud <- kernelUD(loc[,1]))

## Calculates the home range contour

ver <- getverticeshr(ud, percent=95)
ver
plot(ver)

## Example with a cluster home range
clu <- clusthr(loc[,1])
ver2 <- getverticeshr(clu, percent=95)
ver2
plot(ver2)

# }