ArchaeoPhases (version 1.8)

TempoPlot: 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.

Value

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

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.

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

# NOT RUN {
  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)

# }