plot.locoh.lxy: Plot LoCoH-xy object

Description Usage Arguments Details See Also

Description

Multi-purpose plotting function for a LoCoH-xy object

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
## 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, ...)

Arguments

x

A LoCoH-xy object

lxy

Deprecated, use x instead

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 lxy will be used (which are rainbow by default).

connect.dots

Whether to draw line segments between consecutive locations. T/F.

overlay

Whether to overlay the plots of all individuals in lxy on one pair of axes (map). T/F.

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: bottomright, bottom, bottomleft, left, topleft, top, topright, right or center

add

Whether to add to an existing plot. T/F.

...

Additional parameters that will be passed to the plot function

Details

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).

See Also

Vignette on T-LoCoH data classes, Tutorial Vignette (for details on displyaing GIS layers and raster images in the background)


tlocoh documentation built on May 2, 2019, 5:27 p.m.