mateable (version 0.3.1)

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, main = NULL, text.cex = 0.7, pt.cex = 0.7)

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.

main

character, the main plot title, if NULL, defaults to 'individual potential' or 'pairwise potential,' corresponding to subject

text.cex

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

pt.cex

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

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 randonly 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. If fewer than three individuals from the subset are available in a year, no network diagram or heatmap will be returned for that year.

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