plotScene: graphical visualization of a mating scene object
In mateable: Assess Mating Potential in Space and Time

plotScene

R Documentation

graphical visualization of a mating scene object

Description

Visualize a mating scene

Usage

plotScene(
  scene,
  dimension = "auto",
  dailyPoints = TRUE,
  drawQuartiles = TRUE,
  sortBy = c("start", "end"),
  colorBy = NULL,
  sub = NULL,
  N = 3,
  label.sub = TRUE,
  xlab.spat = NULL,
  ylab.spat = NULL,
  pch = 19,
  pt.cex = 0.75,
  label.cex = 0.8,
  plot.lim.zoom = FALSE,
  quartile.lwd = 1,
  quartile.col = "gray55",
  peak.col = "gray27",
  labelID = FALSE,
  mt1 = "F",
  mt2 = "M",
  leg.ncol = 1,
  ...
)

Arguments

`scene`	a matingScene object
`dimension`	what dimension(s) of the mating scene should be visualized. Possible dimensions are 't' for temporal, 's' for spatial, 'mt' for mating type, and 'auto' (the default). For dimension = 'auto', all dimensions represented in the mating scene object will be plotted.
`dailyPoints`	logical indicating whether daily counts of individuals should be displayed for plots of the temporal dimension
`drawQuartiles`	logical indicating whether vertical lines should be drawn at population peak (see details) or quartiles
`sortBy`	character indicating which columns to sort segments of flowering schedule by. Defaults to 'start', then 'end'. Up to three variables may be specified.
`colorBy`	character optional, the name of a variable to use to assign color to segments or points.
`sub`	a vector containing the ids of individuals to be highlighted in the plots or a character string specifying how to choose individuals to highlight. Possible values are "random" or "all". If NULL, no subset will be identified in the plots.
`N`	a positive number, the number of individuals to sample if `sub` = 'random'
`label.sub`	logical, indicating whether specified subset should be labeled
`xlab.spat`	character label for x-axis of spatial dimension plots. If NULL, defaults to 'easting'.
`ylab.spat`	character label for y-axis of spatial dimension plots. If NULL, defaults to 'northing'.
`pch`	specify point type to be used in plots. Defaults to pch = 19 (filled-in circle). If NULL, points will be labeled with their id.
`pt.cex`	specify point expansion factor (point size relative to device default)
`label.cex`	specify text expansion factor (text size relative to device default)
`plot.lim.zoom`	if TRUE, spatial plot limits for lists of scenes are set by the maximum from all scenes
`quartile.lwd`	if `drawQuartiles` = TRUE, specifies weight of quartile and peak lines relative to device default.
`quartile.col`	if `drawQuartiles` = TRUE, specifies color of quartile lines, defaults to 'gray81'.
`peak.col`	if `drawQuartiles` = TRUE, specify color of peak lines, defaults to 'gray27'.
`labelID`	if TRUE, the y-axis will be labeled with the id of the corresponding segment.
`mt1`	label for mating type '1', if dioecious
`mt2`	label for mating type '2', if dioecious
`leg.ncol`	number of columns to include in legend, if colorBy is not NULL
`...`	standard graphical parameters

Details

Population peak is defined by when maximum number individuals were reproductively receptive on one day. If multiple days had the same maximum number, peak is defined as the median of these dates.