This function plots the overlap of traits among species for each community in multivariate space, showing projections of trait hypervolumes into two-dimensional space for all pairs of traits.

Ostats_multivariate_plot(
  plots,
  sp,
  traits,
  overlap_dat = NULL,
  use_plots = NULL,
  colorvalues = NULL,
  plot_points = TRUE,
  contour_level,
  axis_expansion = 0.01,
  contour_buffer_factor = 0.25,
  panel_height = 3,
  panel_width = 3,
  units = "cm",
  hypervolume_args = list()
)

Arguments

plots

Site identity: a vector of names of each community.

sp

Taxon identity: a vector of species or taxa names.

traits

A matrix or data frame with rows representing individuals and columns representing traits.

overlap_dat

Optional: an object containing the output of Ostats_multivariate. If provided, overlap statistics will be displayed in the plot panels.

use_plots

a vector of sites to plot. If NULL, the function will plot all the sites.

colorvalues

Vector of color values for the density polygons. Defaults to a viridis palette if none provided.

plot_points

whether to plot individual data points in addition to the hypervolume slices. Default is TRUE.

contour_level

level at which to plot contour lines. If not provided by the user, a message is issued stating the default plotting level is 0.01.

axis_expansion

multiplicative expansion factor by which to expand the x and y axes around the hypervolume contours before plotting. Default is 0.01.

contour_buffer_factor

multiplicative expansion factor by which to expand the x and y axes in all directions, relative to the range of the axis, before calculating the hypervolume contours for plotting. If this is not set to a sufficiently large value, the contour lines of the hypervolumes will be cut off. Default value is 0.25 (25% expansion of the axis limits in all directions).

panel_height

height of the individual plot panels, in units given by units. Default is 3 cm.

panel_width

height of the individual plot panels, in units given by units. Default is 3 cm.

units

units for panel height and width. Default is centimeters.

hypervolume_args

additional arguments to pass to hypervolume, such as method. If none are provided, default values are used.

Value

Two-dimensional projections of species trait hypervolumes for each pair of traits, plotted together for each community to show how they overlap each other. The overlap value obtained as output from Ostats_multivariate

is labelled on each community graph, if provided by the user.

The class of the returned object is Ostats_plot_object. Calling

print on this object will invoke a method to draw the plot using

grid.draw.

If more than one community is provided, a list of objects of class

Ostats_plot_object will be returned.

Details

Some of the code for generating contour lines is modified from plot.HypervolumeList.

See also

Ostats_multivariate for generating multivariate O-statistics