MultiSuccessionPlot {ArchaeoPhases}

R Documentation

Successive Phases Density Plots (for phases in temporal order constraint)

Description

This functions draws a plot of the densities of several successive phases and adds several statistics (mean, CI, HPDR). The result is given in calendar years (BC/AD).

Usage

MultiSuccessionPlot(
  data,
  position_minimum,
  position_maximum = position_minimum + 1,
  level = 0.95,
  title = "Characterisation of a succession of groups",
  colors = NULL,
  exportFile = NULL,
  exportFormat = "PNG"
)

Arguments

data	Data frame containing the output of the MCMC algorithm.
position_minimum	Numeric vector containing the column number corresponding to the minimum of the events included in each group.
position_maximum	Numeric vector containing the column number corresponding to the end of the groups set in the same order as in position_minimum.
level	Probability corresponding to the level of confidence.
title	Title of the plot.
colors	Vector of colors corresponding to each group of dates.
exportFile	Name of the file to be saved. If NULL then no plot is saved.
exportFormat	Format of the export file, either "PNG" or "SVG" (default).

Details

Curves represent the density of the minimum (oldest dates) and the maximum (youngest dates) of the dates included in each group. Curves of the same color refer to the same phase. When there is only one curve of one color, it means that there is only one event in the corresponding group and then the minimum equals the maximum. Time range intervals are symbolised by segments above the curves drawn using the same color as the one of the curves of the associated group. Transition and gap range intervals are represented by two-coloured segments using the colors of successive phases. If the gap between the successive groups does not exist, a cross is drawn instead of a segment.

Value

NULL, called for its side effects

Author(s)

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

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

Examples

  # Data extracted from ChronoModel software
  data(Phases)
  # List of the name of the groups
  names(Phases)
  # Stipulating position_end
  MultiSuccessionPlot(Phases, c(4, 2), c(5, 3),
                      title = "Succession of phase 1 and phase 2")
  # In this case, equivalent to
  MultiSuccessionPlot(Phases, c(4, 2),
                      title = "Succession of phase 1 and phase 2",
                      colors = c(3, 4))

---