plot.locoh.lxy {tlocoh} | R Documentation |
Multi-purpose plotting function for a LoCoH-xy object
## S3 method for class 'locoh.lxy' plot(x, lxy, id = NULL, cex = 0.8, show.start = TRUE, show.end = TRUE, col = c("auto", "gray80")[1], connect.dots = TRUE, overlay = FALSE, status = TRUE, title = NULL, title.show = TRUE, axes.show = TRUE, axes.titles = axes.show, axes.ticks = axes.show, mar = c(if (axes.titles || axes.ticks) 3.3 else 0.5, if (axes.titles || axes.ticks) 3.2 else 0.5, if (title.show) 3.2 else 0.5, 0.5), mgp = c(2, 0.7, 0), lo.save = TRUE, panel.num = NULL, panel.num.inside.plot = !title.show, png.fn = NULL, png.dir = NULL, png.dir.make = TRUE, png.width = 800, png.height = png.width, png.overwrite = TRUE, png.pointsize = 12 + (png.width - 480)/80, tiff.fn = NULL, tiff.bands = c(3, 2, 1), tiff.col = gray(0:255/255), tiff.pct = FALSE, tiff.buff = 0, tiff.fill.plot = TRUE, layers = NULL, shp.csv = NULL, xlim = NULL, ylim = NULL, legend = NULL, add = FALSE, ...)
x |
A LoCoH-xy object |
lxy |
Deprecated, use |
id |
A vector of the id value(s) to plot |
cex |
Character expansion factor for the points |
show.start |
Whether to highlight the starting location (if time stamps are present) in green. T/F. |
show.end |
Whether to highlight the end location (if time stamps are present) in red. T/F. |
col |
A single value or vector of color values. Can also be 'auto' in which case the colors saved in |
connect.dots |
Whether to draw line segments between consecutive locations. T/F. |
overlay |
Whether to overlay the plots of all individuals in |
status |
Display status messages. T/F. |
title |
The title to be displayed. Character. If NULL a title will be constructed. |
title.show |
Whether to show the title. T/F. |
axes.show |
Whether to show the axes. T/F. |
axes.titles |
Whether to show axes titles. T/F. |
axes.ticks |
Whether to show the tick marks and labels on the axes. T/F. |
mar |
The plot margins. A four item numeric vector |
mgp |
The distance away from the edge of the plot for the 1) label, 2) tick marks, and 3) axis line. A three-item numeric vector |
lo.save |
Whether to save and reset the plot device margin settings (some wrapper functions that call this function don't want device settings reset). T/F. |
panel.num |
A number or letter to display in the upper left hand corner of the plot when the plot will be used as part of a multi-frame graphic (as in publications). Character |
panel.num.inside.plot |
Whether to display panel.num inside the plot area itself, as opposed to the title area. T/F |
png.fn |
The path and name of the PNG file to create (instead of displaying in a plot window) |
png.dir |
The directory for a PNG file (filename will be constructed automatically). Ignored if png.fn is passed |
png.dir.make |
Whether to create png.dir if it doesn't exist. T/F |
png.width |
The width of the PNG image |
png.height |
The height of the PNG image |
png.overwrite |
Whether to overwrite an existing PNG file if it exists. T/F |
png.pointsize |
The pointsize (in pixels) for the PNG image, equivalent to the height or width of a character in pixels (increase to make labels appear larger) |
tiff.fn |
The path and name of a GeoTIFF file (e.g., satellite image) that will be displayed in the background. See notes. |
tiff.bands |
A vector of threee integers corresponding to the bands of the GeoTIFF image that will be mapped to the red, green and blue color guns respectively. |
tiff.col |
A vector of color values for plotting single-band images in the background. Ignored if using three bands. |
tiff.pct |
Whether or to convert the GeoTIFF to an indexed 256 color RGB image, which may speed up drawing. T/F. |
tiff.buff |
A numeric buffer distance in map units that the range of the plot will be expanded so the points are not right on the edge of the GeoTIFF. |
tiff.fill.plot |
Whether to fill the entire plot area with the GeoTIFF. T/F. |
layers |
The name(s) of layers in shp.csv to display in the background. Will be displayed using the symbology in shp.csv. Character vector or comma delimited string |
shp.csv |
The path and filename of a csv file that contains information about shapefiles, including layer names, file, and symbology. |
xlim |
The lower and upper limit of the x-axis, two-element numeric vector |
ylim |
The lower and upper limit of the y-axis, two-element numeric vector |
legend |
One of the following keywords specifying where to put a legend when overlaying the locations of multiple individuals: |
add |
Whether to add to an existing plot. T/F. |
... |
Additional parameters that will be passed to the |
This is a multi-purpose plotting function for a LoCoH-xy object, with several custom arguments useful for plotting
a movement trajectory. You may also extract the SpatialPointsDataFrame element of the LoCoH-xy object directly by referencing
the pts
element (e.g., x$pts
, where x
is a LoCoH-xy object).
Vignette on T-LoCoH data classes, Tutorial Vignette (for details on displyaing GIS layers and raster images in the background)