NNCH.select: LoCoH (NNCH): Useful Functions

Description

NNCH.select is to be used when a home range has been analyzed for multiple k's, r's, a's, and/or id's. This function will select a subset based on user defined conditions of the the original home range and return a new home range object containing the subset. Most NNCH functions will accept NNCH.select parameters and call the function before analyzing data. summary.NNCH prints out a lengthy data summary containing rudimentary analysis of the data. Can be saved to a text file. plot.NNCH generates a plot of the home range. NNCH.asciigrid creates a raster map of the home range which can be exported for use by ArcMap and other GIS programs. NNCH.shapefile creates a representation of the home range as a polygon shapefile object (can be saved to a shape file thanks to the package shapefile).

Usage

NNCH.select(x,id = NULL, k = NULL, r = NULL, a = NULL)
## S3 method for class 'NNCH':
print(x, \dots)
## S3 method for class 'NNCH':
summary(object,file='', id = NULL, k = NULL, r = NULL,
             a = NULL, \dots)
## S3 method for class 'NNCH':
plot(x, add.points = TRUE, pch = 21, bgpts = "white",
          colpts = "black", cex = 0.7, add = FALSE,
          same4all = TRUE, border = NA, percent = rev(seq(10,100, by=10)),
          gr = rev(grey(vectorize.parameter(percent)/100*.9)),
          id = NULL, k = NULL, r = NULL, a = NULL, ...)
NNCH.asciigrid(x, asc = NULL, cellsize = 1,
               percent = rev(seq(10,100, by = 10)),
               id = NULL, k = NULL, r = NULL, a = NULL)
NNCH.shapefile(x, percent= rev(seq(10,100, by = 10)),
               k = NULL, id = NULL, r = NULL, a = NULL)

Arguments

x,object

a home range object of class NNCH generated using the method NNCH

character string specifying a subset of x

k,r,a

numeric values specifying a subset of x

file

a character string specifying the name of a textfile the summary of the homerange is to be saved. If not specified, summary is printed to the screen

add.points

logical. TRUE if the relocations are to be plotted

pch

if add.points is TRUE, the size of the points to be used for the plot of the relocations (see par)

bgpts

if add.points is TRUE, the background color to be used for the plot of the relocations (see par)

colpts

if add.points is TRUE, the color of the points to be used for the plot of the relocations (see par)

cex

if add.points is TRUE, the size of the points to be used for the plot of the relocations (see par)

add

logical. Whether the home ranges should be displayed on a previous plot

same4all

logical. If TRUE, the plot displaying the home ranges has the same X and Y limits for all animals

border

The color of the border of the polygons. NA if a border is not required

percent

A vector of the isopleths to use when plotting or saving the homerange.

A vector of colors the same length as the vector of isopleths. Used to color the isopleths on the plot.

asc

an object of class asc

cellsize

the size of the pixel of the raster map.

...

additional arguments to be passed to the generic functions plot, print and summary.

Value

NNCH.select returns an object of class NNCH containing a subset of the original data. NNCH.asciigrid returns an object of class asc. NNCH.shapefile returns an object of class shapefile.

Warning

The function NNCH.shapefile relies on the package shapefile.

Examples

Run this code

data(chamois)
xy <- chamois$locs

(nn <- NNCH(xy, k=c(6,7)))
summary(nn)
NNCH.select(nn, k=7)

## Graphical exploration
plot(nn, k=7)

## rasterization:
asc <- ascgen(chamois$locs,nrcol=100)
asc <- NNCH.asciigrid(nn, k=7, asc=asc)  
image(asc)

if (require(shapefiles)) {
  (nns <- NNCH.shapefile(nn))
  }