TempoPlot {ArchaeoPhases}

R Documentation

Tempo plot

Description

A statistical graphic designed for the archaeological study of rhythms of the long term that embodies a theory of archaeological evidence for the occurrence of events

Usage

TempoPlot(
  data,
  position,
  plot.result = NULL,
  level = 0.95,
  count = TRUE,
  Gauss = FALSE,
  title = "Tempo plot",
  subtitle = NULL,
  caption = "ArcheoPhases",
  legend.title = "Legend",
  legend.labels = c("Bayes estimate", "Credible interval, low",
    "Credible interval, high", "Gaussian approx., high", "Gaussian approx., low"),
  x.label = "Calendar year",
  y.label = "Cumulative events",
  line.types = c("solid", "12", "11", "28", "28"),
  width = 7,
  height = 7,
  units = "in",
  x.min = NULL,
  x.max = NULL,
  colors = TRUE,
  file = NULL,
  x.scale = "calendar",
  elapsed.origin.position = NULL,
  newWindow = TRUE,
  print.data.result = FALSE
)

Arguments

data	Data frame containing the output of the MCMC algorithm.
position	Numeric vector containing the position of the column corresponding to the MCMC chains of interest.
plot.result	List containing the data to plot, typically the result of a previous run of TempoPlot().
level	Probability corresponding to the level of confidence.
count	If TRUE the counting process is a number, otherwise it is a probability.
Gauss	If TRUE, the Gaussian approximation of the credible interval is used.
title	Title of the plot.
subtitle	Subtitle of the plot.
caption	Caption of the plot.
legend.title	Title of the plot legend.
legend.labels	Vector of strings to label legend entries.
x.label	Label of the x-axis.
y.label	Label of the y-axis.
line.types	Type of the lines drawn on the plot in the order of legend.labels.
width	Width of the plot in units.
height	Height of the plot in units.
units	Units used to specify width and height, one of "in" (default), "cm", or "mm".
x.min	Minimum value for x-axis.
x.max	Maximum value for x-axis.
colors	If TRUE, the plot is drawn with colors, otherwise it is drawn in black and white.
file	Name of the file that will be saved if specified. If NULL no file is saved.
x.scale	One of "calendar", "bp", or "elapsed".
elapsed.origin.position	If x.scale is "elapsed", the position of the column corresponding to the event from which elapsed time is calculated.
newWindow	Whether or not the plot is drawn within a new window.
print.data.result	If TRUE, a list containing the data to plot will be returned.

Details

The tempo plot is one way to measure change over time: it estimates the cumulative occurrence of archaeological events in a Bayesian calibration. The tempo plot yields a graphic where the slope of the plot directly reflects the pace of change: a period of rapid change yields a steep slope and a period of slow change yields a gentle slope. When there is no change, the plot is horizontal. When change is instantaneous, the plot is vertical.

Value

NULL, called for its side effects. It may also return a list containing the data to plot (if print.data.result = TRUE).

Author(s)

Anne Philippe, Anne.Philippe@univ-nantes.fr,

Thomas S. Dye, tsd@tsdye.online, and

Marie-Anne Vibet, Marie-Anne.Vibet@univ-nantes.fr

References

Dye, T.S. (2016) Long-term rhythms in the development of Hawaiian social stratification. Journal of Archaeological Science, 71, 1–9

See Also

tempo_plot

Examples

  data(Events);
  TempoPlot(Events[1:1000, ], c(2:5), print.data.result = FALSE)
  TempoPlot(Events[1:1000, ], c(2:5), count = TRUE,  print.data.result = FALSE)

---