mateable (version 0.3.2)

plot3DPotential: graphical visualization of multiple mating potential objects

Description

Visualize multiple dimensions of mating potential

Usage

plot3DPotential(
  matPots,
  subject = NULL,
  density = TRUE,
  sub.ids = NULL,
  N = 3,
  sample = NA,
  text.cex = 0.7,
  pt.cex = 0.7
)

Value

No return value, called to draw a plot

Arguments

matPots

list, contains one or multiple mating potential objects representing unique potential dimensions

subject

character, indicates whether the subject to be visualized is individuals (subject = 'ind') or all pairwise interactions (subject = 'pair')

density

logical, if TRUE (default), plots probability density over histogram

sub.ids

vector, contains the IDs of individuals to be represented in pairwise potential plots

N

integer, indicates the number of individuals to sample if sub.ids = 'random' (default N = 3)

sample

character, specifies how to sample individuals to be represented in pairwise potential plots. Possible values are "random" (default) or "all". See details.

text.cex

specify text expansion factor (text size relative to device default)

pt.cex

specify point expansion factor (point size relative to device default)

Author

Amy Waananen

Details

The individuals to be represented in the pairwise potential plots can either be specified explicitly through sub.ids, chosen randomly (sample = 'random'), or all individuals can be selected (sample = 'all'). The default is to randomly select 9 individuals. If multiple years are being plotted, the subset is sampled from all years and the same individuals will be represented in each year, if possible.

See Also

see generic function points for values of pch

Examples

pop <- simulateScene()
sync <- synchrony(pop, "augs")
prox <- proximity(pop, 'maxProp')
compat <- compatibility(pop, 'si_echinacea')
plot3DPotential(list(sync,prox,compat), subject = 'ind')