bbmm.polygon: Export Routine for BBMM polygons

Description Usage Arguments Details Value Author(s) References

View source: R/bbmm.polygon.R

Description

bbmm.polygon function that creates the utilization distribution contours based on the bbmm.contour from package BBMM and exports the created contour lines as polygon shapefile for further analysis in ArcMap (or GIS program of choice).

Usage

1
bbmm.polygon(x, crs.current, crs.utm, lev, plot = FALSE, path, indID)

Arguments

x,

a data frame formatted appropriately for use in a brownian.bridge object with the requirement that spatial data columns are labeled as "Lat" and "Lon"

crs.current,

coordinate reference system identifying the current state of the data (e.g., lat/long). Uses standard CRS structure within quotes: CRS("+proj=longlat +zone=14 +datum=NAD83")

crs.utm,

coordinate reference system that transforms the curent state to UTM. Uses standard CRS structure within quotes: CRS("+proj=utm +zone=14 +datum=NAD83")

lev,

level of the UD contour as a vector, c(50, 95) that the user is interested in. Will work with multiple values (e.g., c(50, 95)) and will label those values in the resultant shapefile. Note that you don't have to put these values in as percentages (e.g., 0.50 for 50 percent).

plot,

do you want R to plot the image on screen, default is FALSE.

path,

file path (e.g., "C:/") using standard R path nomenclature specifying the location that the output shapefile is to be written. path uses setwd() currently.

indID,

Unique identifier for each individual, in quotation's, specifying the output files name which will be written to the path designated above. Will additionally add a column to the attribute table with the individuals unique ID.

Details

This is a simple extractor function for a brownian.bridge() that exports the bbmm.contour() results from R package BBMM into a polygon shapefile. Since BBMM requires UTM, the functions transforms the data from the current format (defined by CRS() to UTM internally). The primary requisite is that the column names for the input data frame's longitude and latitude data are labeled "Lon", and "Lat", and the format needs to be appropriate for a BBMM analysis, it will error otherwise.

Value

Output is a polygon shapefile, written to the specified path, with n polygon features equivalent to the utilization distribution levels requested by the user

Author(s)

Bret A. Collier <[email protected]>

References

Horne, J. S., E. O. Garton, S. M. Krone, and J. S. Lewis. 2007. Analyzing animal movements using Brownian bridges. Ecology 88:2354-2363

Sawyer, H., M. J. Kauffman, R. M. Nielson and J. S. Horne. 2009. Identifying and prioritizing ungulate migration routes for landscape-level conservation. Ecological Applications 19: 2016-2025.


bacollier/moveud documentation built on June 4, 2017, 12:12 a.m.