Creates an isotope biplot and provides a wrapper to ellipse and hull plotting

Description

This function takes a SIBER object as created by createSiberObject, and loops over communities and their groups, creating a biplot, and adding ellipses and hulls as desired. Ellipses can be added to groups, while convex hulls can be added at both the group and community level (the former for illustrative purposes only, with no analytical tools in SIBER to fit Bayesian hulls to individual groups. This is not mathematically possible in a Bayesian framework.).

Usage

1
2
3
4
5
plotSiberObject(siber, iso.order = c(1, 2), ax.pad = 1, hulls = TRUE,
  community.hulls.args = NULL, ellipses = TRUE,
  group.ellipses.args = NULL, group.hulls = FALSE,
  group.hulls.args = NULL, bty = "L", xlab = "Isotope 1",
  ylab = "Isotope 2", las = 1, x.limits = NULL, y.limits = NULL, ...)

Arguments

siber

a siber object as created by createSiberObject.

iso.order

a vector of length 2, either c(1,2) or c(2,1). The order determines which of the columns of raw data are plotted on the x (1) or y (2) axis. N.B. this will be deprecated in a future release, and plotting order will be acheived at point of data-entry.

ax.pad

a padding amount to apply to the x-axis either side of the extremes of the data. Defaults to 1.

hulls

a logical defaulting to TRUE determining whether or not hulls based on the means of groups within communities should be drawn. That is, a community-level convex hull.

community.hulls.args

a list of plotting arguments to pass to plotCommunityHulls. See plotCommunityHulls for further details.

ellipses

a logical defaulting to TRUE determining whether or not an ellipse should be drawn around each group within each community.

group.ellipses.args

a list of plotting arguments to pass to plotGroupEllipses. See plotGroupEllipses for further details.

group.hulls

a logical defaulting to FALSE determining whether or not convex hulls should be drawn around each group within each community.

group.hulls.args

a list of plotting options to pass to plotGroupHulls. See plotGroupHulls for further details.

bty

a string specifying the box type for the plot. See par for details.

xlab

a string for the x-axis label.

ylab

a string for the y-axis label.

las

a scalar determining the rotation of the y-axis labels. Defaults to horizontal with las = 1. See par for more details.

x.limits

allows you to specify a two-element vector of lower and upper x-axis limits. Speficying this argument over-rides the automatic plotting and ax.pad option. Defaults to NULL.

y.limits

allows you to specify a two-element vector of lower and upper y-axis limits. Speficying this argument over-rides the automatic plotting and ax.pad option. Defaults to NULL.

...

additional arguments to be passed to plot.

Value

An isotope biplot.

Want to suggest features or report bugs for rdrr.io? Use the GitHub issue tracker.