plot_diceleraas: Dice-Leraas Diagram

In tabula: Analysis and Visualization of Archaeological Count Data

Dice-Leraas Diagram

Description

Plots a Dice-Leraas diagram.

Usage

plot_diceleraas(object, ...)

## S4 method for signature 'matrix'
plot_diceleraas(
  object,
  main = NULL,
  sub = NULL,
  ann = graphics::par("ann"),
  axes = TRUE,
  frame.plot = FALSE,
  panel.first = NULL,
  panel.last = NULL,
  ...
)

## S4 method for signature 'data.frame'
plot_diceleraas(
  object,
  main = NULL,
  sub = NULL,
  ann = graphics::par("ann"),
  axes = TRUE,
  frame.plot = FALSE,
  panel.first = NULL,
  panel.last = NULL,
  ...
)

Arguments

object	A m \times p numeric matrix or data.frame of count data (absolute frequencies giving the number of individuals for each category, i.e. a contingency table). A data.frame will be coerced to a numeric matrix via data.matrix().
...	Further graphical parameters.
main	A character string giving a main title for the plot.
sub	A character string giving a subtitle for the plot.
ann	A logical scalar: should the default annotation (title and x, y and z axis labels) appear on the plot?
axes	A logical scalar: should axes be drawn on the plot?
frame.plot	A logical scalar: should a box be drawn around the plot?
panel.first	An an expression to be evaluated after the plot axes are set up but before any plotting takes place. This can be useful for drawing background grids.
panel.last	An expression to be evaluated after plotting has taken place but before the axes, title and box are added.

Details

In a Dice-Leraas diagram, the horizontal line represents the range of data (min-max) and the small vertical line indicates the mean. The black rectangle is twice the standard error on the mean, while the white rectangle is one standard deviation on either side of the mean.

Value

plot_diceleraas() is called it for its side-effects: it results in a graphic being displayed (invisibly returns object).

Author(s)

N. Frerebeau

References

Dice, L. R., & Leraas, H. J. (1936). A Graphic Method for Comparing Several Sets of Measurements. Contributions from the Laboratory of Vertebrate Genetics, 3: 1-3.

Hubbs, C. L., & C. Hubbs (1953). An Improved Graphical Analysis and Comparison of Series of Samples. Systematic Biology, 2(2): 49-56. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.2307/sysbio/2.2.49")}.

Simpson, G. G., Roe, A., & Lewontin, R. C. Quantitative Zoology. New York: Harcourt, Brace and Company, 1960.

See Also

Other plot methods: matrigraph(), plot_bertin(), plot_diversity, plot_ford(), plot_heatmap(), plot_rank(), plot_rarefaction, plot_spot(), seriograph()

Examples

## Data from Desachy 2004
data("compiegne", package = "folio")

## Plot a Dice-Leraas diagram
plot_diceleraas(compiegne)

tabula documentation built on Aug. 22, 2023, 5:11 p.m.