plotScene {mateable}

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.

Value

No return value, called to draw a plot

Author(s)

Amy Waananen

See Also

see plot3DScene to visualize multiple dimensions on one plot

Examples

pop <- simulateScene()
plotScene(pop)