Produces simple plots of telemetry
objects, possibly overlayed with a Gaussian ctmm
movement model or a UD
utilization distribution.
plot(x,y,...)# S3 method for telemetry
plot(x,CTMM=NULL,UD=NULL,level.UD=0.95,level=0.95,DF="CDF",error=TRUE,velocity=FALSE,
units=TRUE,col="red",col.level="black",col.DF="blue",col.grid="white",
transparency.error=0.25,pch=1,type='p',labels=NULL,fraction=1,add=FALSE,xlim=NULL,
ylim=NULL,cex=NULL,lwd=1,lwd.level=1,...)
# S4 method for list
zoom(x,...)
# S4 method for telemetry
zoom(x,fraction=1,...)
# S4 method for UD
zoom(x,fraction=1,...)
telemetry
or UD
object.
Unused option.
Optional Gaussian ctmm
movement model from the output of ctmm.fit
or list of such objects.
Optional UD
object such as from the output of akde
or list of such objects.
Confidence 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.
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
.
Plot the maximum likelihood probability density function "PDF"
or cumulative distribution function "CDF"
.
Plot error circles/ellipses if present in the data. error=2
will fill in the circles and error=3
will plot densities instead.
Plot velocity vectors if present in the data.
Convert axes to natural units.
Color option for telemetry data. Can be an array or list of arrays.
Color option for home-range contours. Can be an array.
Color option for the density function. Can be an array.
Color option for the maximum likelihood akde
bandwidth grid.
Transparency scaling for erroneous locations when error=1:2
. trans=0
disables transparancy. Should be no greater than 1
.
Plotting symbol. Can be an array or list of arrays.
How plot points are connected. Can be an array.
Labels for UD contours. Can be an array or list of arrays.
Quantile fraction of the data, Gaussian ctmm
, or UD
range to plot, whichever is larger.
Setting to TRUE
will disable the unit conversions and base layer plot, so that plot.telemetry
can be overlayed atop other outputs more easily.
The x
limits c(x1, x2)
of the plot (in SI units).
The y
limits c(y1, y2)
of the plot (in SI units).
Relative size of plotting symbols. Only used when errors are missing.
Line widths of telemetry
points.
Line widths of UD
contours.
Additional options passed to plot
.
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
.
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''.
# NOT RUN {
# Load package and data
library(ctmm)
data(buffalo)
# Plot the data
plot(buffalo,col=rainbow(length(buffalo)))
# }
Run the code above in your browser using DataLab