plot.telemetry: Plotting methods for telemetry objects

View source: R/plot.telemetry.R

plot.telemetryR Documentation

Plotting methods for telemetry objects

Description

Produces simple plots of telemetry objects, possibly overlayed with a Gaussian ctmm movement model or a UD utilization distribution.

Usage

plot(x,y,...)

## S3 method for class 'telemetry'
plot(x,CTMM=NULL,UD=NULL,col.bg="white",cex=NULL,col="red",lwd=1,pch=1,type='p',
     error=TRUE,transparency.error=0.25,velocity=FALSE,DF="CDF",col.DF="blue",
     col.grid="white",labels=NULL,convex=FALSE,level=0.95,level.UD=0.95,col.level="black",
     lwd.level=1,SP=NULL,border.SP=TRUE,col.SP=NA,R=NULL,col.R="green",legend=FALSE,
     fraction=1,xlim=NULL,ylim=NULL,ext=NULL,units=TRUE,add=FALSE,...)

## S4 method for signature 'list'
zoom(x,...)

## S4 method for signature 'telemetry'
zoom(x,fraction=1,...)

## S4 method for signature 'UD'
zoom(x,fraction=1,...)

Arguments

x

telemetry or UD object.

y

Unused option.

CTMM

Optional Gaussian ctmm movement model from the output of ctmm.fit or list of such objects.

UD

Optional UD object such as from the output of akde or list of such objects.

col.bg

Background color

cex

Relative size of plotting symbols. Only used when error=FALSE, because error=TRUE uses the location-error radius instead of cex.

col

Color option for telemetry data. Can be an array or list of arrays.

lwd

Line widths of telemetry points.

pch

Plotting symbol. Can be an array or list of arrays.

type

How plot points are connected. Can be an array.

error

Plot error circles/ellipses if present in the data. error=2 will fill in the circles and error=3 will plot densities instead. error=FALSE will disable this feature.

transparency.error

Transparency scaling for erroneous locations when error=1:2. trans=0 disables transparancy. Should be no greater than 1.

velocity

Plot velocity vectors if present in the data.

DF

Plot the maximum likelihood probability density function "PDF" or cumulative distribution function "CDF".

col.DF

Color option for the density function. Can be an array.

col.grid

Color option for the maximum likelihood akde bandwidth grid. col.grid=NA will disable the plotting of the bandwidth grid.

labels

Labels for UD contours. Can be an array or list of arrays.

convex

Plot convex coverage-area contours if TRUE. By default, the highest density region (HDR) contours are plotted.

level

Confidence levels placed on the contour estimates themselves. I.e., the above 50% core home-range area can be estimated with 95% confidence via level=0.95. level=NA will disable the plotting of confidence intervals.

level.UD

Coverage level of Gaussian ctmm model or UD estimate contours to be displayed. I.e., level.UD=0.50 can yield the 50% core home range within the rendered contours.

col.level

Color option for home-range contours. Can be an array.

lwd.level

Line widths of UD contours.

SP

SpatialPolygonsDataFrame object for plotting a shapefile base layer.

border.SP

Color option for shapefile polygon boundaries.

col.SP

Color option for shapefile polygon regions.

R

Background raster, such as habitat suitability.

col.R

Color option for background raster.

legend

Plot a color legend for background raster.

fraction

Quantile fraction of the data, Gaussian ctmm, or UD range to plot, whichever is larger.

xlim

The x limits c(x1, x2) of the plot (in SI units).

ylim

The y limits c(y1, y2) of the plot (in SI units).

ext

Plot extent alternative to xlim and ylim (see extent).

units

Convert axes to natural units.

add

Setting to TRUE will disable the unit conversions and base layer plot, so that plot.telemetry can be overlayed atop other outputs more easily.

...

Additional options passed to plot.

Details

Confidence intervals placed on the ctmm Gaussian home-range contour estimates only represent uncertainty in the area's magnitude and not uncertainty in the mean location, eccentricity, or orientation angle. For akde UD estimates, the provided contours also only represent uncertainty in the magnitude of the area. With akde estimates, it is also important to note the scale of the bandwidth and, by default, grid cells are plotted with akde contours such that their length and width matches that of a bandwidth kernels' standard deviation in each direction. Therefore, this grid provides a visual approximation of the kernel-density estimate's “resolution”. Grid lines can be disabled with the argument col.grid=NA.

Value

Returns a plot of x vs. y, and, if specified, Gaussian ctmm distribution or UD. akde UD plots also come with a standard resolution grid. zoom includes a zoom slider to manipulate fraction.

Note

If xlim or ylim are provided, then the smaller or absent range will be expanded to ensure asp=1.

Author(s)

C. H. Fleming.

See Also

akde, ctmm.fit, plot, SpatialPoints.telemetry.

Examples

# Load package and data
library(ctmm)
data(buffalo)

# Plot the data
plot(buffalo,col=rainbow(length(buffalo)))

ctmm documentation built on Sept. 24, 2023, 1:06 a.m.